iDeviceTail 0.1.0__tar.gz

idevicetail-0.1.0/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 iDeviceTail contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+NOTE: This project optionally invokes `pymobiledevice3` (https://github.com/doronz88/pymobiledevice3),
+which is licensed GPL-3.0. iDeviceTail calls it as a separate process via its public CLI and does not
+link or embed its code. Installing that dependency is the user's choice and subject to its own license.

idevicetail-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE README.md
+recursive-include desktop/idevicetail/web *.html *.js *.css
+recursive-include docs *.md
+recursive-include ios *.swift *.plist *.yml Package.swift README.md
+graft scripts
+global-exclude __pycache__ *.py[cod] *.sqlite *.sqlite-* .DS_Store
+prune data
+prune .venv

idevicetail-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: iDeviceTail
+Version: 0.1.0
+Summary: Wireless log collection from your own iOS/iPadOS devices — system logs via pymobiledevice3 + an app-log agent, in one live web viewer. No cable.
+Author: Rushabh Shah
+License: MIT
+Project-URL: Homepage, https://github.com/Rushabh5000/iDeviceTail
+Project-URL: Repository, https://github.com/Rushabh5000/iDeviceTail
+Project-URL: Documentation, https://github.com/Rushabh5000/iDeviceTail/tree/main/docs
+Project-URL: Issues, https://github.com/Rushabh5000/iDeviceTail/issues
+Keywords: ios,ipados,iphone,ipad,logs,syslog,console,oslog,os_log,logging,pymobiledevice3,wireless,developer-tools,debugging,crash-reports,sysdiagnose,bonjour
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4,>=3.9
+Requires-Dist: zeroconf>=0.132
+Requires-Dist: aiosqlite>=0.19
+Provides-Extra: device
+Requires-Dist: pymobiledevice3>=4.14; extra == "device"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# iDeviceTail — wireless iOS/iPadOS log collection
+
+[![CI](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml/badge.svg)](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10–3.13](https://img.shields.io/badge/python-3.10–3.13-3776AB.svg?logo=python&logoColor=white)](pyproject.toml)
+
+<!-- Add the PyPI badges after the first `v*` tag publishes the package:
+[![PyPI](https://img.shields.io/pypi/v/idevicetail.svg)](https://pypi.org/project/idevicetail/)
+[![Downloads](https://img.shields.io/pypi/dm/idevicetail.svg)](https://pypi.org/project/idevicetail/) -->
+
+
+Collect and view logs from **your own** iPhones/iPads over Wi‑Fi, with **no cable during normal
+operation**. One desktop app (Python, cross‑platform) fuses two capture engines into a single
+live viewer:
+
+| Engine | What it gets | Cable ever? | iOS setup | Works on |
+|--------|--------------|-------------|-----------|----------|
+| **A — Device engine** (`pymobiledevice3`) | Real **system logs** (all processes), crash reports, sysdiagnose | **One‑time USB pair + Trust**, then wireless | Enable Wi‑Fi sync + Developer Mode | macOS = full · Windows/Linux = full for iOS ≤ 17.3, partial (syslog only) for iOS 17.4+ over Wi‑Fi |
+| **B — Agent engine** (Swift app + SDK) | The **agent app's own logs** + logs of any app that links `IDeviceTailKit` | **Never** (cable only to sideload the app once on Windows) | Install the app, tap Start | Any stock iOS, no pairing, no Developer Mode |
+
+> **Read [`docs/FEASIBILITY.md`](docs/FEASIBILITY.md) first.** iOS does **not** give third‑party
+> software the system‑log firehose. Engine A uses Apple's *supported* device‑debug channel
+> (lockdown `syslog_relay` / `os_trace_relay`, the same one Console.app and `log stream` use) and
+> therefore inherits Apple's pairing + Developer Mode requirements. Engine B is 100% App‑sandbox
+> legal but only sees its own process. The tool ships both and merges them.
+
+> 📖 **Full step‑by‑step setup + run guide (phone *and* desktop): [`docs/GUIDE.md`](docs/GUIDE.md).**
+
+## Quick start
+
+**Windows:** double‑click **`start.bat`**. First run makes a venv, installs, launches the
+server and opens the web UI. That's the only "command".
+
+**macOS/Linux (or manual):**
+```bash
+python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
+pip install -e ".[device]"                        # from a checkout
+#   or:  pip install "idevicetail[device]"        # from PyPI
+python -m idevicetail serve                        # opens http://localhost:3017 in your browser
+```
+
+> **Use Python 3.10–3.13** (not 3.14 yet — `pymobiledevice3`'s C‑ext deps have no 3.14 wheels).
+> The app‑log agent (Engine B) works on any 3.10+.
+
+**Everything else is buttons in the browser** — no more commands:
+
+| In the UI | Does |
+|---|---|
+| device card → **▶ Start** / **os_trace** | begin/stop a wireless system‑log stream (Engine A) |
+| toolbar **Keyword filter + OK**, level/process/subsystem/source pickers | live filtering of a huge stream |
+| **⬇ Export view** | save the currently filtered lines |
+| **📂 Open file** | open / reveal / download the always‑on "real‑time file" (`data/sessions/realtime-*.log` + `.ndjson`) |
+| **🗑 Clear** / **Pause** / **follow** | manage the view |
+| device card → **Setup** | one‑time USB provisioning (Pair · Wi‑Fi sync · Developer Mode) without touching a terminal |
+| device card → **Crashes** / **Sysdiag** | pull crash reports / trigger a sysdiagnose |
+
+A CLI still exists for scripting (`idevicetail discover | stream | crash-pull | export …`) but you never need it for normal use.
+
+## Repository layout
+
+```
+iDeviceTail/
+├── docs/            Feasibility report, architecture, protocol, compatibility, setup, troubleshooting, test plan
+├── desktop/
+│   ├── idevicetail/   Python package: discovery, engines, normalizer, bus, store, aiohttp server, CLI
+│   │   └── web/     Static log‑viewer UI (no build step)
+│   └── tests/       pytest: parsing, framing, dedup, store
+├── ios/
+│   ├── IDeviceTailKit/     Swift Package: OSLogStore reader, Bonjour, framed TCP client, reconnect
+│   └── IDeviceTailAgent/   SwiftUI app that hosts the SDK (XcodeGen project)
+├── scripts/         setup / run / pairing helpers (PowerShell + sh)
+├── start.bat / stop.bat / hub.json   project-hub integration
+└── pyproject.toml
+```
+
+## Platform support
+
+```
+macOS:    Full      (Engine A wireless incl. iOS 17.4+ firehose via remoted; Engine B; wireless app install)
+Windows:  Partial   (Engine A: full ≤ iOS 17.3 over Wi-Fi, syslog-only for 17.4+ over Wi-Fi; Engine B full)
+Linux:    Partial   (same as Windows)
+```
+
+See [`docs/COMPATIBILITY.md`](docs/COMPATIBILITY.md) for the capability matrix.
+
+## License
+
+MIT (this project). Engine A shells out to **pymobiledevice3** (GPL‑3.0) as a separate process;
+it is an optional dependency you install yourself.

idevicetail-0.1.0/README.md

@@ -0,0 +1,89 @@
+# iDeviceTail — wireless iOS/iPadOS log collection
+
+[![CI](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml/badge.svg)](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10–3.13](https://img.shields.io/badge/python-3.10–3.13-3776AB.svg?logo=python&logoColor=white)](pyproject.toml)
+
+<!-- Add the PyPI badges after the first `v*` tag publishes the package:
+[![PyPI](https://img.shields.io/pypi/v/idevicetail.svg)](https://pypi.org/project/idevicetail/)
+[![Downloads](https://img.shields.io/pypi/dm/idevicetail.svg)](https://pypi.org/project/idevicetail/) -->
+
+
+Collect and view logs from **your own** iPhones/iPads over Wi‑Fi, with **no cable during normal
+operation**. One desktop app (Python, cross‑platform) fuses two capture engines into a single
+live viewer:
+
+| Engine | What it gets | Cable ever? | iOS setup | Works on |
+|--------|--------------|-------------|-----------|----------|
+| **A — Device engine** (`pymobiledevice3`) | Real **system logs** (all processes), crash reports, sysdiagnose | **One‑time USB pair + Trust**, then wireless | Enable Wi‑Fi sync + Developer Mode | macOS = full · Windows/Linux = full for iOS ≤ 17.3, partial (syslog only) for iOS 17.4+ over Wi‑Fi |
+| **B — Agent engine** (Swift app + SDK) | The **agent app's own logs** + logs of any app that links `IDeviceTailKit` | **Never** (cable only to sideload the app once on Windows) | Install the app, tap Start | Any stock iOS, no pairing, no Developer Mode |
+
+> **Read [`docs/FEASIBILITY.md`](docs/FEASIBILITY.md) first.** iOS does **not** give third‑party
+> software the system‑log firehose. Engine A uses Apple's *supported* device‑debug channel
+> (lockdown `syslog_relay` / `os_trace_relay`, the same one Console.app and `log stream` use) and
+> therefore inherits Apple's pairing + Developer Mode requirements. Engine B is 100% App‑sandbox
+> legal but only sees its own process. The tool ships both and merges them.
+
+> 📖 **Full step‑by‑step setup + run guide (phone *and* desktop): [`docs/GUIDE.md`](docs/GUIDE.md).**
+
+## Quick start
+
+**Windows:** double‑click **`start.bat`**. First run makes a venv, installs, launches the
+server and opens the web UI. That's the only "command".
+
+**macOS/Linux (or manual):**
+```bash
+python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
+pip install -e ".[device]"                        # from a checkout
+#   or:  pip install "idevicetail[device]"        # from PyPI
+python -m idevicetail serve                        # opens http://localhost:3017 in your browser
+```
+
+> **Use Python 3.10–3.13** (not 3.14 yet — `pymobiledevice3`'s C‑ext deps have no 3.14 wheels).
+> The app‑log agent (Engine B) works on any 3.10+.
+
+**Everything else is buttons in the browser** — no more commands:
+
+| In the UI | Does |
+|---|---|
+| device card → **▶ Start** / **os_trace** | begin/stop a wireless system‑log stream (Engine A) |
+| toolbar **Keyword filter + OK**, level/process/subsystem/source pickers | live filtering of a huge stream |
+| **⬇ Export view** | save the currently filtered lines |
+| **📂 Open file** | open / reveal / download the always‑on "real‑time file" (`data/sessions/realtime-*.log` + `.ndjson`) |
+| **🗑 Clear** / **Pause** / **follow** | manage the view |
+| device card → **Setup** | one‑time USB provisioning (Pair · Wi‑Fi sync · Developer Mode) without touching a terminal |
+| device card → **Crashes** / **Sysdiag** | pull crash reports / trigger a sysdiagnose |
+
+A CLI still exists for scripting (`idevicetail discover | stream | crash-pull | export …`) but you never need it for normal use.
+
+## Repository layout
+
+```
+iDeviceTail/
+├── docs/            Feasibility report, architecture, protocol, compatibility, setup, troubleshooting, test plan
+├── desktop/
+│   ├── idevicetail/   Python package: discovery, engines, normalizer, bus, store, aiohttp server, CLI
+│   │   └── web/     Static log‑viewer UI (no build step)
+│   └── tests/       pytest: parsing, framing, dedup, store
+├── ios/
+│   ├── IDeviceTailKit/     Swift Package: OSLogStore reader, Bonjour, framed TCP client, reconnect
+│   └── IDeviceTailAgent/   SwiftUI app that hosts the SDK (XcodeGen project)
+├── scripts/         setup / run / pairing helpers (PowerShell + sh)
+├── start.bat / stop.bat / hub.json   project-hub integration
+└── pyproject.toml
+```
+
+## Platform support
+
+```
+macOS:    Full      (Engine A wireless incl. iOS 17.4+ firehose via remoted; Engine B; wireless app install)
+Windows:  Partial   (Engine A: full ≤ iOS 17.3 over Wi-Fi, syslog-only for 17.4+ over Wi-Fi; Engine B full)
+Linux:    Partial   (same as Windows)
+```
+
+See [`docs/COMPATIBILITY.md`](docs/COMPATIBILITY.md) for the capability matrix.
+
+## License
+
+MIT (this project). Engine A shells out to **pymobiledevice3** (GPL‑3.0) as a separate process;
+it is an optional dependency you install yourself.

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: iDeviceTail
+Version: 0.1.0
+Summary: Wireless log collection from your own iOS/iPadOS devices — system logs via pymobiledevice3 + an app-log agent, in one live web viewer. No cable.
+Author: Rushabh Shah
+License: MIT
+Project-URL: Homepage, https://github.com/Rushabh5000/iDeviceTail
+Project-URL: Repository, https://github.com/Rushabh5000/iDeviceTail
+Project-URL: Documentation, https://github.com/Rushabh5000/iDeviceTail/tree/main/docs
+Project-URL: Issues, https://github.com/Rushabh5000/iDeviceTail/issues
+Keywords: ios,ipados,iphone,ipad,logs,syslog,console,oslog,os_log,logging,pymobiledevice3,wireless,developer-tools,debugging,crash-reports,sysdiagnose,bonjour
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4,>=3.9
+Requires-Dist: zeroconf>=0.132
+Requires-Dist: aiosqlite>=0.19
+Provides-Extra: device
+Requires-Dist: pymobiledevice3>=4.14; extra == "device"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: build>=1; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Dynamic: license-file
+
+# iDeviceTail — wireless iOS/iPadOS log collection
+
+[![CI](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml/badge.svg)](https://github.com/Rushabh5000/iDeviceTail/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10–3.13](https://img.shields.io/badge/python-3.10–3.13-3776AB.svg?logo=python&logoColor=white)](pyproject.toml)
+
+<!-- Add the PyPI badges after the first `v*` tag publishes the package:
+[![PyPI](https://img.shields.io/pypi/v/idevicetail.svg)](https://pypi.org/project/idevicetail/)
+[![Downloads](https://img.shields.io/pypi/dm/idevicetail.svg)](https://pypi.org/project/idevicetail/) -->
+
+
+Collect and view logs from **your own** iPhones/iPads over Wi‑Fi, with **no cable during normal
+operation**. One desktop app (Python, cross‑platform) fuses two capture engines into a single
+live viewer:
+
+| Engine | What it gets | Cable ever? | iOS setup | Works on |
+|--------|--------------|-------------|-----------|----------|
+| **A — Device engine** (`pymobiledevice3`) | Real **system logs** (all processes), crash reports, sysdiagnose | **One‑time USB pair + Trust**, then wireless | Enable Wi‑Fi sync + Developer Mode | macOS = full · Windows/Linux = full for iOS ≤ 17.3, partial (syslog only) for iOS 17.4+ over Wi‑Fi |
+| **B — Agent engine** (Swift app + SDK) | The **agent app's own logs** + logs of any app that links `IDeviceTailKit` | **Never** (cable only to sideload the app once on Windows) | Install the app, tap Start | Any stock iOS, no pairing, no Developer Mode |
+
+> **Read [`docs/FEASIBILITY.md`](docs/FEASIBILITY.md) first.** iOS does **not** give third‑party
+> software the system‑log firehose. Engine A uses Apple's *supported* device‑debug channel
+> (lockdown `syslog_relay` / `os_trace_relay`, the same one Console.app and `log stream` use) and
+> therefore inherits Apple's pairing + Developer Mode requirements. Engine B is 100% App‑sandbox
+> legal but only sees its own process. The tool ships both and merges them.
+
+> 📖 **Full step‑by‑step setup + run guide (phone *and* desktop): [`docs/GUIDE.md`](docs/GUIDE.md).**
+
+## Quick start
+
+**Windows:** double‑click **`start.bat`**. First run makes a venv, installs, launches the
+server and opens the web UI. That's the only "command".
+
+**macOS/Linux (or manual):**
+```bash
+python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
+pip install -e ".[device]"                        # from a checkout
+#   or:  pip install "idevicetail[device]"        # from PyPI
+python -m idevicetail serve                        # opens http://localhost:3017 in your browser
+```
+
+> **Use Python 3.10–3.13** (not 3.14 yet — `pymobiledevice3`'s C‑ext deps have no 3.14 wheels).
+> The app‑log agent (Engine B) works on any 3.10+.
+
+**Everything else is buttons in the browser** — no more commands:
+
+| In the UI | Does |
+|---|---|
+| device card → **▶ Start** / **os_trace** | begin/stop a wireless system‑log stream (Engine A) |
+| toolbar **Keyword filter + OK**, level/process/subsystem/source pickers | live filtering of a huge stream |
+| **⬇ Export view** | save the currently filtered lines |
+| **📂 Open file** | open / reveal / download the always‑on "real‑time file" (`data/sessions/realtime-*.log` + `.ndjson`) |
+| **🗑 Clear** / **Pause** / **follow** | manage the view |
+| device card → **Setup** | one‑time USB provisioning (Pair · Wi‑Fi sync · Developer Mode) without touching a terminal |
+| device card → **Crashes** / **Sysdiag** | pull crash reports / trigger a sysdiagnose |
+
+A CLI still exists for scripting (`idevicetail discover | stream | crash-pull | export …`) but you never need it for normal use.
+
+## Repository layout
+
+```
+iDeviceTail/
+├── docs/            Feasibility report, architecture, protocol, compatibility, setup, troubleshooting, test plan
+├── desktop/
+│   ├── idevicetail/   Python package: discovery, engines, normalizer, bus, store, aiohttp server, CLI
+│   │   └── web/     Static log‑viewer UI (no build step)
+│   └── tests/       pytest: parsing, framing, dedup, store
+├── ios/
+│   ├── IDeviceTailKit/     Swift Package: OSLogStore reader, Bonjour, framed TCP client, reconnect
+│   └── IDeviceTailAgent/   SwiftUI app that hosts the SDK (XcodeGen project)
+├── scripts/         setup / run / pairing helpers (PowerShell + sh)
+├── start.bat / stop.bat / hub.json   project-hub integration
+└── pyproject.toml
+```
+
+## Platform support
+
+```
+macOS:    Full      (Engine A wireless incl. iOS 17.4+ firehose via remoted; Engine B; wireless app install)
+Windows:  Partial   (Engine A: full ≤ iOS 17.3 over Wi-Fi, syslog-only for 17.4+ over Wi-Fi; Engine B full)
+Linux:    Partial   (same as Windows)
+```
+
+See [`docs/COMPATIBILITY.md`](docs/COMPATIBILITY.md) for the capability matrix.
+
+## License
+
+MIT (this project). Engine A shells out to **pymobiledevice3** (GPL‑3.0) as a separate process;
+it is an optional dependency you install yourself.

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/SOURCES.txt

@@ -0,0 +1,57 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+desktop/iDeviceTail.egg-info/PKG-INFO
+desktop/iDeviceTail.egg-info/SOURCES.txt
+desktop/iDeviceTail.egg-info/dependency_links.txt
+desktop/iDeviceTail.egg-info/entry_points.txt
+desktop/iDeviceTail.egg-info/requires.txt
+desktop/iDeviceTail.egg-info/top_level.txt
+desktop/idevicetail/__init__.py
+desktop/idevicetail/__main__.py
+desktop/idevicetail/bus.py
+desktop/idevicetail/cli.py
+desktop/idevicetail/config.py
+desktop/idevicetail/device_names.py
+desktop/idevicetail/discovery.py
+desktop/idevicetail/engine_agent.py
+desktop/idevicetail/engine_device.py
+desktop/idevicetail/exporter.py
+desktop/idevicetail/filesink.py
+desktop/idevicetail/manager.py
+desktop/idevicetail/models.py
+desktop/idevicetail/normalize.py
+desktop/idevicetail/server.py
+desktop/idevicetail/store.py
+desktop/idevicetail/web/app.js
+desktop/idevicetail/web/index.html
+desktop/idevicetail/web/styles.css
+docs/ARCHITECTURE.md
+docs/COMPATIBILITY.md
+docs/FEASIBILITY.md
+docs/GUIDE.md
+docs/PROTOCOL.md
+docs/SETUP-DESKTOP.md
+docs/SETUP-iOS.md
+docs/TESTPLAN.md
+docs/TROUBLESHOOTING.md
+ios/README.md
+ios/IDeviceTailAgent/project.yml
+ios/IDeviceTailAgent/Sources/AgentModel.swift
+ios/IDeviceTailAgent/Sources/ContentView.swift
+ios/IDeviceTailAgent/Sources/IDeviceTailAgentApp.swift
+ios/IDeviceTailAgent/Sources/Info.plist
+ios/IDeviceTailKit/Package.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/FrameCodec.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/HostBrowser.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/LogForwarder.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/LogRecord.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/LogStreamClient.swift
+ios/IDeviceTailKit/Sources/IDeviceTailKit/OSLogStoreReader.swift
+ios/IDeviceTailKit/Tests/IDeviceTailKitTests/FrameCodecTests.swift
+ios/IDeviceTailKit/Tests/IDeviceTailKitTests/LogRecordTests.swift
+scripts/provision-device.ps1
+scripts/run.ps1
+scripts/setup-desktop.ps1
+scripts/setup-desktop.sh

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+idevicetail = idevicetail.cli:main

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/requires.txt

@@ -0,0 +1,13 @@
+aiohttp<4,>=3.9
+zeroconf>=0.132
+aiosqlite>=0.19
+
+[dev]
+pytest>=8
+pytest-asyncio>=0.23
+ruff>=0.5
+build>=1
+twine>=5
+
+[device]
+pymobiledevice3>=4.14

idevicetail-0.1.0/desktop/iDeviceTail.egg-info/top_level.txt

@@ -0,0 +1 @@
+idevicetail

idevicetail-0.1.0/desktop/idevicetail/__init__.py

@@ -0,0 +1,15 @@
+"""iDeviceTail — wireless iOS/iPadOS log collection.
+
+Two capture engines feed one normalized log bus:
+
+* ``engine_device``  — real system logs / crash reports / sysdiagnose via the
+  ``pymobiledevice3`` CLI over Wi-Fi (requires a one-time USB pairing + Trust and,
+  on iOS 16+, Developer Mode).
+* ``engine_agent``   — app-level logs streamed by the bundled Swift agent app
+  (``IDeviceTailKit``) over a framed TCP protocol. No pairing, no cable, no
+  Developer Mode; limited to the agent's own process by the iOS sandbox.
+
+See ``docs/FEASIBILITY.md`` for exactly what iOS does and does not allow.
+"""
+
+__version__ = "0.1.0"

idevicetail-0.1.0/desktop/idevicetail/__main__.py

@@ -0,0 +1,4 @@
+from idevicetail.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

idevicetail-0.1.0/desktop/idevicetail/bus.py

@@ -0,0 +1,89 @@
+"""In-process log fan-out.
+
+Every :class:`~idevicetail.models.LogRecord` from either engine is published here.
+Consumers (the WebSocket server, the SQLite writer, exporters) each ``subscribe``
+and get an independent asyncio queue.
+
+Backpressure policy: each subscriber queue is bounded. If a consumer falls
+behind, the *oldest* item in that consumer's queue is dropped to make room for
+the newest — a slow browser tab can never stall the capture pipeline. Dropped
+counts are tracked so the UI can show "N lines dropped".
+"""
+
+from __future__ import annotations
+
+import asyncio
+from collections import deque
+from typing import Any
+
+from .models import LogRecord
+
+
+class Subscription:
+    __slots__ = ("queue", "dropped", "_bus")
+
+    def __init__(self, bus: "LogBus", maxsize: int) -> None:
+        self.queue: asyncio.Queue[dict[str, Any]] = asyncio.Queue(maxsize=maxsize)
+        self.dropped = 0
+        self._bus = bus
+
+    async def get(self) -> dict[str, Any]:
+        return await self.queue.get()
+
+    def close(self) -> None:
+        self._bus._subs.discard(self)
+
+
+class LogBus:
+    def __init__(self, ring_size: int = 200_000) -> None:
+        self._subs: set[Subscription] = set()
+        self._ring: deque[dict[str, Any]] = deque(maxlen=ring_size)
+        self._seq = 0
+        self.total_published = 0
+
+    # -- producers ---------------------------------------------------------
+    def publish(self, rec: LogRecord) -> None:
+        self._seq += 1
+        rec.seq = self._seq
+        wire = rec.to_wire()
+        self._ring.append(wire)
+        self.total_published += 1
+        for sub in list(self._subs):
+            _offer(sub, wire)
+
+    def publish_many(self, recs: list[LogRecord]) -> None:
+        for r in recs:
+            self.publish(r)
+
+    # -- consumers -------------------------------------------------------
+    def subscribe(self, maxsize: int = 20_000) -> Subscription:
+        sub = Subscription(self, maxsize)
+        self._subs.add(sub)
+        return sub
+
+    def snapshot(self, limit: int | None = None) -> list[dict[str, Any]]:
+        if limit is None or limit >= len(self._ring):
+            return list(self._ring)
+        return list(self._ring)[-limit:]
+
+    @property
+    def seq(self) -> int:
+        return self._seq
+
+
+def _offer(sub: Subscription, wire: dict[str, Any]) -> None:
+    try:
+        sub.queue.put_nowait(wire)
+        return
+    except asyncio.QueueFull:
+        pass
+    # Drop oldest, retry once.
+    try:
+        sub.queue.get_nowait()
+        sub.dropped += 1
+    except asyncio.QueueEmpty:  # pragma: no cover - race
+        pass
+    try:
+        sub.queue.put_nowait(wire)
+    except asyncio.QueueFull:  # pragma: no cover - consumer is fully wedged
+        sub.dropped += 1