threadline-review 0.2.0b1__tar.gz

threadline_review-0.2.0b1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Threadline 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.

threadline_review-0.2.0b1/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: threadline-review
+Version: 0.2.0b1
+Summary: Visual, source-backed review of Python workflows before execution
+Author: Threadline contributors
+License: MIT License
+        
+        Copyright (c) 2026 Threadline 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.
+        
+Project-URL: Homepage, https://github.com/Raman369AI/threadline
+Project-URL: Documentation, https://github.com/Raman369AI/threadline/tree/main/docs
+Project-URL: Repository, https://github.com/Raman369AI/threadline
+Project-URL: Issues, https://github.com/Raman369AI/threadline/issues
+Keywords: python,static-analysis,code-review,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: browser-test
+Requires-Dist: websocket-client<2,>=1.7; extra == "browser-test"
+Requires-Dist: selenium<5,>=4.35; extra == "browser-test"
+Dynamic: license-file
+
+# Threadline
+
+[Documentation](docs/README.md) · [Getting started](docs/USING_THREADLINE.md) · [Capabilities](docs/CAPABILITIES.md) · [Contributing](CONTRIBUTING.md)
+
+Threadline is a visual Python code reviewer for understanding a workflow before running it.
+
+Select any function or method. Threadline shows its inputs and outputs, local control flow, calls into other files, return destinations, effects, and unresolved targets. Select any step to inspect the exact original source while keeping the surrounding workflow visible.
+
+Threadline parses source. It does not import or execute the project being reviewed.
+
+## What you see
+
+```text
+Request
+  │ request fields
+  ▼
+Validate
+  ├─ invalid → early return
+  │ validated items + coupon
+  ▼
+Calculate total
+  │ subtotal − discount + tax
+  ▼
+Save order
+  │ persisted order
+  ▼
+Response
+```
+
+The interface provides three levels without sending you to another page:
+
+- **Workflow:** the flow starting from the selected method.
+- **Focused step:** branches, calls, transformations, effects, and returns at that point.
+- **Source:** the exact code supporting the selected operation.
+
+Calls stay nested under their call site. Workflow pages load progressively, and branch bodies load when expanded. Loops appear once, recursion is marked, and possible or unknown targets remain visibly uncertain.
+
+## Requirements
+
+- Python 3.12 or later
+- A local directory containing Python source
+- A modern browser
+
+The target project does not need to be installed and its dependencies do not need to be available.
+
+## Install
+
+From a source checkout:
+
+```bash
+git clone https://github.com/Raman369AI/threadline.git
+cd threadline
+python3 -m venv .venv
+.venv/bin/python -m pip install .
+```
+
+If you have a locally built or shared release wheel:
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install threadline_review-0.2.0b1-py3-none-any.whl
+```
+
+## Review a repository
+
+```bash
+.venv/bin/threadline review /path/to/python-repository
+```
+
+Threadline prints and opens a local URL, normally <http://127.0.0.1:4173/>. Use `--port 4180` if that port is occupied.
+
+In the browser:
+
+1. Use **Endpoints**, **Commands & tasks**, or **Modules & methods**, or search across all three.
+2. One click opens its workflow, local logic, and original source.
+3. Follow source-linked calls across files from that selected method.
+4. Expand branches or calls in place; use **Back to caller** to resume where you left off.
+5. Open **Coverage** to see parse failures, excluded paths, and unmodeled call syntax.
+
+Try the bundled example:
+
+```bash
+.venv/bin/threadline review example
+```
+
+## Review a Git change
+
+Run Threadline from the working tree and provide the Git baseline:
+
+```bash
+.venv/bin/threadline review /path/to/git-repository --base HEAD
+```
+
+The **Changes** view distinguishes modified methods, previous and deleted methods, current source-linked callers, historical baseline callers, and possible impact. Choose **Compare before / after** to read both retained versions together. Threadline reads Git objects without checking out or executing either version.
+
+## Structured output
+
+The browser is the primary interface. JSON commands are available for scripts and CI:
+
+```bash
+threadline inspect /path/to/repository --query create_order
+threadline inspect /path/to/repository --entrypoint package.module:create_order
+threadline changes /path/to/repository --base HEAD
+```
+
+Use `--source-root path` to select an application source directory. Repeat `--exclude path` for generated, vendored, or irrelevant directories.
+
+## What static analysis can establish
+
+Threadline labels call relationships according to their evidence:
+
+- **Supported:** the source resolves one local target.
+- **Possible:** the source identifies one or more candidates but runtime dispatch remains uncertain.
+- **External:** the target belongs outside the analyzed source.
+- **Unknown:** the source does not identify a target.
+
+These labels describe source structure. They do not represent an observed execution or prove that the code is correct.
+
+See the [capability matrix](docs/CAPABILITIES.md), [usage guide](docs/USING_THREADLINE.md), and [validation record](docs/VALIDATION.md) for details.
+
+## Documentation
+
+Start with the **[documentation hub](docs/README.md)** for installation, everyday review, analysis limits, and project maintenance.
+
+| I want to… | Read |
+| --- | --- |
+| Review a repository or Git change | [Usage guide](docs/USING_THREADLINE.md) |
+| Understand supported syntax and uncertain calls | [Capability matrix](docs/CAPABILITIES.md) |
+| Check test results and platform coverage | [Validation record](docs/VALIDATION.md) |
+| Understand keyboard access and browser checks | [Accessibility](docs/ACCESSIBILITY.md) |
+| Check resource limits for a larger repository | [Performance and resource budgets](docs/PERFORMANCE.md) |
+| Publish a package release | [PyPI publishing guide](docs/PUBLISHING.md) |
+| Report a vulnerability privately | [Security policy](SECURITY.md) |
+
+## Validation
+
+The self-contained suite covers source non-execution, exact statement and call accounting, branches, exceptions, loops, recursion, cross-file calls, snapshot evidence, Git changes, HTTP restrictions, packaging, and browser behavior.
+
+A separate acceptance corpus tests pinned versions of [Flask](https://github.com/pallets/flask), [Requests](https://github.com/psf/requests), [FastAPI](https://github.com/fastapi/fastapi), [Celery](https://github.com/celery/celery), [Django](https://github.com/django/django), [OpenTelemetry](https://github.com/open-telemetry/opentelemetry-python), and [Pants](https://github.com/pantsbuild/pants). See [public repository validation](docs/ONLINE_VALIDATION.md).
+
+```bash
+python3 -m unittest discover -v
+node --check threadline/static/app.js
+node --check threadline/static/workflow.js
+python3 tests/browser_smoke.py
+python3 tests/online_repo_smoke.py --report artifacts/online-validation.json
+python3 -m pip wheel . --no-deps -w dist
+python3 tests/release_smoke.py dist/*.whl
+```
+
+## Project status
+
+Threadline is a developer beta. The standalone application and wheel are usable now. The expanded corpus, performance budgets, Linux/macOS matrix, native Safari, accessibility checks, and clean-wheel installs pass. The maintainer owns the three first-time reviewer sessions and final release sign-off. See the [release checklist](docs/RELEASE_CHECKLIST.md) and [resource budgets](docs/PERFORMANCE.md).
+
+See [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), [CHANGELOG.md](CHANGELOG.md), and the [MIT License](LICENSE).

threadline_review-0.2.0b1/README.md

@@ -0,0 +1,155 @@
+# Threadline
+
+[Documentation](docs/README.md) · [Getting started](docs/USING_THREADLINE.md) · [Capabilities](docs/CAPABILITIES.md) · [Contributing](CONTRIBUTING.md)
+
+Threadline is a visual Python code reviewer for understanding a workflow before running it.
+
+Select any function or method. Threadline shows its inputs and outputs, local control flow, calls into other files, return destinations, effects, and unresolved targets. Select any step to inspect the exact original source while keeping the surrounding workflow visible.
+
+Threadline parses source. It does not import or execute the project being reviewed.
+
+## What you see
+
+```text
+Request
+  │ request fields
+  ▼
+Validate
+  ├─ invalid → early return
+  │ validated items + coupon
+  ▼
+Calculate total
+  │ subtotal − discount + tax
+  ▼
+Save order
+  │ persisted order
+  ▼
+Response
+```
+
+The interface provides three levels without sending you to another page:
+
+- **Workflow:** the flow starting from the selected method.
+- **Focused step:** branches, calls, transformations, effects, and returns at that point.
+- **Source:** the exact code supporting the selected operation.
+
+Calls stay nested under their call site. Workflow pages load progressively, and branch bodies load when expanded. Loops appear once, recursion is marked, and possible or unknown targets remain visibly uncertain.
+
+## Requirements
+
+- Python 3.12 or later
+- A local directory containing Python source
+- A modern browser
+
+The target project does not need to be installed and its dependencies do not need to be available.
+
+## Install
+
+From a source checkout:
+
+```bash
+git clone https://github.com/Raman369AI/threadline.git
+cd threadline
+python3 -m venv .venv
+.venv/bin/python -m pip install .
+```
+
+If you have a locally built or shared release wheel:
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install threadline_review-0.2.0b1-py3-none-any.whl
+```
+
+## Review a repository
+
+```bash
+.venv/bin/threadline review /path/to/python-repository
+```
+
+Threadline prints and opens a local URL, normally <http://127.0.0.1:4173/>. Use `--port 4180` if that port is occupied.
+
+In the browser:
+
+1. Use **Endpoints**, **Commands & tasks**, or **Modules & methods**, or search across all three.
+2. One click opens its workflow, local logic, and original source.
+3. Follow source-linked calls across files from that selected method.
+4. Expand branches or calls in place; use **Back to caller** to resume where you left off.
+5. Open **Coverage** to see parse failures, excluded paths, and unmodeled call syntax.
+
+Try the bundled example:
+
+```bash
+.venv/bin/threadline review example
+```
+
+## Review a Git change
+
+Run Threadline from the working tree and provide the Git baseline:
+
+```bash
+.venv/bin/threadline review /path/to/git-repository --base HEAD
+```
+
+The **Changes** view distinguishes modified methods, previous and deleted methods, current source-linked callers, historical baseline callers, and possible impact. Choose **Compare before / after** to read both retained versions together. Threadline reads Git objects without checking out or executing either version.
+
+## Structured output
+
+The browser is the primary interface. JSON commands are available for scripts and CI:
+
+```bash
+threadline inspect /path/to/repository --query create_order
+threadline inspect /path/to/repository --entrypoint package.module:create_order
+threadline changes /path/to/repository --base HEAD
+```
+
+Use `--source-root path` to select an application source directory. Repeat `--exclude path` for generated, vendored, or irrelevant directories.
+
+## What static analysis can establish
+
+Threadline labels call relationships according to their evidence:
+
+- **Supported:** the source resolves one local target.
+- **Possible:** the source identifies one or more candidates but runtime dispatch remains uncertain.
+- **External:** the target belongs outside the analyzed source.
+- **Unknown:** the source does not identify a target.
+
+These labels describe source structure. They do not represent an observed execution or prove that the code is correct.
+
+See the [capability matrix](docs/CAPABILITIES.md), [usage guide](docs/USING_THREADLINE.md), and [validation record](docs/VALIDATION.md) for details.
+
+## Documentation
+
+Start with the **[documentation hub](docs/README.md)** for installation, everyday review, analysis limits, and project maintenance.
+
+| I want to… | Read |
+| --- | --- |
+| Review a repository or Git change | [Usage guide](docs/USING_THREADLINE.md) |
+| Understand supported syntax and uncertain calls | [Capability matrix](docs/CAPABILITIES.md) |
+| Check test results and platform coverage | [Validation record](docs/VALIDATION.md) |
+| Understand keyboard access and browser checks | [Accessibility](docs/ACCESSIBILITY.md) |
+| Check resource limits for a larger repository | [Performance and resource budgets](docs/PERFORMANCE.md) |
+| Publish a package release | [PyPI publishing guide](docs/PUBLISHING.md) |
+| Report a vulnerability privately | [Security policy](SECURITY.md) |
+
+## Validation
+
+The self-contained suite covers source non-execution, exact statement and call accounting, branches, exceptions, loops, recursion, cross-file calls, snapshot evidence, Git changes, HTTP restrictions, packaging, and browser behavior.
+
+A separate acceptance corpus tests pinned versions of [Flask](https://github.com/pallets/flask), [Requests](https://github.com/psf/requests), [FastAPI](https://github.com/fastapi/fastapi), [Celery](https://github.com/celery/celery), [Django](https://github.com/django/django), [OpenTelemetry](https://github.com/open-telemetry/opentelemetry-python), and [Pants](https://github.com/pantsbuild/pants). See [public repository validation](docs/ONLINE_VALIDATION.md).
+
+```bash
+python3 -m unittest discover -v
+node --check threadline/static/app.js
+node --check threadline/static/workflow.js
+python3 tests/browser_smoke.py
+python3 tests/online_repo_smoke.py --report artifacts/online-validation.json
+python3 -m pip wheel . --no-deps -w dist
+python3 tests/release_smoke.py dist/*.whl
+```
+
+## Project status
+
+Threadline is a developer beta. The standalone application and wheel are usable now. The expanded corpus, performance budgets, Linux/macOS matrix, native Safari, accessibility checks, and clean-wheel installs pass. The maintainer owns the three first-time reviewer sessions and final release sign-off. See the [release checklist](docs/RELEASE_CHECKLIST.md) and [resource budgets](docs/PERFORMANCE.md).
+
+See [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), [CHANGELOG.md](CHANGELOG.md), and the [MIT License](LICENSE).

threadline_review-0.2.0b1/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "threadline-review"
+version = "0.2.0b1"
+description = "Visual, source-backed review of Python workflows before execution"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {file = "LICENSE"}
+authors = [{name = "Threadline contributors"}]
+classifiers = ["Development Status :: 4 - Beta", "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License"]
+keywords = ["python", "static-analysis", "code-review", "visualization"]
+
+[project.urls]
+Homepage = "https://github.com/Raman369AI/threadline"
+Documentation = "https://github.com/Raman369AI/threadline/tree/main/docs"
+Repository = "https://github.com/Raman369AI/threadline"
+Issues = "https://github.com/Raman369AI/threadline/issues"
+
+[project.optional-dependencies]
+browser-test = ["websocket-client>=1.7,<2", "selenium>=4.35,<5"]
+
+[project.scripts]
+threadline = "threadline.cli:main"
+
+[tool.setuptools]
+include-package-data = true
+packages = ["threadline", "threadline.static"]
+
+[tool.setuptools.package-data]
+"threadline.static" = ["*.html", "*.js", "*.css"]

threadline_review-0.2.0b1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

threadline_review-0.2.0b1/threadline/__init__.py

@@ -0,0 +1,8 @@
+"""Threadline: source-backed Python workflow review."""
+
+__version__ = "0.2.0b1"
+
+from .analyzer import Analyzer, analyze
+from .service import SnapshotStore, ThreadlineError
+
+__all__ = ["Analyzer", "SnapshotStore", "ThreadlineError", "analyze", "__version__"]

threadline_review-0.2.0b1/threadline/__main__.py

@@ -0,0 +1,2 @@
+from .cli import main
+main()