# Polyglot Codebase Knowledge Graph
> Generated offline by **readmenator**. 11 files, 194 symbols, 65 imports. Supports C, C++, Python, Go, Rust, JS/TS, Java, C#, Shell, PHP, Dart, GDScript, Nim, ASM, Ruby, Swift, Kotlin, Scala, Lua, Elixir.
> No LLMs. No tokens. Pure static analysis. See more [here](https://github.com/grisuno/ReadMenator)
**Start here:** Statistics Dashboard for scope, God Nodes for blast radius, Architecture Reference for per-file API. Agents: prefer `readmenator-agent/INDEX.md` + `SYMBOLS.md`.
**Wiki:** prefer `readmenator-wiki/index.md` for progressive disclosure: one synthesis page per community, `connections.json` with EXTRACTED vs INFERRED confidence, `queries.md` log, `REPORT.md` audit.
**Confidence:** EXTRACTED = parsed from source, INFERRED = heuristic bridge, AMBIGUOUS = reported, never hidden. See `readmenator-wiki/REPORT.md`.
**Total Files Parsed:** 11 | **Total Symbols Extracted:** 194 | **Total Imports:** 65
| **Resolved Imports:** 9
## Table of Contents
1. [Statistics Dashboard](#statistics-dashboard)
2. [Architectural Layers](#architectural-layers)
3. [Architecture Overview](#architecture-overview)
4. [Execution Flows](#execution-flows)
5. [Ranked Context](#ranked-context)
6. [God Nodes](#god-nodes)
7. [Community Analysis](#community-analysis)
8. [Suggested Questions](#suggested-questions)
9. [Force-Graph Explorer](#force-graph-explorer)
10. [Corpus Analytics](#corpus-analytics)
11. [Taint Propagation Map](#taint-propagation-map)
12. [Hotspot Analysis](#hotspot-analysis)
13. [Change Impact Analysis](#change-impact-analysis)
14. [Architecture Violations](#architecture-violations)
15. [Suggested Linting Rules](#suggested-linting-rules)
16. [Concept Graph](#concept-graph)
17. [Query Recipes](#query-recipes)
18. [Structural Knowledge Map](#structural-knowledge-map)
19. [UML Class Diagram](#uml-class-diagram)
20. [Code Property Graph](#code-property-graph)
21. [Architecture Reference](#architecture-reference)
- [PY (10 files)](#py-10-files)
- [SH (1 files)](#sh-1-files)
---
## Statistics Dashboard
| Metric | Value |
|--------|-------|
| Total Files | 11 |
| Total Symbols | 194 |
| Total Imports | 65 |
| Call Edges | 1128 |
| Inheritance Edges | 4 |
| Languages | 2 |
| Avg Symbols/File | 17.6 |
| Avg Imports/File | 5.9 |
| Resolved Imports | 9 |
### Top Files by Import Count (Fan-Out)
| File | Imports | Symbols | Language |
|------|---------|---------|----------|
| `lazyown_infinitestorage.py` | 20 | 84 | py |
| `tools.py` | 11 | 11 | py |
| `test_integration.py` | 9 | 16 | py |
| `mcp_server.py` | 8 | 13 | py |
| `test_zip.py` | 5 | 16 | py |
| `test_frames.py` | 3 | 13 | py |
| `test_security.py` | 3 | 18 | py |
| `test_error_correction.py` | 2 | 10 | py |
| `test_protocols.py` | 2 | 12 | py |
| `wsgi_app.py` | 2 | 1 | py |
---
## Architectural Layers
Auto-detected from path patterns, naming conventions, and imported frameworks.
| Layer | Files |
|-------|-------|
| testing | 6 |
| utility | 4 |
| presentation | 1 |
### utility
- `install.sh` (sh, 0 symbols)
- `mcp_server.py` (py, 13 symbols)
- `tools.py` (py, 11 symbols)
- `wsgi_app.py` (py, 1 symbols)
### presentation
- `lazyown_infinitestorage.py` (py, 84 symbols)
### testing
- `test_error_correction.py` (py, 10 symbols)
- `test_frames.py` (py, 13 symbols)
- `test_integration.py` (py, 16 symbols)
- `test_protocols.py` (py, 12 symbols)
- `test_security.py` (py, 18 symbols)
- `test_zip.py` (py, 16 symbols)
---
## Architecture Overview
2 components stacked in 1 dependency tiers (weighted Eades-Lin-Smyth ordering: arrows point from dependent to dependency, top to bottom). Labels are import counts, thick arrows the top quartile; 0 transitively implied edges are omitted. Dashed red arrows are upward dependencies: the smallest set of imports that closes every cycle and breaks the layering. Cyan components hold entry points. Interactive version: `readmenator-apidocs/index.html#/flows`.
```mermaid
flowchart TB
classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
subgraph lane_0["Tier 1"]
direction LR
n_d__root_["(root)
1 files, 0 symbols
Core / utility"]:::default
n_c0["root
4 files, 109 symbols
Core / utility"]:::default
end
```
---
## Execution Flows
Entry points are scored from `__main__` guards, `main` functions, entry-style names and files, and call-graph sources. Each flow walks resolved calls in call-site order (depth <= 4, <= 40 steps); numbers give the call order, dashed arrows revisit an already expanded callee, red arrows are recursion. Interactive version with zoom and per-node docs: `readmenator-apidocs/index.html#/flows`.
### `lazyown_infinitestorage.CLIRunner.run`
`lazyown_infinitestorage.py:729`, score 18: entry-style name `run`.
Control flow:
```mermaid
flowchart TB
classDef decision fill:#1e1b4b,stroke:#a78bfa,color:#ede9fe;
classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
n_s1(["start lazyown_infinitestorage.CLIRunner.run"]):::entry
n_s2{"args.gui?"}:::decision
n_s3(["return after run(), GUIRunner()
PyQt5 graphical user interface for LazyOwnInf..."]):::entry
n_s4{"args.serve?"}:::decision
n_s5(["return after run(), WebRunner()
Flask web server interface for LazyOwnInfinit..."]):::entry
n_s6{"not args.mode?"}:::decision
n_s7{"args.mode == 'test'?"}:::decision
n_s8(["return after run_tests()
Executes built-in round-trip tests for both p..."]):::entry
n_s9{"args.mode == 'encode'?"}:::decision
n_s10{"not args.input or not args.output or (not args.frame_size)?"}:::decision
n_s11["encode()
Encodes a file into a video using the specifi..."]:::default
n_s12{"args.mode == 'decode'?"}:::decision
n_s13{"not args.input or not args.output?"}:::decision
n_s14["decode()
Decodes a video back into the original file u..."]:::default
n_s15{"args.mode == 'zip-to-video'?"}:::decision
n_s16{"not args.zip_source or not args.output or (not args.frame..."}:::decision
n_s17["zip_to_video()
Zip a file or directory then encode the archi..."]:::default
n_s18{"args.mode == 'video-to-zip'?"}:::decision
n_s19{"not args.input or not args.zip_output_dir?"}:::decision
n_s20["video_to_zip()
Decode a video to a zip archive then extract..."]:::default
n_s21(["end"]):::entry
n_s1 --> n_s2
n_s2 -->|"yes"| n_s3
n_s2 -->|"no"| n_s4
n_s4 -->|"yes"| n_s5
n_s4 -->|"no"| n_s6
n_s6 -->|"yes"| n_s7
n_s6 -->|"no"| n_s7
n_s7 -->|"yes"| n_s8
n_s7 -->|"no"| n_s9
n_s9 -->|"yes"| n_s10
n_s10 -->|"yes"| n_s11
n_s10 -->|"no"| n_s11
n_s9 -->|"no"| n_s12
n_s12 -->|"yes"| n_s13
n_s13 -->|"yes"| n_s14
n_s13 -->|"no"| n_s14
n_s12 -->|"no"| n_s15
n_s15 -->|"yes"| n_s16
n_s16 -->|"yes"| n_s17
n_s16 -->|"no"| n_s17
n_s15 -->|"no"| n_s18
n_s18 -->|"yes"| n_s19
n_s19 -->|"yes"| n_s20
n_s19 -->|"no"| n_s20
n_s11 --> n_s21
n_s14 --> n_s21
n_s17 --> n_s21
n_s20 --> n_s21
n_s18 -->|"no"| n_s21
```
Call tree:
```mermaid
flowchart LR
classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
n_lazyown_infinitestorage_py__run["lazyown_infinitestorage.CLIRunner.run
lazyown_infinitestorage.py:729"]:::entry
n_lazyown_infinitestorage_py__GUIRunner["lazyown_infinitestorage.GUIRunner
PyQt5 graphical user interface for LazyOwnInf...
lazyown_infinitestorage.py:802"]:::default
n_lazyown_infinitestorage_py__WebRunner["lazyown_infinitestorage.WebRunner
Flask web server interface for LazyOwnInfinit...
lazyown_infinitestorage.py:949"]:::default
n_lazyown_infinitestorage_py__run_tests["lazyown_infinitestorage.run_tests
Executes built-in round-trip tests for both p...
lazyown_infinitestorage.py:1072"]:::default
n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig
Centralized immutable configuration constants...
lazyown_infinitestorage.py:72"]:::default
n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage
Main orchestrator for encoding and decoding f...
lazyown_infinitestorage.py:527"]:::default
n_lazyown_infinitestorage_py__encode["lazyown_infinitestorage.LazyOwnInfiniteStorage.encode
Encodes a file into a video using the specifi...
lazyown_infinitestorage.py:544"]:::default
n_lazyown_infinitestorage_py__validate_file_path["lazyown_infinitestorage.SecurityValidator.validate_file_path
Resolves and validates an absolute file path.
lazyown_infinitestorage.py:162"]:::default
n_lazyown_infinitestorage_py__validate_size["lazyown_infinitestorage.SecurityValidator.validate_size
Ensures the file size is within acceptable li...
lazyown_infinitestorage.py:172"]:::default
n_lazyown_infinitestorage_py___validate_encoding_parameters["lazyown_infinitestorage.LazyOwnInfiniteStorage._validate_...
lazyown_infinitestorage.py:578"]:::default
n_lazyown_infinitestorage_py__bits_to_frames["lazyown_infinitestorage.FrameEncoder.bits_to_frames
Yields grayscale frames from a bit string.
lazyown_infinitestorage.py:256"]:::default
n_lazyown_infinitestorage_py___create_frame["lazyown_infinitestorage.FrameEncoder._create_frame
lazyown_infinitestorage.py:271"]:::default
n_lazyown_infinitestorage_py__encode_video["lazyown_infinitestorage.FFmpegPipeline.encode_video
Encodes a generator of frames into a video fi...
lazyown_infinitestorage.py:374"]:::default
n_lazyown_infinitestorage_py__decode["lazyown_infinitestorage.LazyOwnInfiniteStorage.decode
Decodes a video back into the original file u...
lazyown_infinitestorage.py:567"]:::default
n_lazyown_infinitestorage_py___detect_protocol["lazyown_infinitestorage.LazyOwnInfiniteStorage._detect_pr...
lazyown_infinitestorage.py:588"]:::default
n_lazyown_infinitestorage_py__get_video_info["lazyown_infinitestorage.FFmpegPipeline.get_video_info
Retrieves native resolution and metadata from...
lazyown_infinitestorage.py:319"]:::default
n_lazyown_infinitestorage_py__extract_raw_frames["lazyown_infinitestorage.FFmpegPipeline.extract_raw_frames
Extracts raw grayscale frames from a video fi...
lazyown_infinitestorage.py:401"]:::default
n_lazyown_infinitestorage_py__extract_bits_from_raw_frames["lazyown_infinitestorage.FrameDecoder.extract_bits_from_ra...
Extracts a bit string from rawvideo grayscale...
lazyown_infinitestorage.py:287"]:::default
n_lazyown_infinitestorage_py__decode_data["lazyown_infinitestorage.ErrorCorrector.decode_data
Decodes a Hamming(8,4) encoded byte sequence...
lazyown_infinitestorage.py:208"]:::default
n_lazyown_infinitestorage_py___decode_legacy["lazyown_infinitestorage.LazyOwnInfiniteStorage._decode_le...
lazyown_infinitestorage.py:621"]:::default
n_lazyown_infinitestorage_py__unpack_459["lazyown_infinitestorage.LegacyProtocolHandler.unpack
lazyown_infinitestorage.py:459"]:::default
n_lazyown_infinitestorage_py___decode_secure["lazyown_infinitestorage.LazyOwnInfiniteStorage._decode_se...
lazyown_infinitestorage.py:634"]:::default
n_lazyown_infinitestorage_py__unpack_499["lazyown_infinitestorage.SecureProtocolHandler.unpack
lazyown_infinitestorage.py:499"]:::default
n_lazyown_infinitestorage_py__run -->|"1"| n_lazyown_infinitestorage_py__GUIRunner
n_lazyown_infinitestorage_py__run -->|"2"| n_lazyown_infinitestorage_py__WebRunner
n_lazyown_infinitestorage_py__run -->|"3"| n_lazyown_infinitestorage_py__run_tests
n_lazyown_infinitestorage_py__run_tests -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
n_lazyown_infinitestorage_py__run_tests -->|"2"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
n_lazyown_infinitestorage_py__run_tests -->|"3"| n_lazyown_infinitestorage_py__encode
n_lazyown_infinitestorage_py__encode -->|"1"| n_lazyown_infinitestorage_py__validate_file_path
n_lazyown_infinitestorage_py__encode -->|"2"| n_lazyown_infinitestorage_py__validate_size
n_lazyown_infinitestorage_py__encode -->|"3"| n_lazyown_infinitestorage_py___validate_encoding_parameters
n_lazyown_infinitestorage_py__encode -->|"4"| n_lazyown_infinitestorage_py__bits_to_frames
n_lazyown_infinitestorage_py__bits_to_frames -->|"1"| n_lazyown_infinitestorage_py___create_frame
n_lazyown_infinitestorage_py__encode -->|"5"| n_lazyown_infinitestorage_py__encode_video
n_lazyown_infinitestorage_py__run_tests -->|"4"| n_lazyown_infinitestorage_py__decode
n_lazyown_infinitestorage_py__decode -.-> n_lazyown_infinitestorage_py__validate_file_path
n_lazyown_infinitestorage_py__decode -->|"1"| n_lazyown_infinitestorage_py___detect_protocol
n_lazyown_infinitestorage_py___detect_protocol -->|"1"| n_lazyown_infinitestorage_py__get_video_info
n_lazyown_infinitestorage_py___detect_protocol -->|"2"| n_lazyown_infinitestorage_py__extract_raw_frames
n_lazyown_infinitestorage_py___detect_protocol -->|"3"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
n_lazyown_infinitestorage_py___detect_protocol -->|"4"| n_lazyown_infinitestorage_py__decode_data
n_lazyown_infinitestorage_py__decode -->|"2"| n_lazyown_infinitestorage_py___decode_legacy
n_lazyown_infinitestorage_py___decode_legacy -->|"1"| n_lazyown_infinitestorage_py__extract_raw_frames
n_lazyown_infinitestorage_py___decode_legacy -->|"2"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
n_lazyown_infinitestorage_py___decode_legacy -->|"3"| n_lazyown_infinitestorage_py__unpack_459
n_lazyown_infinitestorage_py__decode -->|"3"| n_lazyown_infinitestorage_py___decode_secure
n_lazyown_infinitestorage_py___decode_secure -->|"1"| n_lazyown_infinitestorage_py__extract_raw_frames
n_lazyown_infinitestorage_py___decode_secure -->|"2"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
n_lazyown_infinitestorage_py___decode_secure -->|"3"| n_lazyown_infinitestorage_py__unpack_499
```
### `lazyown_infinitestorage (__main__)`
`lazyown_infinitestorage.py:1128`, score 8: `if __name__ == "__main__"` guard.
Call tree:
```mermaid
flowchart LR
classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
n_lazyown_infinitestorage_py___main_["lazyown_infinitestorage (__main__)
lazyown_infinitestorage.py"]:::entry
n_lazyown_infinitestorage_py__main["lazyown_infinitestorage.main
Entry point for LazyOwnInfiniteStorage.
lazyown_infinitestorage.py:1120"]:::default
n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage
Main orchestrator for encoding and decoding f...
lazyown_infinitestorage.py:527"]:::default
n_lazyown_infinitestorage_py__CLIRunner["lazyown_infinitestorage.CLIRunner
Command-line interface runner for LazyOwnInfi...
lazyown_infinitestorage.py:723"]:::default
n_lazyown_infinitestorage_py__run["lazyown_infinitestorage.CLIRunner.run
lazyown_infinitestorage.py:729"]:::default
n_lazyown_infinitestorage_py__GUIRunner["lazyown_infinitestorage.GUIRunner
PyQt5 graphical user interface for LazyOwnInf...
lazyown_infinitestorage.py:802"]:::default
n_lazyown_infinitestorage_py__WebRunner["lazyown_infinitestorage.WebRunner
Flask web server interface for LazyOwnInfinit...
lazyown_infinitestorage.py:949"]:::default
n_lazyown_infinitestorage_py__run_tests["lazyown_infinitestorage.run_tests
Executes built-in round-trip tests for both p...
lazyown_infinitestorage.py:1072"]:::default
n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig
Centralized immutable configuration constants...
lazyown_infinitestorage.py:72"]:::default
n_lazyown_infinitestorage_py__encode["lazyown_infinitestorage.LazyOwnInfiniteStorage.encode
Encodes a file into a video using the specifi...
lazyown_infinitestorage.py:544"]:::default
n_lazyown_infinitestorage_py__decode["lazyown_infinitestorage.LazyOwnInfiniteStorage.decode
Decodes a video back into the original file u...
lazyown_infinitestorage.py:567"]:::default
n_lazyown_infinitestorage_py___main_ -->|"1"| n_lazyown_infinitestorage_py__main
n_lazyown_infinitestorage_py__main -->|"1"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
n_lazyown_infinitestorage_py__main -->|"2"| n_lazyown_infinitestorage_py__CLIRunner
n_lazyown_infinitestorage_py__main -->|"3"| n_lazyown_infinitestorage_py__run
n_lazyown_infinitestorage_py__run -->|"1"| n_lazyown_infinitestorage_py__GUIRunner
n_lazyown_infinitestorage_py__run -->|"2"| n_lazyown_infinitestorage_py__WebRunner
n_lazyown_infinitestorage_py__run -->|"3"| n_lazyown_infinitestorage_py__run_tests
n_lazyown_infinitestorage_py__run_tests -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
n_lazyown_infinitestorage_py__run_tests -.-> n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
n_lazyown_infinitestorage_py__run_tests -->|"2"| n_lazyown_infinitestorage_py__encode
n_lazyown_infinitestorage_py__run_tests -->|"3"| n_lazyown_infinitestorage_py__decode
```
### `mcp_server (__main__)`
`mcp_server.py:335`, score 8: `if __name__ == "__main__"` guard.
Call tree:
```mermaid
flowchart LR
classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
classDef external fill:#1a1530,stroke:#a78bfa,color:#ede9fe;
n_mcp_server_py___main_["mcp_server (__main__)
mcp_server.py"]:::entry
n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig
Centralized immutable configuration constants...
lazyown_infinitestorage.py:72"]:::external
n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage
Main orchestrator for encoding and decoding f...
lazyown_infinitestorage.py:527"]:::external
n_mcp_server_py__main["mcp_server.main
Entry point for the LazyOwnInfiniteStorage MC...
mcp_server.py:330"]:::default
n_mcp_server_py___run["mcp_server._run
mcp_server.py:302"]:::default
n_mcp_server_py___main_ -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
n_mcp_server_py___main_ -->|"2"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
n_mcp_server_py___main_ -->|"3"| n_mcp_server_py__main
n_mcp_server_py__main -->|"1"| n_mcp_server_py___run
```
Cross-file sequence:
```mermaid
sequenceDiagram
autonumber
participant p_mcp_server_py as mcp_server.py
participant p_lazyown_infinitestorage_py as lazyown_infinitestorage.py
p_mcp_server_py->>p_lazyown_infinitestorage_py: LazyOwnConfig()
p_mcp_server_py->>p_lazyown_infinitestorage_py: LazyOwnInfiniteStorage()
```
---
## Ranked Context
Files ranked by composite score for the current query context. The ranking combines Personalized PageRank (query relevance), global authority, test coverage, documentation coverage, and code freshness. Model: v1.0.
| Rank | File | Composite | PPR | Authority | Test | Doc |
|------|------|-----------|-----|-----------|------|-----|
| 1 | `lazyown_infinitestorage.py` | 0.3697 | 0.4901 | 0.4901 | 0.00 | 0.51 |
| 2 | `wsgi_app.py` | 0.2368 | 0.0567 | 0.0567 | 0.00 | 2.00 |
| 3 | `tools.py` | 0.1277 | 0.0567 | 0.0567 | 0.00 | 0.91 |
| 4 | `install.sh` | 0.1000 | 0.0000 | 0.0000 | 0.00 | 1.00 |
| 5 | `test_zip.py` | 0.0681 | 0.0567 | 0.0567 | 0.00 | 0.31 |
| 6 | `test_protocols.py` | 0.0618 | 0.0567 | 0.0567 | 0.00 | 0.25 |
| 7 | `test_frames.py` | 0.0599 | 0.0567 | 0.0567 | 0.00 | 0.23 |
| 8 | `test_error_correction.py` | 0.0568 | 0.0567 | 0.0567 | 0.00 | 0.20 |
| 9 | `test_integration.py` | 0.0556 | 0.0567 | 0.0567 | 0.00 | 0.19 |
| 10 | `test_security.py` | 0.0535 | 0.0567 | 0.0567 | 0.00 | 0.17 |
---
## God Nodes
Most architecturally central files ranked by combined import/export degree and symbol richness.
| File | Score | Connections | PageRank |
|------|-------|-------------|----------|
| `lazyown_infinitestorage.py` | 26.4 | | 0.4901 |
| `test_security.py` | 3.8 | | 0.0567 |
| `test_integration.py` | 3.6 | | 0.0567 |
| `test_zip.py` | 3.6 | | 0.0567 |
| `mcp_server.py` | 3.3 | | 0.0000 |
| `test_frames.py` | 3.3 | | 0.0567 |
| `test_protocols.py` | 3.2 | | 0.0567 |
| `tools.py` | 3.1 | | 0.0567 |
| `test_error_correction.py` | 3.0 | | 0.0567 |
| `wsgi_app.py` | 2.1 | | 0.0567 |
---
## Community Analysis
Files grouped by import-based community detection. Cohesion measures how tightly connected each community is internally.
### root (Cohesion: 1.00)
**10 files** in this community:
- `lazyown_infinitestorage.py` (py, 84 symbols)
- `mcp_server.py` (py, 13 symbols)
- `tools.py` (py, 11 symbols)
- `test_error_correction.py` (py, 10 symbols)
- `test_frames.py` (py, 13 symbols)
- `test_integration.py` (py, 16 symbols)
- `test_protocols.py` (py, 12 symbols)
- `test_security.py` (py, 18 symbols)
- `test_zip.py` (py, 16 symbols)
- `wsgi_app.py` (py, 1 symbols)
---
## Suggested Questions
Auto-generated exploration prompts based on graph structure:
- What does lazyown_infinitestorage.py depend on, and what depends on it? (9 connections)
- What does test_security.py depend on, and what depends on it? (1 connections)
- What does test_integration.py depend on, and what depends on it? (1 connections)
- How are the 10 files in 'root' related to each other?
- What is LazyOwnConfig in lazyown_infinitestorage.py and how is it used?
---
## Force-Graph Explorer
Heterogeneous explorer payload (files, communities, layers, externals) rendered with force-graph physics, stable family colors, log2 node sizing, and convex-hull community overlays. Open `readmenator-maps/graph-force.html` (linked from the maps gallery) or run `explorer`.
- Nodes: 47 (community: 1, external: 32, file: 11, layer: 3)
- Edges: 86
---
## Corpus Analytics
Attribution funnel and distributions for the explorer dashboard.
- Files: 11 | With symbols: 10 | Attributed: 10 | God nodes: 10 | Symbols: 194
- Layer `testing`: 6 files
- Layer `utility`: 4 files
- Layer `presentation`: 1 files
- Language `py`: 10 files
- Language `sh`: 1 files
---
## Taint Propagation Map
Taint analysis traces how dangerous imports propagate through the codebase via transitive dependencies. Source files import dangerous modules directly; sink files receive the danger indirectly.
**Taint Sources:** 3 | **Taint Sinks:** 3 | **Propagation Paths:** 5
- `lazyown_infinitestorage.py` imports `subprocess` (0 hop to `lazyown_infinitestorage.py`) [high]
Path: lazyown_infinitestorage.py
- `tools.py` imports `subprocess` (0 hop to `tools.py`) [high]
Path: tools.py
- `tools.py` imports `subprocess` (1 hop to `lazyown_infinitestorage.py`) [high]
Path: tools.py -> lazyown_infinitestorage.py
- `test_integration.py` imports `subprocess` (0 hop to `test_integration.py`) [high]
Path: test_integration.py
- `test_integration.py` imports `subprocess` (1 hop to `lazyown_infinitestorage.py`) [high]
Path: test_integration.py -> lazyown_infinitestorage.py
---
## Hotspot Analysis
Files ranked by combined complexity (symbol count) and centrality (connection count). High-scoring files are architecturally critical and may need refactoring attention.
| File | Complexity | Centrality | Combined | Symbols | Connections |
|------|-----------|------------|----------|---------|-------------|
| `lazyown_infinitestorage.py` | 1.000 | 1.000 | 1.000 | 84 | 29 |
| `wsgi_app.py` | 0.012 | 0.103 | 0.067 | 1 | 3 |
| `tools.py` | 0.131 | 0.414 | 0.301 | 11 | 12 |
| `install.sh` | 0.000 | 0.000 | 0.000 | 0 | 0 |
| `test_zip.py` | 0.191 | 0.207 | 0.200 | 16 | 6 |
| `test_protocols.py` | 0.143 | 0.103 | 0.119 | 12 | 3 |
| `test_frames.py` | 0.155 | 0.138 | 0.145 | 13 | 4 |
| `test_error_correction.py` | 0.119 | 0.103 | 0.110 | 10 | 3 |
| `test_integration.py` | 0.191 | 0.345 | 0.283 | 16 | 10 |
| `test_security.py` | 0.214 | 0.138 | 0.169 | 18 | 4 |
| `mcp_server.py` | 0.155 | 0.310 | 0.248 | 13 | 9 |
---
## Concept Graph
Semantic second-brain layer: nouns are concept nodes, verbs are edges. Each noun maps atomically to a file set (EXTRACTED); each verb aggregates structural imports, calls, and inherits into consumes, invokes, extends, depends_on, or bridges (INFERRED).
**50 concepts, 100 relations.**
| Concept | Files | Mentions |
|---------|-------|----------|
| `setup` | 7 | 14 |
| `protocol` | 6 | 23 |
| `bit` | 6 | 17 |
| `lazy` | 6 | 17 |
| `own` | 6 | 17 |
| `encode` | 6 | 16 |
| `specification` | 6 | 13 |
| `video` | 5 | 33 |
| `decode` | 5 | 17 |
| `extract` | 5 | 16 |
| `infinite` | 5 | 14 |
| `storage` | 5 | 14 |
| `files` | 5 | 6 |
| `zip` | 4 | 42 |
| `file` | 4 | 25 |
| `frame` | 4 | 15 |
| `security` | 4 | 12 |
| `roundtrip` | 4 | 11 |
| `create` | 4 | 9 |
| `secure` | 4 | 9 |
| `filename` | 4 | 8 |
| `get` | 4 | 7 |
| `size` | 4 | 7 |
| `original` | 4 | 5 |
| `bytes` | 4 | 4 |
| `unit` | 4 | 4 |
| `error` | 3 | 13 |
| `path` | 3 | 13 |
| `data` | 3 | 11 |
| `web` | 3 | 11 |
### Verb Edges
| Source | Verb | Target | Strength | Evidence |
|--------|------|--------|----------|----------|
| `setup` | `depends_on` | `back` | 1.00 | 6 |
| `setup` | `depends_on` | `bit` | 1.00 | 6 |
| `setup` | `depends_on` | `blocks` | 1.00 | 6 |
| `setup` | `depends_on` | `bytes` | 1.00 | 6 |
| `setup` | `depends_on` | `correction` | 1.00 | 6 |
| `setup` | `depends_on` | `create` | 1.00 | 6 |
| `setup` | `depends_on` | `data` | 1.00 | 6 |
| `setup` | `depends_on` | `decode` | 1.00 | 6 |
| `setup` | `depends_on` | `encode` | 1.00 | 6 |
| `setup` | `depends_on` | `encoded` | 1.00 | 6 |
| `setup` | `depends_on` | `encodes` | 1.00 | 6 |
| `setup` | `depends_on` | `entry` | 1.00 | 6 |
| `setup` | `depends_on` | `error` | 1.00 | 6 |
| `setup` | `depends_on` | `extract` | 1.00 | 6 |
| `setup` | `depends_on` | `file` | 1.00 | 6 |
| `setup` | `depends_on` | `filename` | 1.00 | 6 |
| `setup` | `depends_on` | `files` | 1.00 | 6 |
| `setup` | `depends_on` | `frame` | 1.00 | 6 |
| `setup` | `depends_on` | `frames` | 1.00 | 6 |
| `setup` | `depends_on` | `get` | 1.00 | 6 |
| `setup` | `depends_on` | `hamming` | 1.00 | 6 |
| `setup` | `depends_on` | `infinite` | 1.00 | 6 |
| `setup` | `depends_on` | `lazy` | 1.00 | 6 |
| `setup` | `depends_on` | `legacy` | 1.00 | 6 |
| `setup` | `depends_on` | `original` | 1.00 | 6 |
| `setup` | `depends_on` | `own` | 1.00 | 6 |
| `setup` | `depends_on` | `path` | 1.00 | 6 |
| `setup` | `depends_on` | `pipeline` | 1.00 | 6 |
| `setup` | `depends_on` | `point` | 1.00 | 6 |
| `setup` | `depends_on` | `protocol` | 1.00 | 6 |
### Dialectic Prompts
- Thesis: `back` centralizes 3 files; Antithesis: `blocks` pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `create` pulls 4 files with 2 shared (Jaccard 0.40); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `decode` pulls 5 files with 3 shared (Jaccard 0.60); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `encode` pulls 6 files with 3 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `encoded` pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `encodes` pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `error` pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `extract` pulls 5 files with 2 shared (Jaccard 0.33); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `file` pulls 4 files with 3 shared (Jaccard 0.75); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
- Thesis: `back` centralizes 3 files; Antithesis: `files` pulls 5 files with 3 shared (Jaccard 0.60); Synthesis: should they merge, split by layer, or keep `bridges` explicit?
---
## Change Impact Analysis
Files sorted by how many other files would be affected if they changed. High-impact files should be changed with caution.
| File | Direct Dependents | Transitive Dependents | Total Impact |
|------|------------------|----------------------|--------------|
| `lazyown_infinitestorage.py` | 9 | 0 | 9 |
| `install.sh` | 0 | 0 | 0 |
| `mcp_server.py` | 0 | 0 | 0 |
| `tools.py` | 0 | 0 | 0 |
| `test_error_correction.py` | 0 | 0 | 0 |
| `test_frames.py` | 0 | 0 | 0 |
| `test_integration.py` | 0 | 0 | 0 |
| `test_protocols.py` | 0 | 0 | 0 |
| `test_security.py` | 0 | 0 | 0 |
| `test_zip.py` | 0 | 0 | 0 |
| `wsgi_app.py` | 0 | 0 | 0 |
---
## Architecture Violations
Violations of architectural layer rules detected in the import graph. **6 strict violations, 0 warnings.**
| Source | Source Layer | Target | Target Layer | Description | Severity |
|--------|-------------|--------|-------------|-------------|----------|
| `test_error_correction.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
| `test_frames.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
| `test_integration.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
| `test_protocols.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
| `test_security.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
| `test_zip.py` | testing | `lazyown_infinitestorage.py` | presentation | testing must not import presentation | strict |
---
## Suggested Linting Rules
Automatically suggested linting and security rules based on patterns detected in the codebase. These can be exported as Semgrep rules using the `--export-rules` flag.
| Rule ID | Severity | Description | Language | Matches |
|---------|----------|-------------|----------|---------|
| `RM001` | info | Large number of functions in py: 165 total | py | 165 |
| `RM002` | info | Print statement found (consider logging instead) | python | 8 |
---
## Query Recipes
Example queries you can run against this knowledge base using the ranking engine:
```
# Find files most relevant to a concept
readmenator query "Where is the import resolver implemented?"
# Rank files by relevance to a topic
readmenator query "How does documentation generation work?"
# Explain why a file ranks highly
readmenator query "explain readmenator/_documentation.py"
# Trace dependency paths with ranked context
readmenator query "path from CLI to exporter"
```
The ranking model uses the following signals:
- **Personalized PageRank** (45% weight): query-specific relevance via seed propagation
- **Global Authority** (20% weight): structural importance via standard PageRank
- **Test Coverage** (15% weight): fraction of symbols referenced in test files
- **Doc Coverage** (10% weight): presence of docstrings and file-level docs
- **Freshness** (10% weight): recent modification activity
Results include score decomposition and justification paths for each ranked item.
---
## Structural Knowledge Map
> **Note:** The visual graph below has been intelligently pruned to the top 300 most relevant nodes to prevent rendering crashes. Full details of all files are documented in the Architecture Reference.
```mermaid
graph LR
classDef mod fill:#1e1e1e,stroke:#ff6666,stroke-width:2px,color:#fff;
classDef cls fill:#2d2d2d,stroke:#4ec9b0,stroke-width:2px,color:#fff;
classDef fn fill:#333,stroke:#dcdcaa,stroke-width:1px,color:#dcdcaa;
classDef ext fill:#111,stroke:#666,stroke-dasharray:5 5,color:#aaa;
subgraph community_0 ["root"]
lazyown_infinitestorage_py["lazyown_infinitestorage.py (py)"]
class lazyown_infinitestorage_py mod;
lazyown_infinitestorage_py_LazyOwnConfig["LazyOwnConfig"]
class lazyown_infinitestorage_py_LazyOwnConfig cls;
lazyown_infinitestorage_py --> lazyown_infinitestorage_py_LazyOwnConfig
lazyown_infinitestorage_py_SecurityValidator["SecurityValidator"]
class lazyown_infinitestorage_py_SecurityValidator cls;
lazyown_infinitestorage_py --> lazyown_infinitestorage_py_SecurityValidator
lazyown_infinitestorage_py_ErrorCorrector["ErrorCorrector"]
class lazyown_infinitestorage_py_ErrorCorrector cls;
lazyown_infinitestorage_py --> lazyown_infinitestorage_py_ErrorCorrector
lazyown_infinitestorage_py_FrameEncoder["FrameEncoder"]
class lazyown_infinitestorage_py_FrameEncoder cls;
lazyown_infinitestorage_py --> lazyown_infinitestorage_py_FrameEncoder
lazyown_infinitestorage_py_FrameDecoder["FrameDecoder"]
class lazyown_infinitestorage_py_FrameDecoder cls;
lazyown_infinitestorage_py --> lazyown_infinitestorage_py_FrameDecoder
skill_lazyown_infinitestorage_tools_py["tools.py (py)"]
class skill_lazyown_infinitestorage_tools_py mod;
tests_test_integration_py["test_integration.py (py)"]
class tests_test_integration_py mod;
mcp_server_py["mcp_server.py (py)"]
class mcp_server_py mod;
tests_test_zip_py["test_zip.py (py)"]
class tests_test_zip_py mod;
tests_test_security_py["test_security.py (py)"]
class tests_test_security_py mod;
tests_test_frames_py["test_frames.py (py)"]
class tests_test_frames_py mod;
tests_test_protocols_py["test_protocols.py (py)"]
class tests_test_protocols_py mod;
tests_test_error_correction_py["test_error_correction.py (py)"]
class tests_test_error_correction_py mod;
wsgi_app_py["wsgi_app.py (py)"]
class wsgi_app_py mod;
install_sh["install.sh (sh)"]
class install_sh mod;
end
lazyown_infinitestorage_py ~~~ tests_test_frames_py
skill_lazyown_infinitestorage_tools_py ~~~ tests_test_protocols_py
tests_test_integration_py ~~~ tests_test_error_correction_py
mcp_server_py ~~~ wsgi_app_py
mcp_server_py -- resolved_imports --> lazyown_infinitestorage_py
skill_lazyown_infinitestorage_tools_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_error_correction_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_frames_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_integration_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_protocols_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_security_py -- resolved_imports --> lazyown_infinitestorage_py
tests_test_zip_py -- resolved_imports --> lazyown_infinitestorage_py
wsgi_app_py -- resolved_imports --> lazyown_infinitestorage_py
ext_argparse["argparse"]
class ext_argparse ext;
lazyown_infinitestorage_py -.->|imports| ext_argparse
ext_binascii["binascii"]
class ext_binascii ext;
lazyown_infinitestorage_py -.->|imports| ext_binascii
ext_math["math"]
class ext_math ext;
lazyown_infinitestorage_py -.->|imports| ext_math
ext_os["os"]
class ext_os ext;
lazyown_infinitestorage_py -.->|imports| ext_os
ext_re["re"]
class ext_re ext;
lazyown_infinitestorage_py -.->|imports| ext_re
ext_struct["struct"]
class ext_struct ext;
lazyown_infinitestorage_py -.->|imports| ext_struct
ext_subprocess["subprocess"]
class ext_subprocess ext;
lazyown_infinitestorage_py -.->|imports| ext_subprocess
ext_sys["sys"]
class ext_sys ext;
lazyown_infinitestorage_py -.->|imports| ext_sys
ext_tempfile["tempfile"]
class ext_tempfile ext;
lazyown_infinitestorage_py -.->|imports| ext_tempfile
ext_hashlib["hashlib"]
class ext_hashlib ext;
lazyown_infinitestorage_py -.->|imports| ext_hashlib
ext_random["random"]
class ext_random ext;
lazyown_infinitestorage_py -.->|imports| ext_random
ext_shutil["shutil"]
class ext_shutil ext;
lazyown_infinitestorage_py -.->|imports| ext_shutil
ext_zipfile["zipfile"]
class ext_zipfile ext;
lazyown_infinitestorage_py -.->|imports| ext_zipfile
ext_typing["typing"]
class ext_typing ext;
lazyown_infinitestorage_py -.->|imports| ext_typing
ext_numpy["numpy"]
class ext_numpy ext;
lazyown_infinitestorage_py -.->|imports| ext_numpy
ext_cv2["cv2"]
class ext_cv2 ext;
lazyown_infinitestorage_py -.->|imports| ext_cv2
ext_flask["flask"]
class ext_flask ext;
lazyown_infinitestorage_py -.->|imports| ext_flask
ext_PyQt5_QtWidgets["PyQt5.QtWidgets"]
class ext_PyQt5_QtWidgets ext;
lazyown_infinitestorage_py -.->|imports| ext_PyQt5_QtWidgets
ext_PyQt5_QtCore["PyQt5.QtCore"]
class ext_PyQt5_QtCore ext;
lazyown_infinitestorage_py -.->|imports| ext_PyQt5_QtCore
ext_json["json"]
class ext_json ext;
lazyown_infinitestorage_py -.->|imports| ext_json
ext_asyncio["asyncio"]
class ext_asyncio ext;
mcp_server_py -.->|imports| ext_asyncio
mcp_server_py -.->|imports| ext_os
mcp_server_py -.->|imports| ext_sys
mcp_server_py -.->|imports| ext_typing
ext_lazyown_infinitestorage["lazyown_infinitestorage"]
class ext_lazyown_infinitestorage ext;
mcp_server_py -.->|imports| ext_lazyown_infinitestorage
ext_mcp_server["mcp.server"]
class ext_mcp_server ext;
mcp_server_py -.->|imports| ext_mcp_server
ext_mcp_server_stdio["mcp.server.stdio"]
class ext_mcp_server_stdio ext;
mcp_server_py -.->|imports| ext_mcp_server_stdio
```
---
## UML Class Diagram
Auto-generated Mermaid class diagrams from parsed class-level symbols, split into groups of at most 6 classes so each diagram stays readable. Per-module class diagrams with exact members live in `readmenator-apidocs/modules/`.
#### `lazyown_infinitestorage.py`
```mermaid
classDiagram
direction LR
class lazyown_infinitestorage_py_LazyOwnConfig {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_SecurityValidator {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_ErrorCorrector {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_FrameEncoder {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_FrameDecoder {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_FFmpegPipeline {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_ProtocolHandler {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_LegacyProtocolHandler {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_SecureProtocolHandler {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_LazyOwnInfiniteStorage {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_CLIRunner {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_Worker {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_GUIRunner {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_GUIRunner {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_WebRunner {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
class lazyown_infinitestorage_py_WebRunner {
<>
+run_tests()
+main()
+__init__(self, config)
+validate_file_path(self, file_path, must_exist)
+validate_size(self, size)
+sanitize_filename(self, filename)
+validate_extension(self, file_path, allowed_extensions)
+__init__(self, config)
+encode_data(self, data)
+decode_data(self, data)
}
```
#### `tests/test_error_correction.py`, `tests/test_frames.py`, `tests/test_integration.py`
```mermaid
classDiagram
direction LR
class test_error_correction_py_TestErrorCorrector {
<>
+setup(self)
+test_encode_data_doubles_length(self)
+test_decode_data_reverses_encoding(self)
+test_decode_data_with_single_bit_error(self)
+test_decode_data_rejects_odd_length(self)
+test_encode_nibble_all_values(self)
+test_decode_nibble_all_values(self)
+test_roundtrip_various_inputs(self, data)
+test_single_bit_error_per_nibble(self, nibble)
}
class test_frames_py_TestFrameEncoder {
<>
+setup(self)
+test_bits_to_frames_yields_correct_number_of_frames(self)
+test_each_frame_has_correct_dimensions(self)
+test_bit_one_produces_white_block(self)
+test_bit_zero_produces_black_block(self)
+test_padding_zeros_fill_incomplete_frame(self)
+setup(self)
+test_extract_bits_from_empty_raises(self)
+test_extract_bits_from_raw_frames_basic(self)
+test_extract_bits_respects_expected_bits(self)
}
class test_frames_py_TestFrameDecoder {
<>
+setup(self)
+test_bits_to_frames_yields_correct_number_of_frames(self)
+test_each_frame_has_correct_dimensions(self)
+test_bit_one_produces_white_block(self)
+test_bit_zero_produces_black_block(self)
+test_padding_zeros_fill_incomplete_frame(self)
+setup(self)
+test_extract_bits_from_empty_raises(self)
+test_extract_bits_from_raw_frames_basic(self)
+test_extract_bits_respects_expected_bits(self)
}
class test_integration_py_TestEncodeDecodeRoundtrip {
<>
+setup(self)
+test_secure_protocol_roundtrip(self)
+test_legacy_protocol_roundtrip(self)
+test_secure_protocol_resilient_to_resolution_change(self)
+test_protocol_auto_detection_prefers_secure(self)
+test_empty_file_roundtrip(self)
+test_large_file_roundtrip(self)
+setup(self)
+test_index_get(self)
+test_encode_upload(self)
}
class test_integration_py_TestWebRunner {
<>
+setup(self)
+test_secure_protocol_roundtrip(self)
+test_legacy_protocol_roundtrip(self)
+test_secure_protocol_resilient_to_resolution_change(self)
+test_protocol_auto_detection_prefers_secure(self)
+test_empty_file_roundtrip(self)
+test_large_file_roundtrip(self)
+setup(self)
+test_index_get(self)
+test_encode_upload(self)
}
```
#### `tests/test_protocols.py`, `tests/test_security.py`
```mermaid
classDiagram
direction LR
class test_protocols_py_TestLegacyProtocolHandler {
<>
+setup(self)
+test_pack_includes_end_marker(self)
+test_unpack_strips_end_marker(self)
+test_unpack_with_trailing_zeros(self)
+setup(self)
+test_pack_produces_bit_string(self)
+test_unpack_recovers_original_data(self)
+test_unpack_detects_corrupted_header(self)
+test_unpack_detects_corrupted_payload(self)
+test_roundtrip_various_sizes(self, size)
}
class test_protocols_py_TestSecureProtocolHandler {
<>
+setup(self)
+test_pack_includes_end_marker(self)
+test_unpack_strips_end_marker(self)
+test_unpack_with_trailing_zeros(self)
+setup(self)
+test_pack_produces_bit_string(self)
+test_unpack_recovers_original_data(self)
+test_unpack_detects_corrupted_header(self)
+test_unpack_detects_corrupted_payload(self)
+test_roundtrip_various_sizes(self, size)
}
class test_security_py_TestLazyOwnConfig {
<>
+test_magic_bytes_are_valid(self)
+test_protocol_versions_are_distinct(self)
+test_default_values_within_bounds(self)
+test_header_offsets_are_consistent(self)
+test_max_file_size_is_reasonable(self)
+setup(self)
+test_validate_file_path_resolves_absolute(self)
+test_validate_file_path_rejects_traversal(self)
+test_validate_file_path_must_exist_when_required(self)
+test_validate_size_rejects_oversized_files(self)
}
class test_security_py_TestSecurityValidator {
<>
+test_magic_bytes_are_valid(self)
+test_protocol_versions_are_distinct(self)
+test_default_values_within_bounds(self)
+test_header_offsets_are_consistent(self)
+test_max_file_size_is_reasonable(self)
+setup(self)
+test_validate_file_path_resolves_absolute(self)
+test_validate_file_path_rejects_traversal(self)
+test_validate_file_path_must_exist_when_required(self)
+test_validate_size_rejects_oversized_files(self)
}
```
#### `tests/test_zip.py`
```mermaid
classDiagram
direction LR
class test_zip_py_TestZipRoundtrip {
<>
+setup(self)
+_make_source_dir(self, tmpdir)
+test_zip_to_video_roundtrip_secure(self)
+test_create_and_extract_zip_roundtrip(self)
+setup(self)
+test_extract_zip_blocks_path_traversal(self)
+test_extract_zip_blocks_uncompressed_bomb(self)
+setup(self)
+test_encode_rejects_output_path_traversal(self)
+setup(self)
}
class test_zip_py_TestZipSecurity {
<>
+setup(self)
+_make_source_dir(self, tmpdir)
+test_zip_to_video_roundtrip_secure(self)
+test_create_and_extract_zip_roundtrip(self)
+setup(self)
+test_extract_zip_blocks_path_traversal(self)
+test_extract_zip_blocks_uncompressed_bomb(self)
+setup(self)
+test_encode_rejects_output_path_traversal(self)
+setup(self)
}
class test_zip_py_TestEncodeOutputValidation {
<>
+setup(self)
+_make_source_dir(self, tmpdir)
+test_zip_to_video_roundtrip_secure(self)
+test_create_and_extract_zip_roundtrip(self)
+setup(self)
+test_extract_zip_blocks_path_traversal(self)
+test_extract_zip_blocks_uncompressed_bomb(self)
+setup(self)
+test_encode_rejects_output_path_traversal(self)
+setup(self)
}
class test_zip_py_TestSecurityValidatorUnchanged {
<>
+setup(self)
+_make_source_dir(self, tmpdir)
+test_zip_to_video_roundtrip_secure(self)
+test_create_and_extract_zip_roundtrip(self)
+setup(self)
+test_extract_zip_blocks_path_traversal(self)
+test_extract_zip_blocks_uncompressed_bomb(self)
+setup(self)
+test_encode_rejects_output_path_traversal(self)
+setup(self)
}
```
---
## Code Property Graph
Machine-readable Code Property Graph (CPG) in JSON-LD format. This block allows AI agents to parse the full structural graph without additional file reads. Compatible with GraphRAG pipelines.
```json
{"@context": "https://schema.org", "analysis": {"communities": [{"cohesion": 1.0, "id": 0, "label": "root", "size": 10}], "god_nodes": [{"node_id": "lazyown_infinitestorage.py", "score": 26.4}, {"node_id": "tests/test_security.py", "score": 3.8}, {"node_id": "tests/test_integration.py", "score": 3.6}, {"node_id": "tests/test_zip.py", "score": 3.6}, {"node_id": "mcp_server.py", "score": 3.3}, {"node_id": "tests/test_frames.py", "score": 3.3}, {"node_id": "tests/test_protocols.py", "score": 3.2}, {"node_id": "skill_lazyown_infinitestorage/tools.py", "score": 3.1}, {"node_id": "tests/test_error_correction.py", "score": 3.0}, {"node_id": "wsgi_app.py", "score": 2.1}], "surprising_connections": []}, "edges": [{"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "argparse"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "binascii"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "math"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "re"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "struct"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "hashlib"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "random"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "shutil"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "zipfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "numpy"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "cv2"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "flask"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "PyQt5.QtWidgets"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "PyQt5.QtCore"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "json"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "asyncio"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.server"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.server.stdio"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.types"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "time"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.common.by"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.support.ui"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.support"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.chrome.service"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_error_correction.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_error_correction.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "numpy"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "hashlib"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "random"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "io"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "io"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_protocols.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_protocols.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "zipfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "wsgi_app.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "wsgi_app.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "mcp_server.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_error_correction.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_frames.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_integration.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_protocols.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_security.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_zip.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "wsgi_app.py", "target": "lazyown_infinitestorage.py"}], "generator": "readmenator", "metadata": {"edge_count": 1206, "file_count": 11, "language_count": 2, "symbol_count": 194}, "nodes": [{"doc": "Verificar si Python está instalado", "id": "install.sh", "kind": "module", "label": "install.sh", "language": "sh", "sha256": "c907d80fd6734993", "symbol_count": 0, "symbols": []}, {"doc": "LazyOwnInfiniteStorage - Production-grade file-to-video encoder/decoder.", "id": "lazyown_infinitestorage.py", "kind": "module", "label": "lazyown_infinitestorage.py", "language": "py", "sha256": "293fde059fe53e04", "symbol_count": 84, "symbols": [{"doc": "Centralized immutable configuration constants for LazyOwnInfiniteStorage.", "kind": "class", "line": 72, "name": "LazyOwnConfig", "signature": "class LazyOwnConfig"}, {"doc": "Validates file paths and inputs to prevent path traversal and abuse.", "kind": "class", "line": 156, "name": "SecurityValidator", "signature": "class SecurityValidator"}, {"doc": "Implements Hamming(8,4) extended error correction for byte streams.", "kind": "class", "line": 192, "name": "ErrorCorrector", "signature": "class ErrorCorrector"}, {"doc": "Encodes bit strings into numpy grayscale frames.", "kind": "class", "line": 250, "name": "FrameEncoder", "signature": "class FrameEncoder"}, {"doc": "Decodes grayscale frames into bit strings.", "kind": "class", "line": 281, "name": "FrameDecoder", "signature": "class FrameDecoder"}, {"doc": "Manages FFmpeg subprocess communication without intermediate frame files.", "kind": "class", "line": 313, "name": "FFmpegPipeline", "signature": "class FFmpegPipeline"}, {"doc": "Abstract base for encoding and decoding protocol implementations.", "kind": "class", "line": 436, "name": "ProtocolHandler", "signature": "class ProtocolHandler"}, {"doc": "Implements the original v1 protocol with filename-based resolution and end marker.", "kind": "class", "line": 448, "name": "LegacyProtocolHandler", "signature": "class LegacyProtocolHandler(ProtocolHandler)"}, {"doc": "Implements the v2 protocol with structured headers, CRC32, and Hamming error correction.", "kind": "class", "line": 473, "name": "SecureProtocolHandler", "signature": "class SecureProtocolHandler(ProtocolHandler)"}, {"doc": "Main orchestrator for encoding and decoding files to and from video.", "kind": "class", "line": 527, "name": "LazyOwnInfiniteStorage", "signature": "class LazyOwnInfiniteStorage"}, {"doc": "Command-line interface runner for LazyOwnInfiniteStorage.", "kind": "class", "line": 723, "name": "CLIRunner", "signature": "class CLIRunner"}, {"doc": "Executes built-in round-trip tests for both protocols.", "kind": "function", "line": 1072, "name": "run_tests", "signature": "def run_tests()"}, {"doc": "Entry point for LazyOwnInfiniteStorage.", "kind": "function", "line": 1120, "name": "main", "signature": "def main()"}, {"kind": "method", "line": 159, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Resolves and validates an absolute file path.", "kind": "method", "line": 162, "name": "validate_file_path", "signature": "def validate_file_path(self, file_path, must_exist)"}, {"doc": "Ensures the file size is within acceptable limits.", "kind": "method", "line": 172, "name": "validate_size", "signature": "def validate_size(self, size)"}, {"doc": "Sanitizes a filename to remove unsafe characters.", "kind": "method", "line": 177, "name": "sanitize_filename", "signature": "def sanitize_filename(self, filename)"}, {"doc": "Ensures the file extension is in the allowed set.", "kind": "method", "line": 185, "name": "validate_extension", "signature": "def validate_extension(self, file_path, allowed_extensions)"}, {"kind": "method", "line": 195, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Encodes a byte sequence using Hamming(8,4) correction.", "kind": "method", "line": 198, "name": "encode_data", "signature": "def encode_data(self, data)"}, {"doc": "Decodes a Hamming(8,4) encoded byte sequence with single-bit error correction.", "kind": "method", "line": 208, "name": "decode_data", "signature": "def decode_data(self, data)"}, {"kind": "method", "line": 219, "name": "_encode_nibble", "signature": "def _encode_nibble(self, nibble)"}, {"kind": "method", "line": 230, "name": "_decode_nibble", "signature": "def _decode_nibble(self, byte_val)"}, {"kind": "method", "line": 253, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Yields grayscale frames from a bit string.", "kind": "method", "line": 256, "name": "bits_to_frames", "signature": "def bits_to_frames(self, bit_string, frame_width, frame_height, block_size)"}, {"kind": "method", "line": 271, "name": "_create_frame", "signature": "def _create_frame(self, bits, width, height, block_size, blocks_per_row)"}, {"kind": "method", "line": 284, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Extracts a bit string from rawvideo grayscale bytes.", "kind": "method", "line": 287, "name": "extract_bits_from_raw_frames", "signature": "def extract_bits_from_raw_frames(self, raw_bytes, width, height, block_size, expected_bits)"}, {"kind": "method", "line": 316, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Retrieves native resolution and metadata from a video file.", "kind": "method", "line": 319, "name": "get_video_info", "signature": "def get_video_info(self, input_path)"}, {"doc": "Retrieves video metadata via ffprobe (no cv2 dependency).", "kind": "method", "line": 335, "name": "_get_video_info_ffprobe", "signature": "def _get_video_info_ffprobe(self, input_path)"}, {"doc": "Extracts custom lazyown metadata from a video file using ffprobe.", "kind": "method", "line": 355, "name": "get_metadata", "signature": "def get_metadata(self, input_path)"}, {"doc": "Encodes a generator of frames into a video file via FFmpeg stdin.", "kind": "method", "line": 374, "name": "encode_video", "signature": "def encode_video(self, frame_generator, output_path, frame_width, frame_height, fps)"}, {"doc": "Extracts raw grayscale frames from a video file via FFmpeg stdout.", "kind": "method", "line": 401, "name": "extract_raw_frames", "signature": "def extract_raw_frames(self, input_path, target_width, target_height, max_frames)"}, {"doc": "Packs raw data into a bit string.", "kind": "method", "line": 439, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"doc": "Unpacks a bit string into raw data.", "kind": "method", "line": 443, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 451, "name": "__init__", "signature": "def __init__(self, config)"}, {"kind": "method", "line": 454, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"kind": "method", "line": 459, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 476, "name": "__init__", "signature": "def __init__(self, config, corrector)"}, {"kind": "method", "line": 480, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"kind": "method", "line": 499, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 530, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Return a WebRunner for WSGI or local web server use.", "kind": "method", "line": 540, "name": "create_web_runner", "signature": "def create_web_runner(self)"}, {"doc": "Encodes a file into a video using the specified protocol.", "kind": "method", "line": 544, "name": "encode", "signature": "def encode(self, input_path, output_path, frame_width, frame_height, fps, block_size, protocol_version)"}, {"doc": "Decodes a video back into the original file using the specified protocol.", "kind": "method", "line": 567, "name": "decode", "signature": "def decode(self, input_path, output_path, block_size, protocol_version)"}, {"kind": "method", "line": 578, "name": "_validate_encoding_parameters", "signature": "def _validate_encoding_parameters(self, frame_width, frame_height, fps, block_size)"}, {"kind": "method", "line": 588, "name": "_detect_protocol", "signature": "def _detect_protocol(self, input_path, block_size)"}, {"kind": "method", "line": 621, "name": "_decode_legacy", "signature": "def _decode_legacy(self, input_path, output_path, block_size)"}, {"kind": "method", "line": 634, "name": "_decode_secure", "signature": "def _decode_secure(self, input_path, output_path, block_size)"}, {"doc": "Return True if target path resolves inside directory (zip slip protection).", "kind": "method", "line": 647, "name": "_is_within_directory", "signature": "def _is_within_directory(self, directory, target)"}, {"doc": "Create a zip archive from a file or directory. Returns the output zip path.", "kind": "method", "line": 653, "name": "create_zip", "signature": "def create_zip(self, source_path, output_zip)"}, {"doc": "Safely extract a zip archive into output_dir (blocks zip slip). Returns output_dir.", "kind": "method", "line": 672, "name": "extract_zip", "signature": "def extract_zip(self, zip_path, output_dir)"}, {"doc": "Zip a file or directory then encode the archive to video. Returns the video path.", "kind": "method", "line": 693, "name": "zip_to_video", "signature": "def zip_to_video(self, source_path, output_video, frame_width, frame_height, fps, block_size, protocol_version)"}, {"doc": "Decode a video to a zip archive then extract it into output_dir. Returns output_dir.", "kind": "method", "line": 707, "name": "video_to_zip", "signature": "def video_to_zip(self, input_video, output_dir, block_size, protocol_version)"}, {"kind": "method", "line": 726, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 729, "name": "run", "signature": "def run(self)"}, {"doc": "Background worker thread for non-blocking GUI operations.", "kind": "class", "line": 783, "name": "Worker", "signature": "class Worker(QThread)"}, {"doc": "PyQt5 graphical user interface for LazyOwnInfiniteStorage.", "kind": "class", "line": 802, "name": "GUIRunner", "signature": "class GUIRunner(QWidget)"}, {"doc": "Stub GUI runner when PyQt5 is unavailable.", "kind": "class", "line": 938, "name": "GUIRunner", "signature": "class GUIRunner"}, {"doc": "Flask web server interface for LazyOwnInfiniteStorage.", "kind": "class", "line": 949, "name": "WebRunner", "signature": "class WebRunner"}, {"doc": "Stub web runner when Flask is unavailable.", "kind": "class", "line": 1062, "name": "WebRunner", "signature": "class WebRunner"}, {"kind": "method", "line": 789, "name": "__init__", "signature": "def __init__(self, func)"}, {"kind": "method", "line": 795, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 805, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 811, "name": "_init_ui", "signature": "def _init_ui(self)"}, {"kind": "method", "line": 879, "name": "_change_mode", "signature": "def _change_mode(self)"}, {"kind": "method", "line": 890, "name": "_browse_input", "signature": "def _browse_input(self)"}, {"kind": "method", "line": 900, "name": "_start", "signature": "def _start(self)"}, {"kind": "method", "line": 923, "name": "_on_finished", "signature": "def _on_finished(self, message)"}, {"kind": "method", "line": 928, "name": "_on_error", "signature": "def _on_error(self, message)"}, {"kind": "method", "line": 933, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 941, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 944, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 952, "name": "__init__", "signature": "def __init__(self, storage)"}, {"doc": "Create directories and validate environment.", "kind": "method", "line": 963, "name": "run_setup", "signature": "def run_setup(self)"}, {"kind": "method", "line": 969, "name": "_setup_routes", "signature": "def _setup_routes(self)"}, {"kind": "method", "line": 1057, "name": "run", "signature": "def run(self, host, port)"}, {"kind": "method", "line": 1065, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 1068, "name": "run", "signature": "def run(self, host, port)"}, {"kind": "function", "line": 974, "name": "_validate_upload", "signature": "def _validate_upload(input_file, action)"}, {"kind": "function", "line": 992, "name": "index", "signature": "def index()"}, {"kind": "function", "line": 1037, "name": "download", "signature": "def download(filename)"}, {"kind": "function", "line": 1045, "name": "add_security_headers", "signature": "def add_security_headers(response)"}]}, {"doc": "Model Context Protocol server for LazyOwnInfiniteStorage. Exposes stdio tools so an agent can run the full zip -> video pipeline and the inverse video -> zip pipeline with easy to remember English commands.", "id": "mcp_server.py", "kind": "module", "label": "mcp_server.py", "language": "py", "sha256": "9323cf445c33e917", "symbol_count": 13, "symbols": [{"kind": "function", "line": 62, "name": "_parse_frame_size", "signature": "def _parse_frame_size(value)"}, {"kind": "function", "line": 69, "name": "_protocol_value", "signature": "def _protocol_value(protocol)"}, {"kind": "function", "line": 79, "name": "_tool_zip_to_video", "signature": "def _tool_zip_to_video(arguments)"}, {"kind": "function", "line": 107, "name": "_tool_video_to_zip", "signature": "def _tool_video_to_zip(arguments)"}, {"kind": "function", "line": 131, "name": "_tool_encode", "signature": "def _tool_encode(arguments)"}, {"kind": "function", "line": 157, "name": "_tool_decode", "signature": "def _tool_decode(arguments)"}, {"kind": "function", "line": 179, "name": "_tool_create_zip", "signature": "def _tool_create_zip(arguments)"}, {"kind": "function", "line": 191, "name": "_tool_extract_zip", "signature": "def _tool_extract_zip(arguments)"}, {"kind": "function", "line": 213, "name": "_build_tools", "signature": "def _build_tools()"}, {"kind": "function", "line": 302, "name": "_run", "signature": "def _run()"}, {"doc": "Entry point for the LazyOwnInfiniteStorage MCP stdio server.", "kind": "function", "line": 330, "name": "main", "signature": "def main()"}, {"kind": "function", "line": 310, "name": "list_tools", "signature": "def list_tools()"}, {"kind": "function", "line": 314, "name": "call_tool", "signature": "def call_tool(name, arguments)"}]}, {"doc": "MCP tools for LazyOwnInfiniteStorage integration.", "id": "skill_lazyown_infinitestorage/tools.py", "kind": "module", "label": "tools.py", "language": "py", "sha256": "720a1ff01052ba14", "symbol_count": 11, "symbols": [{"kind": "function", "line": 34, "name": "_parse_frame_size", "signature": "def _parse_frame_size(frame_size_str)"}, {"kind": "function", "line": 42, "name": "_protocol_value", "signature": "def _protocol_value(protocol)"}, {"doc": "Encode a file into a video using LazyOwnInfiniteStorage.", "kind": "function", "line": 52, "name": "lazyown_infinitestorage_encode", "signature": "def lazyown_infinitestorage_encode(params)"}, {"doc": "Decode a video back into the original file using LazyOwnInfiniteStorage.", "kind": "function", "line": 105, "name": "lazyown_infinitestorage_decode", "signature": "def lazyown_infinitestorage_decode(params)"}, {"doc": "Zip a file or directory then encode the archive into a video (zip -> video).", "kind": "function", "line": 149, "name": "lazyown_zip_to_video", "signature": "def lazyown_zip_to_video(params)"}, {"doc": "Decode a video into a zip archive then extract it (video -> zip -> files).", "kind": "function", "line": 195, "name": "lazyown_video_to_zip", "signature": "def lazyown_video_to_zip(params)"}, {"doc": "Create a zip archive from a file or directory.", "kind": "function", "line": 236, "name": "lazyown_create_zip", "signature": "def lazyown_create_zip(params)"}, {"doc": "Safely extract a zip archive into a directory (blocks zip slip).", "kind": "function", "line": 268, "name": "lazyown_extract_zip", "signature": "def lazyown_extract_zip(params)"}, {"doc": "Upload a video to YouTube using browser automation.", "kind": "function", "line": 299, "name": "lazyown_infinitestorage_upload_to_youtube", "signature": "def lazyown_infinitestorage_upload_to_youtube(params)"}, {"doc": "Get a tool by name.", "kind": "function", "line": 453, "name": "get_tool", "signature": "def get_tool(name)"}, {"doc": "List all available tools.", "kind": "function", "line": 457, "name": "list_tools", "signature": "def list_tools()"}]}, {"doc": "Unit tests for ErrorCorrector Hamming(8,4) implementation.", "id": "tests/test_error_correction.py", "kind": "module", "label": "test_error_correction.py", "language": "py", "sha256": "b873018e8d2792f4", "symbol_count": 10, "symbols": [{"doc": "Specification: ErrorCorrector encodes bytes into Hamming(8,4) and corrects single-bit errors.", "kind": "class", "line": 7, "name": "TestErrorCorrector", "signature": "class TestErrorCorrector"}, {"kind": "method", "line": 11, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 15, "name": "test_encode_data_doubles_length", "signature": "def test_encode_data_doubles_length(self)"}, {"kind": "method", "line": 20, "name": "test_decode_data_reverses_encoding", "signature": "def test_decode_data_reverses_encoding(self)"}, {"kind": "method", "line": 26, "name": "test_decode_data_with_single_bit_error", "signature": "def test_decode_data_with_single_bit_error(self)"}, {"kind": "method", "line": 33, "name": "test_decode_data_rejects_odd_length", "signature": "def test_decode_data_rejects_odd_length(self)"}, {"kind": "method", "line": 37, "name": "test_encode_nibble_all_values", "signature": "def test_encode_nibble_all_values(self)"}, {"kind": "method", "line": 42, "name": "test_decode_nibble_all_values", "signature": "def test_decode_nibble_all_values(self)"}, {"kind": "method", "line": 49, "name": "test_roundtrip_various_inputs", "signature": "def test_roundtrip_various_inputs(self, data)"}, {"kind": "method", "line": 55, "name": "test_single_bit_error_per_nibble", "signature": "def test_single_bit_error_per_nibble(self, nibble)"}]}, {"doc": "Unit tests for FrameEncoder and FrameDecoder.", "id": "tests/test_frames.py", "kind": "module", "label": "test_frames.py", "language": "py", "sha256": "4d1ebb4f001ebc51", "symbol_count": 13, "symbols": [{"doc": "Specification: FrameEncoder converts bit strings into grayscale frames.", "kind": "class", "line": 8, "name": "TestFrameEncoder", "signature": "class TestFrameEncoder"}, {"doc": "Specification: FrameDecoder extracts bit strings from rawvideo grayscale bytes.", "kind": "class", "line": 54, "name": "TestFrameDecoder", "signature": "class TestFrameDecoder"}, {"kind": "method", "line": 12, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 16, "name": "test_bits_to_frames_yields_correct_number_of_frames", "signature": "def test_bits_to_frames_yields_correct_number_of_frames(self)"}, {"kind": "method", "line": 28, "name": "test_each_frame_has_correct_dimensions", "signature": "def test_each_frame_has_correct_dimensions(self)"}, {"kind": "method", "line": 33, "name": "test_bit_one_produces_white_block", "signature": "def test_bit_one_produces_white_block(self)"}, {"kind": "method", "line": 38, "name": "test_bit_zero_produces_black_block", "signature": "def test_bit_zero_produces_black_block(self)"}, {"kind": "method", "line": 43, "name": "test_padding_zeros_fill_incomplete_frame", "signature": "def test_padding_zeros_fill_incomplete_frame(self)"}, {"kind": "method", "line": 58, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 62, "name": "test_extract_bits_from_empty_raises", "signature": "def test_extract_bits_from_empty_raises(self)"}, {"kind": "method", "line": 66, "name": "test_extract_bits_from_raw_frames_basic", "signature": "def test_extract_bits_from_raw_frames_basic(self)"}, {"kind": "method", "line": 74, "name": "test_extract_bits_respects_expected_bits", "signature": "def test_extract_bits_respects_expected_bits(self)"}, {"kind": "method", "line": 82, "name": "test_extract_bits_from_resized_frame", "signature": "def test_extract_bits_from_resized_frame(self)"}]}, {"doc": "Integration tests for full encode/decode roundtrip and web interface.", "id": "tests/test_integration.py", "kind": "module", "label": "test_integration.py", "language": "py", "sha256": "404ebe41024c52b1", "symbol_count": 16, "symbols": [{"doc": "Specification: Files encoded to video and decoded back must be bit-identical.", "kind": "class", "line": 18, "name": "TestEncodeDecodeRoundtrip", "signature": "class TestEncodeDecodeRoundtrip"}, {"doc": "Specification: Web interface accepts uploads, encodes/decodes, and serves downloads.", "kind": "class", "line": 131, "name": "TestWebRunner", "signature": "class TestWebRunner"}, {"kind": "method", "line": 22, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 26, "name": "test_secure_protocol_roundtrip", "signature": "def test_secure_protocol_roundtrip(self)"}, {"kind": "method", "line": 44, "name": "test_legacy_protocol_roundtrip", "signature": "def test_legacy_protocol_roundtrip(self)"}, {"kind": "method", "line": 62, "name": "test_secure_protocol_resilient_to_resolution_change", "signature": "def test_secure_protocol_resilient_to_resolution_change(self)"}, {"kind": "method", "line": 83, "name": "test_protocol_auto_detection_prefers_secure", "signature": "def test_protocol_auto_detection_prefers_secure(self)"}, {"kind": "method", "line": 96, "name": "test_empty_file_roundtrip", "signature": "def test_empty_file_roundtrip(self)"}, {"kind": "method", "line": 110, "name": "test_large_file_roundtrip", "signature": "def test_large_file_roundtrip(self)"}, {"kind": "method", "line": 135, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 142, "name": "test_index_get", "signature": "def test_index_get(self)"}, {"kind": "method", "line": 147, "name": "test_encode_upload", "signature": "def test_encode_upload(self)"}, {"kind": "method", "line": 167, "name": "test_decode_upload", "signature": "def test_decode_upload(self)"}, {"kind": "method", "line": 193, "name": "test_security_headers_present", "signature": "def test_security_headers_present(self)"}, {"kind": "method", "line": 199, "name": "test_download_not_found", "signature": "def test_download_not_found(self)"}, {"kind": "method", "line": 203, "name": "test_missing_file_error", "signature": "def test_missing_file_error(self)"}]}, {"doc": "Unit tests for LegacyProtocolHandler and SecureProtocolHandler.", "id": "tests/test_protocols.py", "kind": "module", "label": "test_protocols.py", "language": "py", "sha256": "89ccde9df4c3c4a4", "symbol_count": 12, "symbols": [{"doc": "Specification: Legacy v1 protocol packs data with end-marker, unpacks by filename resolution.", "kind": "class", "line": 7, "name": "TestLegacyProtocolHandler", "signature": "class TestLegacyProtocolHandler"}, {"doc": "Specification: Secure v2 protocol packs data with header, CRC32, and Hamming correction.", "kind": "class", "line": 35, "name": "TestSecureProtocolHandler", "signature": "class TestSecureProtocolHandler"}, {"kind": "method", "line": 11, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 15, "name": "test_pack_includes_end_marker", "signature": "def test_pack_includes_end_marker(self)"}, {"kind": "method", "line": 21, "name": "test_unpack_strips_end_marker", "signature": "def test_unpack_strips_end_marker(self)"}, {"kind": "method", "line": 27, "name": "test_unpack_with_trailing_zeros", "signature": "def test_unpack_with_trailing_zeros(self)"}, {"kind": "method", "line": 39, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 44, "name": "test_pack_produces_bit_string", "signature": "def test_pack_produces_bit_string(self)"}, {"kind": "method", "line": 49, "name": "test_unpack_recovers_original_data", "signature": "def test_unpack_recovers_original_data(self)"}, {"kind": "method", "line": 55, "name": "test_unpack_detects_corrupted_header", "signature": "def test_unpack_detects_corrupted_header(self)"}, {"kind": "method", "line": 66, "name": "test_unpack_detects_corrupted_payload", "signature": "def test_unpack_detects_corrupted_payload(self)"}, {"kind": "method", "line": 80, "name": "test_roundtrip_various_sizes", "signature": "def test_roundtrip_various_sizes(self, size)"}]}, {"doc": "Unit tests for LazyOwnConfig and SecurityValidator.", "id": "tests/test_security.py", "kind": "module", "label": "test_security.py", "language": "py", "sha256": "11b1f9c609ab39e0", "symbol_count": 18, "symbols": [{"doc": "Specification: Configuration constants are centralized and immutable.", "kind": "class", "line": 9, "name": "TestLazyOwnConfig", "signature": "class TestLazyOwnConfig"}, {"doc": "Specification: SecurityValidator prevents path traversal, validates sizes and extensions.", "kind": "class", "line": 37, "name": "TestSecurityValidator", "signature": "class TestSecurityValidator"}, {"kind": "method", "line": 12, "name": "test_magic_bytes_are_valid", "signature": "def test_magic_bytes_are_valid(self)"}, {"kind": "method", "line": 15, "name": "test_protocol_versions_are_distinct", "signature": "def test_protocol_versions_are_distinct(self)"}, {"kind": "method", "line": 18, "name": "test_default_values_within_bounds", "signature": "def test_default_values_within_bounds(self)"}, {"kind": "method", "line": 24, "name": "test_header_offsets_are_consistent", "signature": "def test_header_offsets_are_consistent(self)"}, {"kind": "method", "line": 31, "name": "test_max_file_size_is_reasonable", "signature": "def test_max_file_size_is_reasonable(self)"}, {"kind": "method", "line": 41, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 45, "name": "test_validate_file_path_resolves_absolute", "signature": "def test_validate_file_path_resolves_absolute(self)"}, {"kind": "method", "line": 50, "name": "test_validate_file_path_rejects_traversal", "signature": "def test_validate_file_path_rejects_traversal(self)"}, {"kind": "method", "line": 54, "name": "test_validate_file_path_must_exist_when_required", "signature": "def test_validate_file_path_must_exist_when_required(self)"}, {"kind": "method", "line": 58, "name": "test_validate_size_rejects_oversized_files", "signature": "def test_validate_size_rejects_oversized_files(self)"}, {"kind": "method", "line": 62, "name": "test_validate_size_accepts_maximum", "signature": "def test_validate_size_accepts_maximum(self)"}, {"kind": "method", "line": 65, "name": "test_sanitize_filename_strips_unsafe_characters", "signature": "def test_sanitize_filename_strips_unsafe_characters(self)"}, {"kind": "method", "line": 70, "name": "test_sanitize_filename_preserves_safe_characters", "signature": "def test_sanitize_filename_preserves_safe_characters(self)"}, {"kind": "method", "line": 74, "name": "test_sanitize_filename_fallback", "signature": "def test_sanitize_filename_fallback(self)"}, {"kind": "method", "line": 77, "name": "test_validate_extension_accepts_allowed", "signature": "def test_validate_extension_accepts_allowed(self)"}, {"kind": "method", "line": 81, "name": "test_validate_extension_rejects_disallowed", "signature": "def test_validate_extension_rejects_disallowed(self)"}]}, {"doc": "Tests for zip pipeline and security hardening in LazyOwnInfiniteStorage.", "id": "tests/test_zip.py", "kind": "module", "label": "test_zip.py", "language": "py", "sha256": "73da10b1b4a96b56", "symbol_count": 16, "symbols": [{"doc": "Specification: zip -> video -> zip must recover the original files bit-identical.", "kind": "class", "line": 12, "name": "TestZipRoundtrip", "signature": "class TestZipRoundtrip"}, {"doc": "Specification: Zip extraction blocks zip slip and zip bombs.", "kind": "class", "line": 67, "name": "TestZipSecurity", "signature": "class TestZipSecurity"}, {"doc": "Specification: The final encoded output path is validated, not just the requested one.", "kind": "class", "line": 100, "name": "TestEncodeOutputValidation", "signature": "class TestEncodeOutputValidation"}, {"doc": "Specification: Existing security validator behavior is preserved.", "kind": "class", "line": 118, "name": "TestSecurityValidatorUnchanged", "signature": "class TestSecurityValidatorUnchanged"}, {"kind": "method", "line": 16, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 20, "name": "_make_source_dir", "signature": "def _make_source_dir(self, tmpdir)"}, {"kind": "method", "line": 33, "name": "test_zip_to_video_roundtrip_secure", "signature": "def test_zip_to_video_roundtrip_secure(self)"}, {"kind": "method", "line": 53, "name": "test_create_and_extract_zip_roundtrip", "signature": "def test_create_and_extract_zip_roundtrip(self)"}, {"kind": "method", "line": 71, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 75, "name": "test_extract_zip_blocks_path_traversal", "signature": "def test_extract_zip_blocks_path_traversal(self)"}, {"kind": "method", "line": 88, "name": "test_extract_zip_blocks_uncompressed_bomb", "signature": "def test_extract_zip_blocks_uncompressed_bomb(self)"}, {"kind": "method", "line": 104, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 108, "name": "test_encode_rejects_output_path_traversal", "signature": "def test_encode_rejects_output_path_traversal(self)"}, {"kind": "method", "line": 122, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 126, "name": "test_rejects_traversal", "signature": "def test_rejects_traversal(self)"}, {"kind": "method", "line": 130, "name": "test_sanitizes_filename", "signature": "def test_sanitizes_filename(self)"}]}, {"doc": "WSGI entry point for LazyOwnInfiniteStorage web server.", "id": "wsgi_app.py", "kind": "module", "label": "wsgi_app.py", "language": "py", "sha256": "6be8aa9c5729c17a", "symbol_count": 1, "symbols": [{"doc": "Factory function returning a gunicorn-compatible Flask application.", "kind": "function", "line": 7, "name": "get_wsgi_app", "signature": "def get_wsgi_app()"}]}], "type": "CodePropertyGraph", "version": "1.0"}
```
---
## Architecture Reference
### PY (10 files)
#### `lazyown_infinitestorage.py`
**Path:** `lazyown_infinitestorage.py`
**File Doc:** *LazyOwnInfiniteStorage - Production-grade file-to-video encoder/decoder.*
**Classes:**
- `LazyOwnConfig` (line 72) `class LazyOwnConfig` - *Centralized immutable configuration constants for LazyOwnInfiniteStorage.*
- `SecurityValidator` (line 156) `class SecurityValidator` - *Validates file paths and inputs to prevent path traversal and abuse.*
- `ErrorCorrector` (line 192) `class ErrorCorrector` - *Implements Hamming(8,4) extended error correction for byte streams.*
- `FrameEncoder` (line 250) `class FrameEncoder` - *Encodes bit strings into numpy grayscale frames.*
- `FrameDecoder` (line 281) `class FrameDecoder` - *Decodes grayscale frames into bit strings.*
- `FFmpegPipeline` (line 313) `class FFmpegPipeline` - *Manages FFmpeg subprocess communication without intermediate frame files.*
- `ProtocolHandler` (line 436) `class ProtocolHandler` - *Abstract base for encoding and decoding protocol implementations.*
- `LegacyProtocolHandler` (line 448) `class LegacyProtocolHandler(ProtocolHandler)` - *Implements the original v1 protocol with filename-based resolution and end marker.*
- `SecureProtocolHandler` (line 473) `class SecureProtocolHandler(ProtocolHandler)` - *Implements the v2 protocol with structured headers, CRC32, and Hamming error correction.*
- `LazyOwnInfiniteStorage` (line 527) `class LazyOwnInfiniteStorage` - *Main orchestrator for encoding and decoding files to and from video.*
- `CLIRunner` (line 723) `class CLIRunner` - *Command-line interface runner for LazyOwnInfiniteStorage.*
- `Worker` (line 783) `class Worker(QThread)` - *Background worker thread for non-blocking GUI operations.*
- `GUIRunner` (line 802) `class GUIRunner(QWidget)` - *PyQt5 graphical user interface for LazyOwnInfiniteStorage.*
- `GUIRunner` (line 938) `class GUIRunner` - *Stub GUI runner when PyQt5 is unavailable.*
- `WebRunner` (line 949) `class WebRunner` - *Flask web server interface for LazyOwnInfiniteStorage.*
- `WebRunner` (line 1062) `class WebRunner` - *Stub web runner when Flask is unavailable.*
**Functions:**
- `run_tests` (line 1072) `def run_tests()` - *Executes built-in round-trip tests for both protocols.*
- `main` (line 1120) `def main()` - *Entry point for LazyOwnInfiniteStorage.*
- `_validate_upload` (line 974) `def _validate_upload(input_file, action)`
- `index` (line 992) `def index()`
- `download` (line 1037) `def download(filename)`
- `add_security_headers` (line 1045) `def add_security_headers(response)`
**Methods:**
- `__init__` (line 159) `def __init__(self, config)`
- `validate_file_path` (line 162) `def validate_file_path(self, file_path, must_exist)` - *Resolves and validates an absolute file path.*
- `validate_size` (line 172) `def validate_size(self, size)` - *Ensures the file size is within acceptable limits.*
- `sanitize_filename` (line 177) `def sanitize_filename(self, filename)` - *Sanitizes a filename to remove unsafe characters.*
- `validate_extension` (line 185) `def validate_extension(self, file_path, allowed_extensions)` - *Ensures the file extension is in the allowed set.*
- `__init__` (line 195) `def __init__(self, config)`
- `encode_data` (line 198) `def encode_data(self, data)` - *Encodes a byte sequence using Hamming(8,4) correction.*
- `decode_data` (line 208) `def decode_data(self, data)` - *Decodes a Hamming(8,4) encoded byte sequence with single-bit error correction.*
- `_encode_nibble` (line 219) `def _encode_nibble(self, nibble)`
- `_decode_nibble` (line 230) `def _decode_nibble(self, byte_val)`
- `__init__` (line 253) `def __init__(self, config)`
- `bits_to_frames` (line 256) `def bits_to_frames(self, bit_string, frame_width, frame_height, block_size)` - *Yields grayscale frames from a bit string.*
- `_create_frame` (line 271) `def _create_frame(self, bits, width, height, block_size, blocks_per_row)`
- `__init__` (line 284) `def __init__(self, config)`
- `extract_bits_from_raw_frames` (line 287) `def extract_bits_from_raw_frames(self, raw_bytes, width, height, block_size, expected_bits)` - *Extracts a bit string from rawvideo grayscale bytes.*
- `__init__` (line 316) `def __init__(self, config)`
- `get_video_info` (line 319) `def get_video_info(self, input_path)` - *Retrieves native resolution and metadata from a video file.*
- `_get_video_info_ffprobe` (line 335) `def _get_video_info_ffprobe(self, input_path)` - *Retrieves video metadata via ffprobe (no cv2 dependency).*
- `get_metadata` (line 355) `def get_metadata(self, input_path)` - *Extracts custom lazyown metadata from a video file using ffprobe.*
- `encode_video` (line 374) `def encode_video(self, frame_generator, output_path, frame_width, frame_height, fps)` - *Encodes a generator of frames into a video file via FFmpeg stdin.*
- `extract_raw_frames` (line 401) `def extract_raw_frames(self, input_path, target_width, target_height, max_frames)` - *Extracts raw grayscale frames from a video file via FFmpeg stdout.*
- `pack` (line 439) `def pack(self, data, frame_width, frame_height, block_size, fps)` - *Packs raw data into a bit string.*
- `unpack` (line 443) `def unpack(self, bit_string, block_size)` - *Unpacks a bit string into raw data.*
- `__init__` (line 451) `def __init__(self, config)`
- `pack` (line 454) `def pack(self, data, frame_width, frame_height, block_size, fps)`
- `unpack` (line 459) `def unpack(self, bit_string, block_size)`
- `__init__` (line 476) `def __init__(self, config, corrector)`
- `pack` (line 480) `def pack(self, data, frame_width, frame_height, block_size, fps)`
- `unpack` (line 499) `def unpack(self, bit_string, block_size)`
- `__init__` (line 530) `def __init__(self, config)`
- `create_web_runner` (line 540) `def create_web_runner(self)` - *Return a WebRunner for WSGI or local web server use.*
- `encode` (line 544) `def encode(self, input_path, output_path, frame_width, frame_height, fps, block_size, protocol_version)` - *Encodes a file into a video using the specified protocol.*
- `decode` (line 567) `def decode(self, input_path, output_path, block_size, protocol_version)` - *Decodes a video back into the original file using the specified protocol.*
- `_validate_encoding_parameters` (line 578) `def _validate_encoding_parameters(self, frame_width, frame_height, fps, block_size)`
- `_detect_protocol` (line 588) `def _detect_protocol(self, input_path, block_size)`
- `_decode_legacy` (line 621) `def _decode_legacy(self, input_path, output_path, block_size)`
- `_decode_secure` (line 634) `def _decode_secure(self, input_path, output_path, block_size)`
- `_is_within_directory` (line 647) `def _is_within_directory(self, directory, target)` - *Return True if target path resolves inside directory (zip slip protection).*
- `create_zip` (line 653) `def create_zip(self, source_path, output_zip)` - *Create a zip archive from a file or directory. Returns the output zip path.*
- `extract_zip` (line 672) `def extract_zip(self, zip_path, output_dir)` - *Safely extract a zip archive into output_dir (blocks zip slip). Returns output_dir.*
- `zip_to_video` (line 693) `def zip_to_video(self, source_path, output_video, frame_width, frame_height, fps, block_size, protocol_version)` - *Zip a file or directory then encode the archive to video. Returns the video path.*
- `video_to_zip` (line 707) `def video_to_zip(self, input_video, output_dir, block_size, protocol_version)` - *Decode a video to a zip archive then extract it into output_dir. Returns output_dir.*
- `__init__` (line 726) `def __init__(self, storage)`
- `run` (line 729) `def run(self)`
- `__init__` (line 789) `def __init__(self, func)`
- `run` (line 795) `def run(self)`
- `__init__` (line 805) `def __init__(self, storage)`
- `_init_ui` (line 811) `def _init_ui(self)`
- `_change_mode` (line 879) `def _change_mode(self)`
- `_browse_input` (line 890) `def _browse_input(self)`
- `_start` (line 900) `def _start(self)`
- `_on_finished` (line 923) `def _on_finished(self, message)`
- `_on_error` (line 928) `def _on_error(self, message)`
- `run` (line 933) `def run(self)`
- `__init__` (line 941) `def __init__(self, storage)`
- `run` (line 944) `def run(self)`
- `__init__` (line 952) `def __init__(self, storage)`
- `run_setup` (line 963) `def run_setup(self)` - *Create directories and validate environment.*
- `_setup_routes` (line 969) `def _setup_routes(self)`
- `run` (line 1057) `def run(self, host, port)`
- `__init__` (line 1065) `def __init__(self, storage)`
- `run` (line 1068) `def run(self, host, port)`
#### `mcp_server.py`
**Path:** `mcp_server.py`
**File Doc:** *Model Context Protocol server for LazyOwnInfiniteStorage. Exposes stdio tools so an agent can run the full zip -> video pipeline and the inverse video -> zip pipeline with easy to remember English commands.*
**Functions:**
- `_parse_frame_size` (line 62) `def _parse_frame_size(value)`
- `_protocol_value` (line 69) `def _protocol_value(protocol)`
- `_tool_zip_to_video` (line 79) `def _tool_zip_to_video(arguments)`
- `_tool_video_to_zip` (line 107) `def _tool_video_to_zip(arguments)`
- `_tool_encode` (line 131) `def _tool_encode(arguments)`
- `_tool_decode` (line 157) `def _tool_decode(arguments)`
- `_tool_create_zip` (line 179) `def _tool_create_zip(arguments)`
- `_tool_extract_zip` (line 191) `def _tool_extract_zip(arguments)`
- `_build_tools` (line 213) `def _build_tools()`
- `_run` (line 302) `def _run()`
- `main` (line 330) `def main()` - *Entry point for the LazyOwnInfiniteStorage MCP stdio server.*
- `list_tools` (line 310) `def list_tools()`
- `call_tool` (line 314) `def call_tool(name, arguments)`
#### `tools.py`
**Path:** `skill_lazyown_infinitestorage/tools.py`
**File Doc:** *MCP tools for LazyOwnInfiniteStorage integration.*
**Functions:**
- `_parse_frame_size` (line 34) `def _parse_frame_size(frame_size_str)`
- `_protocol_value` (line 42) `def _protocol_value(protocol)`
- `lazyown_infinitestorage_encode` (line 52) `def lazyown_infinitestorage_encode(params)` - *Encode a file into a video using LazyOwnInfiniteStorage.*
- `lazyown_infinitestorage_decode` (line 105) `def lazyown_infinitestorage_decode(params)` - *Decode a video back into the original file using LazyOwnInfiniteStorage.*
- `lazyown_zip_to_video` (line 149) `def lazyown_zip_to_video(params)` - *Zip a file or directory then encode the archive into a video (zip -> video).*
- `lazyown_video_to_zip` (line 195) `def lazyown_video_to_zip(params)` - *Decode a video into a zip archive then extract it (video -> zip -> files).*
- `lazyown_create_zip` (line 236) `def lazyown_create_zip(params)` - *Create a zip archive from a file or directory.*
- `lazyown_extract_zip` (line 268) `def lazyown_extract_zip(params)` - *Safely extract a zip archive into a directory (blocks zip slip).*
- `lazyown_infinitestorage_upload_to_youtube` (line 299) `def lazyown_infinitestorage_upload_to_youtube(params)` - *Upload a video to YouTube using browser automation.*
- `get_tool` (line 453) `def get_tool(name)` - *Get a tool by name.*
- `list_tools` (line 457) `def list_tools()` - *List all available tools.*
#### `test_error_correction.py`
**Path:** `tests/test_error_correction.py`
**File Doc:** *Unit tests for ErrorCorrector Hamming(8,4) implementation.*
**Classes:**
- `TestErrorCorrector` (line 7) `class TestErrorCorrector` - *Specification: ErrorCorrector encodes bytes into Hamming(8,4) and corrects single-bit errors.*
**Methods:**
- `setup` (line 11) `def setup(self)`
- `test_encode_data_doubles_length` (line 15) `def test_encode_data_doubles_length(self)`
- `test_decode_data_reverses_encoding` (line 20) `def test_decode_data_reverses_encoding(self)`
- `test_decode_data_with_single_bit_error` (line 26) `def test_decode_data_with_single_bit_error(self)`
- `test_decode_data_rejects_odd_length` (line 33) `def test_decode_data_rejects_odd_length(self)`
- `test_encode_nibble_all_values` (line 37) `def test_encode_nibble_all_values(self)`
- `test_decode_nibble_all_values` (line 42) `def test_decode_nibble_all_values(self)`
- `test_roundtrip_various_inputs` (line 49) `def test_roundtrip_various_inputs(self, data)`
- `test_single_bit_error_per_nibble` (line 55) `def test_single_bit_error_per_nibble(self, nibble)`
#### `test_frames.py`
**Path:** `tests/test_frames.py`
**File Doc:** *Unit tests for FrameEncoder and FrameDecoder.*
**Classes:**
- `TestFrameEncoder` (line 8) `class TestFrameEncoder` - *Specification: FrameEncoder converts bit strings into grayscale frames.*
- `TestFrameDecoder` (line 54) `class TestFrameDecoder` - *Specification: FrameDecoder extracts bit strings from rawvideo grayscale bytes.*
**Methods:**
- `setup` (line 12) `def setup(self)`
- `test_bits_to_frames_yields_correct_number_of_frames` (line 16) `def test_bits_to_frames_yields_correct_number_of_frames(self)`
- `test_each_frame_has_correct_dimensions` (line 28) `def test_each_frame_has_correct_dimensions(self)`
- `test_bit_one_produces_white_block` (line 33) `def test_bit_one_produces_white_block(self)`
- `test_bit_zero_produces_black_block` (line 38) `def test_bit_zero_produces_black_block(self)`
- `test_padding_zeros_fill_incomplete_frame` (line 43) `def test_padding_zeros_fill_incomplete_frame(self)`
- `setup` (line 58) `def setup(self)`
- `test_extract_bits_from_empty_raises` (line 62) `def test_extract_bits_from_empty_raises(self)`
- `test_extract_bits_from_raw_frames_basic` (line 66) `def test_extract_bits_from_raw_frames_basic(self)`
- `test_extract_bits_respects_expected_bits` (line 74) `def test_extract_bits_respects_expected_bits(self)`
- `test_extract_bits_from_resized_frame` (line 82) `def test_extract_bits_from_resized_frame(self)`
#### `test_integration.py`
**Path:** `tests/test_integration.py`
**File Doc:** *Integration tests for full encode/decode roundtrip and web interface.*
**Classes:**
- `TestEncodeDecodeRoundtrip` (line 18) `class TestEncodeDecodeRoundtrip` - *Specification: Files encoded to video and decoded back must be bit-identical.*
- `TestWebRunner` (line 131) `class TestWebRunner` - *Specification: Web interface accepts uploads, encodes/decodes, and serves downloads.*
**Methods:**
- `setup` (line 22) `def setup(self)`
- `test_secure_protocol_roundtrip` (line 26) `def test_secure_protocol_roundtrip(self)`
- `test_legacy_protocol_roundtrip` (line 44) `def test_legacy_protocol_roundtrip(self)`
- `test_secure_protocol_resilient_to_resolution_change` (line 62) `def test_secure_protocol_resilient_to_resolution_change(self)`
- `test_protocol_auto_detection_prefers_secure` (line 83) `def test_protocol_auto_detection_prefers_secure(self)`
- `test_empty_file_roundtrip` (line 96) `def test_empty_file_roundtrip(self)`
- `test_large_file_roundtrip` (line 110) `def test_large_file_roundtrip(self)`
- `setup` (line 135) `def setup(self)`
- `test_index_get` (line 142) `def test_index_get(self)`
- `test_encode_upload` (line 147) `def test_encode_upload(self)`
- `test_decode_upload` (line 167) `def test_decode_upload(self)`
- `test_security_headers_present` (line 193) `def test_security_headers_present(self)`
- `test_download_not_found` (line 199) `def test_download_not_found(self)`
- `test_missing_file_error` (line 203) `def test_missing_file_error(self)`
#### `test_protocols.py`
**Path:** `tests/test_protocols.py`
**File Doc:** *Unit tests for LegacyProtocolHandler and SecureProtocolHandler.*
**Classes:**
- `TestLegacyProtocolHandler` (line 7) `class TestLegacyProtocolHandler` - *Specification: Legacy v1 protocol packs data with end-marker, unpacks by filename resolution.*
- `TestSecureProtocolHandler` (line 35) `class TestSecureProtocolHandler` - *Specification: Secure v2 protocol packs data with header, CRC32, and Hamming correction.*
**Methods:**
- `setup` (line 11) `def setup(self)`
- `test_pack_includes_end_marker` (line 15) `def test_pack_includes_end_marker(self)`
- `test_unpack_strips_end_marker` (line 21) `def test_unpack_strips_end_marker(self)`
- `test_unpack_with_trailing_zeros` (line 27) `def test_unpack_with_trailing_zeros(self)`
- `setup` (line 39) `def setup(self)`
- `test_pack_produces_bit_string` (line 44) `def test_pack_produces_bit_string(self)`
- `test_unpack_recovers_original_data` (line 49) `def test_unpack_recovers_original_data(self)`
- `test_unpack_detects_corrupted_header` (line 55) `def test_unpack_detects_corrupted_header(self)`
- `test_unpack_detects_corrupted_payload` (line 66) `def test_unpack_detects_corrupted_payload(self)`
- `test_roundtrip_various_sizes` (line 80) `def test_roundtrip_various_sizes(self, size)`
#### `test_security.py`
**Path:** `tests/test_security.py`
**File Doc:** *Unit tests for LazyOwnConfig and SecurityValidator.*
**Classes:**
- `TestLazyOwnConfig` (line 9) `class TestLazyOwnConfig` - *Specification: Configuration constants are centralized and immutable.*
- `TestSecurityValidator` (line 37) `class TestSecurityValidator` - *Specification: SecurityValidator prevents path traversal, validates sizes and extensions.*
**Methods:**
- `test_magic_bytes_are_valid` (line 12) `def test_magic_bytes_are_valid(self)`
- `test_protocol_versions_are_distinct` (line 15) `def test_protocol_versions_are_distinct(self)`
- `test_default_values_within_bounds` (line 18) `def test_default_values_within_bounds(self)`
- `test_header_offsets_are_consistent` (line 24) `def test_header_offsets_are_consistent(self)`
- `test_max_file_size_is_reasonable` (line 31) `def test_max_file_size_is_reasonable(self)`
- `setup` (line 41) `def setup(self)`
- `test_validate_file_path_resolves_absolute` (line 45) `def test_validate_file_path_resolves_absolute(self)`
- `test_validate_file_path_rejects_traversal` (line 50) `def test_validate_file_path_rejects_traversal(self)`
- `test_validate_file_path_must_exist_when_required` (line 54) `def test_validate_file_path_must_exist_when_required(self)`
- `test_validate_size_rejects_oversized_files` (line 58) `def test_validate_size_rejects_oversized_files(self)`
- `test_validate_size_accepts_maximum` (line 62) `def test_validate_size_accepts_maximum(self)`
- `test_sanitize_filename_strips_unsafe_characters` (line 65) `def test_sanitize_filename_strips_unsafe_characters(self)`
- `test_sanitize_filename_preserves_safe_characters` (line 70) `def test_sanitize_filename_preserves_safe_characters(self)`
- `test_sanitize_filename_fallback` (line 74) `def test_sanitize_filename_fallback(self)`
- `test_validate_extension_accepts_allowed` (line 77) `def test_validate_extension_accepts_allowed(self)`
- `test_validate_extension_rejects_disallowed` (line 81) `def test_validate_extension_rejects_disallowed(self)`
#### `test_zip.py`
**Path:** `tests/test_zip.py`
**File Doc:** *Tests for zip pipeline and security hardening in LazyOwnInfiniteStorage.*
**Classes:**
- `TestZipRoundtrip` (line 12) `class TestZipRoundtrip` - *Specification: zip -> video -> zip must recover the original files bit-identical.*
- `TestZipSecurity` (line 67) `class TestZipSecurity` - *Specification: Zip extraction blocks zip slip and zip bombs.*
- `TestEncodeOutputValidation` (line 100) `class TestEncodeOutputValidation` - *Specification: The final encoded output path is validated, not just the requested one.*
- `TestSecurityValidatorUnchanged` (line 118) `class TestSecurityValidatorUnchanged` - *Specification: Existing security validator behavior is preserved.*
**Methods:**
- `setup` (line 16) `def setup(self)`
- `_make_source_dir` (line 20) `def _make_source_dir(self, tmpdir)`
- `test_zip_to_video_roundtrip_secure` (line 33) `def test_zip_to_video_roundtrip_secure(self)`
- `test_create_and_extract_zip_roundtrip` (line 53) `def test_create_and_extract_zip_roundtrip(self)`
- `setup` (line 71) `def setup(self)`
- `test_extract_zip_blocks_path_traversal` (line 75) `def test_extract_zip_blocks_path_traversal(self)`
- `test_extract_zip_blocks_uncompressed_bomb` (line 88) `def test_extract_zip_blocks_uncompressed_bomb(self)`
- `setup` (line 104) `def setup(self)`
- `test_encode_rejects_output_path_traversal` (line 108) `def test_encode_rejects_output_path_traversal(self)`
- `setup` (line 122) `def setup(self)`
- `test_rejects_traversal` (line 126) `def test_rejects_traversal(self)`
- `test_sanitizes_filename` (line 130) `def test_sanitizes_filename(self)`
#### `wsgi_app.py`
**Path:** `wsgi_app.py`
**File Doc:** *WSGI entry point for LazyOwnInfiniteStorage web server.*
**Functions:**
- `get_wsgi_app` (line 7) `def get_wsgi_app()` - *Factory function returning a gunicorn-compatible Flask application.*
### SH (1 files)
#### `install.sh`
**Path:** `install.sh`
**File Doc:** *Verificar si Python está instalado*
*No symbols extracted*