stacklatch 0.1.0a1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- stacklatch-0.1.0a1/.github/ISSUE_TEMPLATE/bug_report.yml +15 -0
- stacklatch-0.1.0a1/.github/ISSUE_TEMPLATE/feature_request.yml +13 -0
- stacklatch-0.1.0a1/.github/PULL_REQUEST_TEMPLATE.md +9 -0
- stacklatch-0.1.0a1/AUDIT.md +7 -0
- stacklatch-0.1.0a1/CHANGELOG.md +9 -0
- stacklatch-0.1.0a1/CODE_OF_CONDUCT.md +3 -0
- stacklatch-0.1.0a1/CONTRIBUTING.md +3 -0
- stacklatch-0.1.0a1/FINAL_RELEASE_CHECKLIST.md +12 -0
- stacklatch-0.1.0a1/FIRST_TIME_VALIDATION.md +14 -0
- stacklatch-0.1.0a1/LICENSE +21 -0
- stacklatch-0.1.0a1/LICENSE_INVENTORY.md +12 -0
- stacklatch-0.1.0a1/MANIFEST.in +11 -0
- stacklatch-0.1.0a1/PKG-INFO +70 -0
- stacklatch-0.1.0a1/README.md +56 -0
- stacklatch-0.1.0a1/RELEASE_NOTES.md +5 -0
- stacklatch-0.1.0a1/ROADMAP.md +8 -0
- stacklatch-0.1.0a1/SECURITY.md +5 -0
- stacklatch-0.1.0a1/SECURITY_REPORT.md +20 -0
- stacklatch-0.1.0a1/docs/EXTRACTION_REVIEW.md +17 -0
- stacklatch-0.1.0a1/docs/LAUNCH_MATERIALS.md +43 -0
- stacklatch-0.1.0a1/docs/SOURCE_MAP.csv +59 -0
- stacklatch-0.1.0a1/examples/README.md +35 -0
- stacklatch-0.1.0a1/examples/counter/LICENSE +21 -0
- stacklatch-0.1.0a1/examples/counter/pyproject.toml +3 -0
- stacklatch-0.1.0a1/examples/counter/src/counter.py +2 -0
- stacklatch-0.1.0a1/examples/normalizer/LICENSE +21 -0
- stacklatch-0.1.0a1/examples/normalizer/pyproject.toml +3 -0
- stacklatch-0.1.0a1/examples/normalizer/src/normalizer.py +2 -0
- stacklatch-0.1.0a1/examples/v21_real_acceptance.py +127 -0
- stacklatch-0.1.0a1/examples/v22_real_acceptance.py +143 -0
- stacklatch-0.1.0a1/examples/v31_slug_to_camel/cases.json +1 -0
- stacklatch-0.1.0a1/examples/v31_slug_to_camel/input-schema.json +1 -0
- stacklatch-0.1.0a1/examples/v31_slug_to_camel/intermediate-schema.json +1 -0
- stacklatch-0.1.0a1/examples/v31_slug_to_camel/output-schema.json +1 -0
- stacklatch-0.1.0a1/pyproject.toml +24 -0
- stacklatch-0.1.0a1/scripts/scan_release.py +70 -0
- stacklatch-0.1.0a1/setup.cfg +4 -0
- stacklatch-0.1.0a1/src/stacklatch/__init__.py +2 -0
- stacklatch-0.1.0a1/src/stacklatch/cli.py +76 -0
- stacklatch-0.1.0a1/src/stacklatch/core.py +386 -0
- stacklatch-0.1.0a1/src/stacklatch/v21.py +273 -0
- stacklatch-0.1.0a1/src/stacklatch/v22.py +483 -0
- stacklatch-0.1.0a1/src/stacklatch/v23.py +159 -0
- stacklatch-0.1.0a1/src/stacklatch/v24.py +199 -0
- stacklatch-0.1.0a1/src/stacklatch/v24_contract.py +188 -0
- stacklatch-0.1.0a1/src/stacklatch/v24_graph.py +338 -0
- stacklatch-0.1.0a1/src/stacklatch/v25.py +156 -0
- stacklatch-0.1.0a1/src/stacklatch/v31.py +380 -0
- stacklatch-0.1.0a1/src/stacklatch/v31_checkout.py +146 -0
- stacklatch-0.1.0a1/src/stacklatch/v31_graph.py +600 -0
- stacklatch-0.1.0a1/src/stacklatch/v31_graph_legacy.py +506 -0
- stacklatch-0.1.0a1/src/stacklatch.egg-info/SOURCES.txt +58 -0
- stacklatch-0.1.0a1/tests/test_cli_errors.py +30 -0
- stacklatch-0.1.0a1/tests/test_core.py +165 -0
- stacklatch-0.1.0a1/tests/test_v21.py +92 -0
- stacklatch-0.1.0a1/tests/test_v22.py +130 -0
- stacklatch-0.1.0a1/tests/test_v23.py +68 -0
- stacklatch-0.1.0a1/tests/test_v24.py +163 -0
- stacklatch-0.1.0a1/tests/test_v24_graph.py +55 -0
- stacklatch-0.1.0a1/tests/test_v25.py +64 -0
- stacklatch-0.1.0a1/tests/test_v31_core_smoke.py +16 -0
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
name: Bug report
|
|
2
|
+
description: Report a reproducible Core defect; use private reporting for security bugs.
|
|
3
|
+
body:
|
|
4
|
+
- type: textarea
|
|
5
|
+
id: reproduction
|
|
6
|
+
attributes:
|
|
7
|
+
label: Reproduction
|
|
8
|
+
description: Include command, Python version, pinned public commits, sanitized inputs, expected and actual results.
|
|
9
|
+
validations:
|
|
10
|
+
required: true
|
|
11
|
+
- type: textarea
|
|
12
|
+
id: evidence
|
|
13
|
+
attributes:
|
|
14
|
+
label: Evidence
|
|
15
|
+
description: Include sanitized report and Docker availability where relevant; never include credentials.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
name: Feature request
|
|
2
|
+
description: Propose a bounded improvement to StackLatch Core.
|
|
3
|
+
body:
|
|
4
|
+
- type: textarea
|
|
5
|
+
id: use_case
|
|
6
|
+
attributes:
|
|
7
|
+
label: Use case and proposed behavior
|
|
8
|
+
validations:
|
|
9
|
+
required: true
|
|
10
|
+
- type: textarea
|
|
11
|
+
id: risk
|
|
12
|
+
attributes:
|
|
13
|
+
label: Security and compatibility implications
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Final release-gate audit — private candidate, 2026-11-22
|
|
2
|
+
|
|
3
|
+
Source is private commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb`, matched at Git blob level for selected files. `docs/SOURCE_MAP.csv` and `docs/EXTRACTION_REVIEW.md` account for every source file and each extraction edit. Wheel and sdist use explicit Core-only packaging; neither includes commercial modules or private Git history. `SECURITY_REPORT.md`, `LICENSE_INVENTORY.md` and `FINAL_RELEASE_CHECKLIST.md` contain the detailed gate.
|
|
4
|
+
|
|
5
|
+
Linux Python 3.12: selected public Core unit tests **82 passed, 1 skipped** (bubblewrap user namespaces disallowed), with two warnings. The documented real pinned `plan` fetched two commits and selected one candidate, `verified: false`. The first proposed quick-start goal abstained and was replaced with the tested goal. Wheel and source distribution were installed in clean virtual environments; `FIRST_TIME_VALIDATION.md` records commands and outputs. Docker executable absent: no fresh real-repository integration verification, no Docker security acceptance or generated verified prototype. No full commercial-private regression suite claimed.
|
|
6
|
+
|
|
7
|
+
This is **not yet a validated public alpha**. Required before publication: fresh pinned example verification on a suitable restricted Docker host, Docker image/isolation review, contributor rights confirmation for MIT publication, and explicit owner authorization. The suggested separate public repository is `salam33333/stacklatch-core` with a fresh first commit containing this reviewed source only; keep StackLatch Cloud private. No branch, visibility, PyPI or website publication changed.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.0a1 — private release candidate, 2026-11-22
|
|
4
|
+
|
|
5
|
+
- Prepared a standalone, explicitly packaged Core export from private commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb`, with a source map and reviewed extraction edits.
|
|
6
|
+
- Kept bounded repository inspection, AST capability and interface analysis, compatibility selection, planning, and restricted verification.
|
|
7
|
+
- Added a Core-only `plan`/`verify` CLI; removed the optional paid API planner and sanitized inherited Git settings from the export.
|
|
8
|
+
- Excluded website, authentication, billing, commercial reports, private evaluation files and Git metadata.
|
|
9
|
+
- Public repository creation and package publication remain pending owner authorization.
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
# Code of Conduct
|
|
2
|
+
|
|
3
|
+
Be respectful and constructive. Harassment, discrimination, threats, and publication of private information are unacceptable. Maintainers may remove harmful content or restrict participation. Report conduct concerns privately to the repository owner through GitHub; avoid posting personal details in public issues. Maintainers will review reports confidentially and respond proportionately.
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
# Contributing
|
|
2
|
+
|
|
3
|
+
This alpha candidate is not yet public. When released, open an issue with a minimal reproducible example and pinned public commits before proposing changes. Use Python 3.12+, install `pytest` in a development environment, run `python -m pytest -q`, and run Docker acceptance on an authorized host. Do not include tokens, private repositories, third-party source copies, personal data, or claims of verification without an actual report. Changes to execution isolation require an explicit security review. Contributions use the MIT license. See the pull request template.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Final publication gate — do not publish automatically
|
|
2
|
+
|
|
3
|
+
- [x] Identify source commit and verify selected source blobs against private GitHub commit.
|
|
4
|
+
- [x] Map every exported file and document extraction edits.
|
|
5
|
+
- [x] Build wheel and sdist, inspect contents and calculate checksums.
|
|
6
|
+
- [x] Run offline credential/path/entropy scan of source and distribution members; manually review findings.
|
|
7
|
+
- [x] Install and test CLI in fresh Python environments; run the pinned planning command.
|
|
8
|
+
- [ ] On an authorized restricted Docker host, run V3.1 verify and included V2.1/V2.2 pinned public examples; save new reports, false-case results and archive hashes.
|
|
9
|
+
- [ ] Review Docker image digest, SBOM and daemon isolation on that host.
|
|
10
|
+
- [ ] Owner/contributors confirm licensing rights and final complete MIT notice for every exported authored file.
|
|
11
|
+
- [ ] Recheck PyPI package name availability and README claims at publication time.
|
|
12
|
+
- [ ] Obtain explicit owner authorization before creating public repository, publishing PyPI package or posting launch copy.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# First-time user validation — 2026-11-22
|
|
2
|
+
|
|
3
|
+
Environment: Linux, Python 3.12.14. Three independently created `python3.12 -m venv` environments, with no StackLatch installed initially. No `STACKLATCH_GITHUB_TOKEN` was present; no private repository path was needed by any CLI invocation. GitHub public API and HTTPS Git were reachable. Docker executable was absent.
|
|
4
|
+
|
|
5
|
+
| Operation | Actual result |
|
|
6
|
+
| --- | --- |
|
|
7
|
+
| Install built wheel into clean venv using `pip install --no-index --no-deps dist/stacklatch-0.1.0a1-py3-none-any.whl` | Succeeded; installed CLI `stacklatch --help` returned `plan` and `verify`. |
|
|
8
|
+
| Install sdist into separate clean venv with default pip build isolation and publicly available build dependencies | Succeeded; `stacklatch --help` returned `plan` and `verify`. An additional network-free build succeeded after explicitly installing setuptools, wheel and packaging wheels into another clean venv; the first offline attempt without packaging correctly failed on a missing build-tool dependency. |
|
|
9
|
+
| README pinned `plan` in clean wheel and sdist environments | Both succeeded; selected `slugify` → `camelcase` with `verified: false`, `abstained: false`. This **does not** execute integration code. |
|
|
10
|
+
| README/example `verify` with real plan/cases and `--confirm` | On this host returned exit 1, `report.json` `verified: false`, explicit “Docker is required for restricted verification”; no `prototype.zip`. A fresh real integration success is not claimed. |
|
|
11
|
+
| Invalid non-GitHub HTTP source | Exit 1, explicit “Only public https://github.com/owner/repository URLs are accepted”; no plan produced. |
|
|
12
|
+
| Simulated Python 3.11 target via pip `--python-version 3.11` | Installation refused: project requires Python `>=3.12`. |
|
|
13
|
+
|
|
14
|
+
The CLI uses public GitHub network access for planning and requires the system `git` executable. Docker image retrieval may require registry network access on the future validation host; actual integration execution occurs with container network disabled. Windows/macOS and offline-public-source planning were not exercised.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 StackLatch contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# License inventory — candidate 0.1.0a1
|
|
2
|
+
|
|
3
|
+
| Component | License evidence | Distribution decision |
|
|
4
|
+
| --- | --- | --- |
|
|
5
|
+
| Exported StackLatch Python, tests, docs, local fixtures | Private source commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb` contained an MIT-labeled but abbreviated LICENSE; candidate uses the complete MIT permission, notice and disclaimer text. Fixture LICENSE copies are retained. | Intended MIT; owner must confirm rights for all contributions and approve final notices before public release. |
|
|
6
|
+
| Public GitHub repositories in examples | Only URL, commit, names, cases, interface evidence; **no third-party source** in wheel/sdist/clean archive. At the pinned commits, `bakhbk/slugify` and `okunishinishi/python-stringcase` expose MIT-like LICENSE files (Git blobs `b77bf2ab…` and `825618f6…`). | The references are not a redistribution grant. Review each pinned repository license before distributing any generated adapter containing its source. |
|
|
7
|
+
| Python standard library | Python runtime supplied by user; not bundled. | No runtime Python package dependencies. |
|
|
8
|
+
| `setuptools>=68` / `wheel` / transitive `packaging` | Build tools in isolated build environment; installed metadata: setuptools 84.2.1 MIT, wheel 0.48.0 MIT, packaging 26.3 `Apache-2.0 OR BSD-2-Clause`. None are vendored into candidate. | Build dependencies only; no third-party code copied into wheel. |
|
|
9
|
+
| `pytest` and its support packages | Development tests only; no development dependencies bundled in wheel/sdist. | Users may install separately under their respective notices; review installed versions when establishing CI. |
|
|
10
|
+
| Docker image `python:3.12-slim@sha256:…` | Referenced by digest, **not distributed**. Includes separate upstream Python, Debian and OS package licenses. | Must review image supply chain, SBOM and licenses on the Docker validation host. |
|
|
11
|
+
|
|
12
|
+
The existing source license's short final disclaimer was replaced by the standard MIT text in this candidate. This is an extraction change, not evidence of contributor authorization. The copyright line remains `Copyright (c) 2026 StackLatch contributors`. No contributor license agreement or explicit signed copyright grants were located in this export. Do not infer ownership from a Git author field alone.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
include LICENSE README.md CONTRIBUTING.md CODE_OF_CONDUCT.md SECURITY.md CHANGELOG.md ROADMAP.md RELEASE_NOTES.md AUDIT.md SECURITY_REPORT.md LICENSE_INVENTORY.md FINAL_RELEASE_CHECKLIST.md FIRST_TIME_VALIDATION.md MANIFEST.in
|
|
2
|
+
recursive-include docs *.md *.csv
|
|
3
|
+
recursive-include examples *.md *.py *.toml *.json LICENSE
|
|
4
|
+
recursive-include tests test_*.py
|
|
5
|
+
recursive-include scripts *.py
|
|
6
|
+
recursive-include .github *.yml *.md
|
|
7
|
+
prune build
|
|
8
|
+
prune dist
|
|
9
|
+
prune .pytest_cache
|
|
10
|
+
prune src/stacklatch.egg-info
|
|
11
|
+
recursive-exclude * __pycache__ *.pyc
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: stacklatch
|
|
3
|
+
Version: 0.1.0a1
|
|
4
|
+
Summary: Bounded analysis and verified integration of pinned Python repositories
|
|
5
|
+
Author: StackLatch contributors
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Classifier: Development Status :: 3 - Alpha
|
|
8
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
9
|
+
Requires-Python: >=3.12
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
License-File: LICENSE_INVENTORY.md
|
|
13
|
+
Dynamic: license-file
|
|
14
|
+
|
|
15
|
+
# StackLatch — Discover compatibility between software repositories
|
|
16
|
+
|
|
17
|
+
**StackLatch Core** is an experimental Python integration engine whose planning analysis runs locally after fetching pinned sources. It inspects two public GitHub repositories at exact commits, indexes Python interfaces with AST analysis, extracts bounded capabilities, and proposes an adapter. A proposal is **not** a working integration. A separate, explicitly confirmed verification runs independently supplied cases inside a restricted container before reporting success.
|
|
18
|
+
|
|
19
|
+
StackLatch Cloud (website, authentication, billing, AI invention reports and private datasets) is separate and **not included** in Core.
|
|
20
|
+
|
|
21
|
+
```mermaid
|
|
22
|
+
flowchart LR
|
|
23
|
+
A["Pinned GitHub commits"] --> B["Bounded inspection"]
|
|
24
|
+
B --> C["AST interfaces and capability evidence"]
|
|
25
|
+
C --> D["Ranked integration proposal"]
|
|
26
|
+
D --> E["Explicit confirmation + test cases"]
|
|
27
|
+
E --> F["Restricted Docker verification"]
|
|
28
|
+
F --> G["Evidence report + deterministic ZIP"]
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Install
|
|
32
|
+
|
|
33
|
+
Requires Python 3.12 or later. The alpha has no runtime PyPI dependencies. Before a PyPI release, install the locally built wheel:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
python3.12 -m pip install dist/stacklatch-0.1.0a1-py3-none-any.whl
|
|
37
|
+
stacklatch --help
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
`pip install stacklatch` is the **target command after a separately authorized PyPI release**; the candidate is not published. Verification additionally needs Docker and the pinned Python image (see Security). Planning requires network access to public GitHub repositories.
|
|
41
|
+
|
|
42
|
+
## Quick start
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
stacklatch plan \
|
|
46
|
+
--left https://github.com/bakhbk/slugify \
|
|
47
|
+
--left-sha c0c2053418f1ab722f05cc284f206b154eb8155e \
|
|
48
|
+
--right https://github.com/okunishinishi/python-stringcase \
|
|
49
|
+
--right-sha 57aae96649f5cf7fc98e50b1d62479456d492715 \
|
|
50
|
+
--goal 'Slugify an input phrase, then convert the resulting slug to camel case.' \
|
|
51
|
+
--out ./output
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Inspect `output/plan.json` and its `abstained`, `verified`, `sources`, and evidence fields. This exact planning command returned one selected candidate and `verified: false` during preparation. Other goals may abstain. `stacklatch verify --help` shows required schema and case files. Verification is deliberately separate and requires `--confirm`; see [examples/README.md](examples/README.md). The CLI never calls paid APIs.
|
|
55
|
+
|
|
56
|
+
## CLI
|
|
57
|
+
|
|
58
|
+
| Command | Result |
|
|
59
|
+
| --- | --- |
|
|
60
|
+
| `stacklatch --help` | Core command overview |
|
|
61
|
+
| `stacklatch plan --left URL --left-sha SHA --right URL --right-sha SHA --goal TEXT --out DIR` | Pinned-source analysis; writes unverified `plan.json` |
|
|
62
|
+
| `stacklatch verify --plan FILE --cases-file FILE --input-schema FILE --intermediate-schema FILE --output-schema FILE --out DIR --confirm` | Re-fetches commits, validates evidence, runs tests in Docker; writes `report.json`, and only on success a prototype ZIP |
|
|
63
|
+
|
|
64
|
+
## Support and security
|
|
65
|
+
|
|
66
|
+
The alpha targets small, public, MIT-like **Python-to-Python** repositories with bounded source trees and statically indexable functions. Type hints and simple return shapes improve matching. AST/text analysis cannot prove behavior, dependencies, legal license compatibility, or universal repository support. Exact commits and hash checks reduce source drift. Input limits, path and symlink checks, restricted imports, fail-closed verification, no network inside the non-root Docker container, read-only mounts, resource limits and a pinned image digest are implemented. Treat every fetched repository as untrusted; never run its code on your host. MIT-like detection is only a heuristic and a human must review third-party licenses before reuse. See [SECURITY.md](SECURITY.md).
|
|
67
|
+
|
|
68
|
+
## Roadmap and community
|
|
69
|
+
|
|
70
|
+
See [ROADMAP.md](ROADMAP.md), [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), and [CHANGELOG.md](CHANGELOG.md). Core source is licensed under [MIT](LICENSE). The candidate contains no private Git history. The suggested future public repository is separate from the existing private commercial repository.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# StackLatch — Discover compatibility between software repositories
|
|
2
|
+
|
|
3
|
+
**StackLatch Core** is an experimental Python integration engine whose planning analysis runs locally after fetching pinned sources. It inspects two public GitHub repositories at exact commits, indexes Python interfaces with AST analysis, extracts bounded capabilities, and proposes an adapter. A proposal is **not** a working integration. A separate, explicitly confirmed verification runs independently supplied cases inside a restricted container before reporting success.
|
|
4
|
+
|
|
5
|
+
StackLatch Cloud (website, authentication, billing, AI invention reports and private datasets) is separate and **not included** in Core.
|
|
6
|
+
|
|
7
|
+
```mermaid
|
|
8
|
+
flowchart LR
|
|
9
|
+
A["Pinned GitHub commits"] --> B["Bounded inspection"]
|
|
10
|
+
B --> C["AST interfaces and capability evidence"]
|
|
11
|
+
C --> D["Ranked integration proposal"]
|
|
12
|
+
D --> E["Explicit confirmation + test cases"]
|
|
13
|
+
E --> F["Restricted Docker verification"]
|
|
14
|
+
F --> G["Evidence report + deterministic ZIP"]
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Install
|
|
18
|
+
|
|
19
|
+
Requires Python 3.12 or later. The alpha has no runtime PyPI dependencies. Before a PyPI release, install the locally built wheel:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
python3.12 -m pip install dist/stacklatch-0.1.0a1-py3-none-any.whl
|
|
23
|
+
stacklatch --help
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
`pip install stacklatch` is the **target command after a separately authorized PyPI release**; the candidate is not published. Verification additionally needs Docker and the pinned Python image (see Security). Planning requires network access to public GitHub repositories.
|
|
27
|
+
|
|
28
|
+
## Quick start
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
stacklatch plan \
|
|
32
|
+
--left https://github.com/bakhbk/slugify \
|
|
33
|
+
--left-sha c0c2053418f1ab722f05cc284f206b154eb8155e \
|
|
34
|
+
--right https://github.com/okunishinishi/python-stringcase \
|
|
35
|
+
--right-sha 57aae96649f5cf7fc98e50b1d62479456d492715 \
|
|
36
|
+
--goal 'Slugify an input phrase, then convert the resulting slug to camel case.' \
|
|
37
|
+
--out ./output
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Inspect `output/plan.json` and its `abstained`, `verified`, `sources`, and evidence fields. This exact planning command returned one selected candidate and `verified: false` during preparation. Other goals may abstain. `stacklatch verify --help` shows required schema and case files. Verification is deliberately separate and requires `--confirm`; see [examples/README.md](examples/README.md). The CLI never calls paid APIs.
|
|
41
|
+
|
|
42
|
+
## CLI
|
|
43
|
+
|
|
44
|
+
| Command | Result |
|
|
45
|
+
| --- | --- |
|
|
46
|
+
| `stacklatch --help` | Core command overview |
|
|
47
|
+
| `stacklatch plan --left URL --left-sha SHA --right URL --right-sha SHA --goal TEXT --out DIR` | Pinned-source analysis; writes unverified `plan.json` |
|
|
48
|
+
| `stacklatch verify --plan FILE --cases-file FILE --input-schema FILE --intermediate-schema FILE --output-schema FILE --out DIR --confirm` | Re-fetches commits, validates evidence, runs tests in Docker; writes `report.json`, and only on success a prototype ZIP |
|
|
49
|
+
|
|
50
|
+
## Support and security
|
|
51
|
+
|
|
52
|
+
The alpha targets small, public, MIT-like **Python-to-Python** repositories with bounded source trees and statically indexable functions. Type hints and simple return shapes improve matching. AST/text analysis cannot prove behavior, dependencies, legal license compatibility, or universal repository support. Exact commits and hash checks reduce source drift. Input limits, path and symlink checks, restricted imports, fail-closed verification, no network inside the non-root Docker container, read-only mounts, resource limits and a pinned image digest are implemented. Treat every fetched repository as untrusted; never run its code on your host. MIT-like detection is only a heuristic and a human must review third-party licenses before reuse. See [SECURITY.md](SECURITY.md).
|
|
53
|
+
|
|
54
|
+
## Roadmap and community
|
|
55
|
+
|
|
56
|
+
See [ROADMAP.md](ROADMAP.md), [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), and [CHANGELOG.md](CHANGELOG.md). Core source is licensed under [MIT](LICENSE). The candidate contains no private Git history. The suggested future public repository is separate from the existing private commercial repository.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# StackLatch Core 0.1.0a1 — private release candidate
|
|
2
|
+
|
|
3
|
+
Prepared 2026-11-22 from private source commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb` with documented Core-only extraction changes. No public repository, PyPI release or announcement was made.
|
|
4
|
+
|
|
5
|
+
Python 3.12+; no runtime Python package dependencies. Git and public GitHub connectivity are needed for planning. Docker and the pinned Python image are needed for explicit restricted verification. Fresh Linux source/wheel installations and CLI help succeeded; the README pinned GitHub planning command returned a selected **unverified** candidate. Core unit tests: 82 passed, one skipped because bubblewrap user namespaces are prohibited here. No fresh Docker integration verification; Windows/macOS untested. Security and contributor-rights items are in the gate reports. The private commercial application is excluded.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Roadmap
|
|
2
|
+
|
|
3
|
+
1. Validate the alpha on a Docker host with independently specified public-repository acceptance cases and publish evidence.
|
|
4
|
+
2. Expand documented support conservatively with explicit language and license checks.
|
|
5
|
+
3. Improve inspectable compatibility and abstention explanations; retain pinned source provenance.
|
|
6
|
+
4. Harden packaging, reproducibility, cross-platform CI, and vulnerability response.
|
|
7
|
+
|
|
8
|
+
No promise of universal compatibility or delivery date is implied. Cloud features live outside Core.
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# Security policy
|
|
2
|
+
|
|
3
|
+
Alpha: security fixes are best effort. Report vulnerabilities privately using GitHub private vulnerability reporting once available, or contact the owner privately on GitHub. Do not post exploit details or credentials in issues.
|
|
4
|
+
|
|
5
|
+
Planning reads bounded public GitHub source as data. Verification executes selected third-party Python only after explicit confirmation and independent test cases, inside a pinned Docker image with networking disabled, non-root user, read-only source, dropped capabilities and limits for processes, memory and CPU. The verifier fails closed if isolation or tests fail. Docker availability and image supply must be checked on each verification host; a static proposal never means safe or verified. Do not use private repositories or secrets as input. License detection is heuristic, not legal clearance.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Security review — private candidate
|
|
2
|
+
|
|
3
|
+
## Scope
|
|
4
|
+
|
|
5
|
+
Bounded Core-only export from private commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb`, with documented extraction edits. The scanner in `scripts/scan_release.py` checks every selected source file and every wheel/sdist member for common credential/token/key shapes, email addresses, unusual long high-entropy strings, forbidden paths, and archive links. It reports paths/categories only. Final source/wheel/sdist scan returned zero findings; `test@example.invalid` is an intentionally reserved test fixture, and wheel RECORD digests are excluded from entropy alarms. The scanner cannot detect every secret format or establish the absence of sensitive semantics; a manual review remains required. No private history is present in the export.
|
|
6
|
+
|
|
7
|
+
## Checkout and execution boundary
|
|
8
|
+
|
|
9
|
+
Planning obtains metadata from GitHub, fetches exactly pinned commits via noninteractive HTTPS Git, then analyzes bounded AST/source data. The candidate removes inherited `GIT_*` variables and API tokens from **all** child Git commands, retains normal network proxy settings, and disallows non-HTTPS Git protocols. Git itself, API metadata and dependency manifest parsing remain attack surfaces. Size and symlink/path checks restrict inputs but do not make arbitrary repositories safe.
|
|
10
|
+
|
|
11
|
+
Verification requires explicit `--confirm`, independently provided schema/cases, source hash checks, Docker presence and the pinned Python runtime image digest. Container settings include `--network none`, `--read-only`, `--user 65534:65534`, `--cap-drop ALL`, `--security-opt no-new-privileges`, a read-only bind mount and bounded CPU, memory, processes, wall time and captured output. No verified ZIP should survive a failure. Container isolation depends on the Docker daemon/kernel configuration; there is no separate proof of confinement, no image SBOM review and no fresh execution test on this host.
|
|
12
|
+
|
|
13
|
+
## Findings and disposition
|
|
14
|
+
|
|
15
|
+
- Original source checkout passed part of its Git calls an inherited environment. Export hardens both V1 and V3.1 checkout paths. Repeat tests and pinned planning after this change.
|
|
16
|
+
- Original Core `openai_plan` and commercial modules are absent from export. Optional public GitHub API token is read only by the checkout preflight and removed from child Git environments; it must never be placed in example inputs.
|
|
17
|
+
- Original MIT text was incomplete; candidate includes the full standard permission, notice and warranty/liability disclaimer. Contributor licensing rights require owner review.
|
|
18
|
+
- Missing Docker prevents fresh real-repository behavioral verification and container security acceptance. A plan's `verified: false` remains the only result reported for the demonstrated public pair.
|
|
19
|
+
|
|
20
|
+
No paid API request, payment, public repository or external deployment is part of this review.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Source-to-export review
|
|
2
|
+
|
|
3
|
+
**Exact source:** private `salam33333/StackLatch` commit `c07b9d156c418fc7cb92ac5f5eae04155635cfcb` on Draft PR #37. All 13 original Python Core module blobs and 16 original license, test and example blobs were compared to GitHub's blob SHA for that commit; every local source blob matched. The old local checkout's HEAD `91f1c403235fd9dad395c72ca9725cd99702dc9a` was **not** the export source: its working files matched the newer remote commit. See `SOURCE_MAP.csv` for every exported source file, its original path when copied, SHA-256 before/after extraction, and classification. New authored files have no private source counterpart. Artifacts in `dist/` are generated from this tree and listed in `SHA256SUMS.txt`.
|
|
4
|
+
|
|
5
|
+
## Extraction changes reviewed
|
|
6
|
+
|
|
7
|
+
| Export path | Difference from source commit | Review result |
|
|
8
|
+
| --- | --- | --- |
|
|
9
|
+
| `src/stacklatch/__init__.py` | Replaced one-line prototype module docstring with Core description/version. | Metadata only. |
|
|
10
|
+
| `src/stacklatch/core.py` | Removed optional `openai_plan` and its paid API request; kept the GitHub API import. Unified child Git subprocess environment and stripped inherited `GIT_*` variables and optional API token. | Core planner and verification functions retained; bounded execution tests and real pinned planning rerun. |
|
|
11
|
+
| `src/stacklatch/v31_checkout.py` | Strips inherited `GIT_*` variables before setting the four permitted Git controls. | Restricts configuration injection; real pinned V3.1 planning rerun. |
|
|
12
|
+
| `src/stacklatch/cli.py` | Replaced 442-line multi-version/commercial CLI with Core-only `plan`/`verify` front end. Added Docker presence error before verification. | CLI parsing, installed help, one real public planning example, invalid-URL and missing-Docker behavior tested. The Docker verification route still requires runtime acceptance. |
|
|
13
|
+
| `tests/test_v23.py` | Removed one sealed-evaluator unit test and unused JSON import because private evaluator/dataset are excluded. | Remaining public Core unit tests passed. |
|
|
14
|
+
| `LICENSE` and both fixture LICENSE files | Expanded abbreviated private MIT text to the complete standard MIT notice and disclaimer, retaining the original contributor copyright line. | License notice preserved; owner/contributor rights confirmation still required. |
|
|
15
|
+
| `pyproject.toml`, `MANIFEST.in`, docs, templates, security scanner, new V3.1 example/test | New Core-only packaging, community and release-gate materials. | Explicit one-package wheel, source manifest and content inventory tested. |
|
|
16
|
+
|
|
17
|
+
No files from commercial `v4/v42/v43/v44`, website/site, auth, billing, private evaluation data or `.git` were included. The Git author metadata alone is insufficient to prove contributor rights.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Draft launch copy — do not publish until authorized and revalidated
|
|
2
|
+
|
|
3
|
+
## GitHub description and topics
|
|
4
|
+
|
|
5
|
+
Description: “Inspect two pinned Python repositories, find bounded interface compatibility, and verify an integration in restricted Docker.”
|
|
6
|
+
|
|
7
|
+
Suggested topics: `python`, `ast`, `repository-analysis`, `software-integration`, `developer-tools`, `open-source`, `sandbox`.
|
|
8
|
+
|
|
9
|
+
## Hacker News — Show HN
|
|
10
|
+
|
|
11
|
+
**Show HN: StackLatch Core — inspect pinned Python repos and propose an integration**
|
|
12
|
+
|
|
13
|
+
I built a small Python CLI that fetches two public GitHub repos at exact commits, indexes their functions with AST analysis, and ranks a possible adapter against a stated goal. It can abstain. A proposal stays unverified until an operator supplies independent cases and explicitly runs restricted Docker verification. The alpha supports a narrow set of Python interfaces; I would value feedback on its abstention behavior, provenance checks and sandbox design. [Insert public repository and current test evidence only after authorization.]
|
|
14
|
+
|
|
15
|
+
## Reddit developer communities
|
|
16
|
+
|
|
17
|
+
**Title:** Feedback wanted: pinned-repository Python integration analyzer (alpha)
|
|
18
|
+
|
|
19
|
+
StackLatch Core analyzes two small public Python repos and produces an evidence-backed proposal. A separate confirmed Docker run checks supplied test cases. I am looking for concrete pairs where the AST/interface reasoning helps or safely abstains. I will share exact commits and limitations. [Adapt to each community's posting rules; add link after release.]
|
|
20
|
+
|
|
21
|
+
## Product Hunt
|
|
22
|
+
|
|
23
|
+
**Tagline:** Evidence-backed integration ideas for pinned Python repositories.
|
|
24
|
+
|
|
25
|
+
**Description:** Explore whether two Python repositories can be connected. StackLatch inspects bounded source trees, proposes adapters and separates speculative plans from restricted Docker verification. Alpha support is intentionally narrow. [Attach a verified demo only after retesting.]
|
|
26
|
+
|
|
27
|
+
## Dev.to
|
|
28
|
+
|
|
29
|
+
**Title:** What happens when you try to compose two open-source Python repositories?
|
|
30
|
+
|
|
31
|
+
Outline: (1) input commits and objective, (2) AST and capability index, (3) compatibility ranking and abstention, (4) user-supplied acceptance cases, (5) Docker evidence, (6) current limitations. Include reproducible commands and report excerpts only after fresh validation.
|
|
32
|
+
|
|
33
|
+
## LinkedIn
|
|
34
|
+
|
|
35
|
+
StackLatch Core is an alpha developer tool for exploring connections between pinned Python repositories. It inspects code statically, produces a proposal with evidence, and reserves “verified” for an explicit isolated test run. We are preparing the source, docs and security model before public release. [Add public link when approved.]
|
|
36
|
+
|
|
37
|
+
## Short demo script (after Docker revalidation)
|
|
38
|
+
|
|
39
|
+
1. Show `stacklatch --help` and explain the two-step plan/verify workflow.
|
|
40
|
+
2. Run the pinned text example in `examples/v21_real_acceptance.py`; show exact SHA values and the four independently supplied cases.
|
|
41
|
+
3. Open `proposal.json`: point out `verified: false`, interface selections, explicit mapping and provenance.
|
|
42
|
+
4. With Docker available, show the real `report.json`, passed cases and `prototype.zip` digest. Do not play a fabricated output or mark verified if the run fails.
|
|
43
|
+
5. Show one intentionally wrong mapping and the absence of a verified ZIP. End with Python-only and license-review limits.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
export_path,source_path_at_commit_c07b9d156c418fc7cb92ac5f5eae04155635cfcb,source_git_blob_sha,source_sha256,export_sha256,change
|
|
2
|
+
.github/ISSUE_TEMPLATE/bug_report.yml,NEW,,,927ba5c559037457f95ded9d3f4b92b284626914f25ae7aeb62b7f49960eb2bb,new
|
|
3
|
+
.github/ISSUE_TEMPLATE/feature_request.yml,NEW,,,11ea437e0b64b33d331aad589df0738105ef6baa00f19225c2129e49bc57b9c2,new
|
|
4
|
+
.github/PULL_REQUEST_TEMPLATE.md,NEW,,,a92b5b7d6a0a9444344b7e131381ba97ac3522cab52e6853490ecc053cafc0f2,new
|
|
5
|
+
AUDIT.md,NEW,,,3ca1d4a812b1ea873cb8caab7c774b6136d24ef6efa87c9e43f39555ed128a67,new
|
|
6
|
+
CHANGELOG.md,NEW,,,de0a3f81d1301800bda1811ab6935f13b3d1db776d9c01aeb0d8707796d2be8b,new
|
|
7
|
+
CODE_OF_CONDUCT.md,NEW,,,b33f3a1e781ba7b7a01365102a75d78e43a03bc1e4ae36ab2d6ac4689235325c,new
|
|
8
|
+
CONTRIBUTING.md,NEW,,,3aceb615d18a406cd0599d6c527c2d24dfb6a552b56b39402185421ce3228322,new
|
|
9
|
+
FINAL_RELEASE_CHECKLIST.md,NEW,,,13e6cb398a2e306d86539a363239c2e0965cee9722c05b1e4feffc06cdd1cccf,new
|
|
10
|
+
FIRST_TIME_VALIDATION.md,NEW,,,2f5beaf4d1d996ca4632a735eb7ffc568f0eaffe5958f234d2bc6d74dcc58191,new
|
|
11
|
+
LICENSE,LICENSE,8bf7de8da8e65e5d0eb6ceade6b3e9324bf65867,fbdcbe28188b4ad4b02dda693c1a25798aa58464841b97bf910e18f46aac8785,4ce95096bd425290f334a5e1a058f1522b3c6d1857dede4abefefec576d03a49,modified
|
|
12
|
+
LICENSE_INVENTORY.md,NEW,,,bc8dfde10d7b6c9aab57772d4a985d8c719d1e21d79fd97b9b774da2d851add1,new
|
|
13
|
+
MANIFEST.in,NEW,,,80ce2e3ee72cfe97d2d90f5597ba495d690e498fb21bce0a3cb0cba45d8a0340,new
|
|
14
|
+
README.md,NEW,,,085b639eaaacb1464a47371025ca0b05b52757884012f198b3c042854db003d9,new
|
|
15
|
+
RELEASE_NOTES.md,NEW,,,d5b3686ec9029d299a9676ba11789e201d2d8b536f7173ca1ce9b54f87b48792,new
|
|
16
|
+
ROADMAP.md,NEW,,,72a2b10677faa9f467374afcb3d30cafad0622ec07735d8836cce428c87cb0e1,new
|
|
17
|
+
SECURITY.md,NEW,,,8a5862703678ef3bc9a5e7f69428a7457482f157ec67f0f7cfbbf6961acffdae,new
|
|
18
|
+
SECURITY_REPORT.md,NEW,,,948539a5abfd306f11d1f3a492a2fadbc96e2616240a0d63b57de5e10b62022b,new
|
|
19
|
+
docs/EXTRACTION_REVIEW.md,NEW,,,4980403c9585280677fe9fb9d7dae8ee9edf19c2d0a981bb20b976a5fe52ec55,new
|
|
20
|
+
docs/LAUNCH_MATERIALS.md,NEW,,,5299e3e8fd6e647002c877ffa727bd7e27b5658a0dac2fdc99f3aed7a8736f03,new
|
|
21
|
+
examples/README.md,NEW,,,dc5b62c2018dd37cbded45ab020ae8e17a0be32bb2963c1fac8d1303aa91e908,new
|
|
22
|
+
examples/counter/LICENSE,examples/counter/LICENSE,8bf7de8da8e65e5d0eb6ceade6b3e9324bf65867,fbdcbe28188b4ad4b02dda693c1a25798aa58464841b97bf910e18f46aac8785,4ce95096bd425290f334a5e1a058f1522b3c6d1857dede4abefefec576d03a49,modified
|
|
23
|
+
examples/counter/pyproject.toml,examples/counter/pyproject.toml,1007c2d6a8359d655cdb78bb24a2562adebe4444,d2e18a04e81f6b38b415c58907ff2e12b43df219230eca1c779ef741db5c88ab,d2e18a04e81f6b38b415c58907ff2e12b43df219230eca1c779ef741db5c88ab,copied
|
|
24
|
+
examples/counter/src/counter.py,examples/counter/src/counter.py,0a6711555e073a248de4e0b70eab010ddc9c3c49,fb0f8c8fa34471a32e2533a4e380ba31de57b83e0685445d6c8de3fa9b93e79d,fb0f8c8fa34471a32e2533a4e380ba31de57b83e0685445d6c8de3fa9b93e79d,copied
|
|
25
|
+
examples/normalizer/LICENSE,examples/normalizer/LICENSE,8bf7de8da8e65e5d0eb6ceade6b3e9324bf65867,fbdcbe28188b4ad4b02dda693c1a25798aa58464841b97bf910e18f46aac8785,4ce95096bd425290f334a5e1a058f1522b3c6d1857dede4abefefec576d03a49,modified
|
|
26
|
+
examples/normalizer/pyproject.toml,examples/normalizer/pyproject.toml,3c62d51582176e6f58392dd8118a5ed236370a17,0615942895aea72b573a9c02598fe481529d609e243c297a5808ddbdc70d51df,0615942895aea72b573a9c02598fe481529d609e243c297a5808ddbdc70d51df,copied
|
|
27
|
+
examples/normalizer/src/normalizer.py,examples/normalizer/src/normalizer.py,82862b6a7a90a48309b6b14d40b3400e848ae24b,55281b7ac970c922249893df68bc23c8bf96d71c3288f530b53432e852fc77d0,55281b7ac970c922249893df68bc23c8bf96d71c3288f530b53432e852fc77d0,copied
|
|
28
|
+
examples/v21_real_acceptance.py,tests/v21_real_acceptance.py,15c8ecdca30d9034570fe43cce2ca67006555e96,39b891e13df4c99631c24e97054d0c4d38eb162f4d8186fb527fa527b8ec7561,39b891e13df4c99631c24e97054d0c4d38eb162f4d8186fb527fa527b8ec7561,copied
|
|
29
|
+
examples/v22_real_acceptance.py,tests/v22_real_acceptance.py,5d790f9e09148217e544d8e90514f2cfcf44f3f0,e9e76283cde1ddefcbf3cb0ed994e515ee4d0adfee0328259fd933e37e4f047c,e9e76283cde1ddefcbf3cb0ed994e515ee4d0adfee0328259fd933e37e4f047c,copied
|
|
30
|
+
examples/v31_slug_to_camel/cases.json,NEW,,,164b32201338e44e06d369d11859aea0a529d54cd98542c222d53433cc97fdd0,new
|
|
31
|
+
examples/v31_slug_to_camel/input-schema.json,NEW,,,bf1d1534e382cc5afefff26ccf951def301e0b63515bcab097be63a680dd85a0,new
|
|
32
|
+
examples/v31_slug_to_camel/intermediate-schema.json,NEW,,,26915e5a3ecb62273f359cfaf700ff66b67afcb829595393a74e867c06347267,new
|
|
33
|
+
examples/v31_slug_to_camel/output-schema.json,NEW,,,26915e5a3ecb62273f359cfaf700ff66b67afcb829595393a74e867c06347267,new
|
|
34
|
+
pyproject.toml,NEW,,,2cf88bb680df4fc2b0f95b45d46a33bc8a90c6e6d3d1cc5de9cf7863a53ed9ac,new
|
|
35
|
+
scripts/scan_release.py,NEW,,,8af40361c6e5de4cfda2c9f512834be8fa4669fa19d80f49f099b17c8fc6c77f,new
|
|
36
|
+
src/stacklatch/__init__.py,src/stacklatch/__init__.py,f94855b0acd866d55d35cea334fb9f81d616c625,a5c565113a1439f5bf00f142687a1835fc3c3078ded65a8eb8f2a9c45dfe1237,018ec716baf59ccff1fb9f77d1a4e1fae6a60ccd96b6f40bc868a193ebdbc839,modified
|
|
37
|
+
src/stacklatch/cli.py,NEW,,,24fe2eadb1b9a57861e547d2bdec54fd137914f65ebd509c259deaf0c70f0249,new
|
|
38
|
+
src/stacklatch/core.py,src/stacklatch/core.py,3539f3e8cd63742335ec47775354650bff98ed62,8e9b8a136e2b61cdf2fd007e2a65d1fda687d8f4d92bb36862d2a278f168fec2,79a669b346ec9d9b13167c4b8957aede73cabed50c2f8250d9a9600c3434fa24,modified
|
|
39
|
+
src/stacklatch/v21.py,src/stacklatch/v21.py,ba48993332024fabef5ee87bdf5474f7c4f87c7e,df1f31e29a6c4bb668096de4f4e51ec6ca169d5fa1980bd4604de27fa0940fcb,df1f31e29a6c4bb668096de4f4e51ec6ca169d5fa1980bd4604de27fa0940fcb,copied
|
|
40
|
+
src/stacklatch/v22.py,src/stacklatch/v22.py,5a72b24b2a35f28ce2a102916b10faf8f827ba1f,7c7a0a612926415a31f173ac9c47eb04eb1acf4c9fd17aefe3e981872647deac,7c7a0a612926415a31f173ac9c47eb04eb1acf4c9fd17aefe3e981872647deac,copied
|
|
41
|
+
src/stacklatch/v23.py,src/stacklatch/v23.py,85dd17d6fb162b8301a5b767b57453bf594c5b61,4739c4ad549e23d9c5ffe81da20abee69237dd47178cee8e48e4e9e1ab2a28f5,4739c4ad549e23d9c5ffe81da20abee69237dd47178cee8e48e4e9e1ab2a28f5,copied
|
|
42
|
+
src/stacklatch/v24.py,src/stacklatch/v24.py,d50984dc312d788a829910039336a1e2af08e95a,05de406a2ea6243ce200e4bbd89d2216c5a07bd75f891ec0f9b790643a8c4126,05de406a2ea6243ce200e4bbd89d2216c5a07bd75f891ec0f9b790643a8c4126,copied
|
|
43
|
+
src/stacklatch/v24_contract.py,src/stacklatch/v24_contract.py,9fba3cf3a8588323862f9bdbd29f02bbcab9ed90,154496ef33fe4ca31079ced7f21b405ff1f56d821026e4597085fc47ea3cdabb,154496ef33fe4ca31079ced7f21b405ff1f56d821026e4597085fc47ea3cdabb,copied
|
|
44
|
+
src/stacklatch/v24_graph.py,src/stacklatch/v24_graph.py,8934b4a5c982b18f5806733e6b65eb7281f017ca,f4ac3ee005481c6fdb52cdc86c117e88de80fbb18fc9af6b3ef78b3bf4751069,f4ac3ee005481c6fdb52cdc86c117e88de80fbb18fc9af6b3ef78b3bf4751069,copied
|
|
45
|
+
src/stacklatch/v25.py,src/stacklatch/v25.py,7d4e1e44fe7c960fa10061a9eaf0f0b77cdf6ae8,163f35c905db6b44b98ef17b1e5ecfe41d9d6b524618ad2b6819a14a8d371ee0,163f35c905db6b44b98ef17b1e5ecfe41d9d6b524618ad2b6819a14a8d371ee0,copied
|
|
46
|
+
src/stacklatch/v31.py,src/stacklatch/v31.py,7d92c3d2900b51df847984febc1ae7e98049666d,4dcf135f895eceb8616ea5f74a68d8c8c151eac83948adc5e3138107d811dc52,4dcf135f895eceb8616ea5f74a68d8c8c151eac83948adc5e3138107d811dc52,copied
|
|
47
|
+
src/stacklatch/v31_checkout.py,src/stacklatch/v31_checkout.py,f415984f2cf1fe54b04727671652598be9895052,0dd869b5651a2bf5ef2004d42b79001a537064b2b5327dcaebc74b11a7e2682e,481f95324fea451425735125d06153d592b4e9bf57dcf8c03004a87f2a64c407,modified
|
|
48
|
+
src/stacklatch/v31_graph.py,src/stacklatch/v31_graph.py,8188c6977e9c8a72c013a625e5f54e2dd0baf2c8,9e036753a7daf48d1f4f34eb18fec225b737c7526e2dcef6f5e9273cf4b6905e,9e036753a7daf48d1f4f34eb18fec225b737c7526e2dcef6f5e9273cf4b6905e,copied
|
|
49
|
+
src/stacklatch/v31_graph_legacy.py,src/stacklatch/v31_graph_legacy.py,8e78c9a74fadf04e0a6dcfac32fe516e4180bd13,8386a61f36de8d9d1fd81eb4f39e4c7d99b3d6ba068cde0b0f796683d987f715,8386a61f36de8d9d1fd81eb4f39e4c7d99b3d6ba068cde0b0f796683d987f715,copied
|
|
50
|
+
tests/test_cli_errors.py,NEW,,,d9d7d5d12ca932f77708ebe1448bd4e77fc8861616efa7d4c86391ab386b53fb,new
|
|
51
|
+
tests/test_core.py,tests/test_core.py,ccdfddf6cd745c5c12e3a8db53296506d5e738f5,2f4f0cd08bcc2387dbcc888abf5f5f71770d26996b11cc3fd21acd31c7c9ae3b,2f4f0cd08bcc2387dbcc888abf5f5f71770d26996b11cc3fd21acd31c7c9ae3b,copied
|
|
52
|
+
tests/test_v21.py,tests/test_v21.py,ce2f05601ed5dbcc75f8b30053abd0d4f41fd2f2,17235d1d394af596cc699141623ce366fc70ceea857e6e095b863385aecec4ed,17235d1d394af596cc699141623ce366fc70ceea857e6e095b863385aecec4ed,copied
|
|
53
|
+
tests/test_v22.py,tests/test_v22.py,167961c3b517cc7dff334a53bc258962ac7334d6,fca31a7b3c39e99ccab6fb88a3ab880f3a9ed1c66d3337f6bd9e7b301ced4b96,fca31a7b3c39e99ccab6fb88a3ab880f3a9ed1c66d3337f6bd9e7b301ced4b96,copied
|
|
54
|
+
tests/test_v23.py,tests/test_v23.py,f5fc726a239bd3387aed362b20724225d381d14c,8b994440722efbd5ce3cee1abb8d14019819ab5ce0ea95123fdd43425c20dfa8,5751adedbe5fe5c43d01ff006b8349f8a705387597d544105d2e59c9221f20e8,modified
|
|
55
|
+
tests/test_v24.py,tests/test_v24.py,0b885cbf20f356ac5b819d8fd441a14f676a73b2,9418448ddd94c8e834aa56ce7a666adcef6faba66c7b56924742b17fbfb11b54,9418448ddd94c8e834aa56ce7a666adcef6faba66c7b56924742b17fbfb11b54,copied
|
|
56
|
+
tests/test_v24_graph.py,tests/test_v24_graph.py,3ac11c4819b8210fd5b73962d5892bf6f94cefa2,364bb6df9533ac067d3f2121a52ed24e2b76549990ef07f3f30f527f0355c05e,364bb6df9533ac067d3f2121a52ed24e2b76549990ef07f3f30f527f0355c05e,copied
|
|
57
|
+
tests/test_v25.py,tests/test_v25.py,043cf703d67040643ad8445d04f59b9a6ff31996,215ed9904460599191dfc2feb9b2f4304dee9ca98efc838a57fa54f2f8abce45,215ed9904460599191dfc2feb9b2f4304dee9ca98efc838a57fa54f2f8abce45,copied
|
|
58
|
+
tests/test_v31_core_smoke.py,NEW,,,e0f8110fb10487fad33a5b6baba6ec3c9ead7714c479237fba3fc19426c647fe,new
|
|
59
|
+
docs/SOURCE_MAP.csv,GENERATED,,,,self-referential mapping file; checksum in archive
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Reproducible pinned examples
|
|
2
|
+
|
|
3
|
+
## V3.1 CLI example — actually planned in this gate
|
|
4
|
+
|
|
5
|
+
Run the README quick-start command to create `output/plan.json`. It fetched exact public commits and selected `slugify` → `camelcase` with a type-uncertainty flag; the plan is unverified. Independent cases and schemas are in `examples/v31_slug_to_camel/`. On a suitable **restricted Docker host**, after inspecting the plan and cases, run:
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
stacklatch verify --plan output/plan.json \
|
|
9
|
+
--cases-file examples/v31_slug_to_camel/cases.json \
|
|
10
|
+
--input-schema examples/v31_slug_to_camel/input-schema.json \
|
|
11
|
+
--intermediate-schema examples/v31_slug_to_camel/intermediate-schema.json \
|
|
12
|
+
--output-schema examples/v31_slug_to_camel/output-schema.json \
|
|
13
|
+
--out output/verified --confirm
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
This verification command was **not run** here: Docker is unavailable. No prototype or successful execution is claimed for this candidate.
|
|
17
|
+
|
|
18
|
+
## Historical version-specific acceptance scripts
|
|
19
|
+
|
|
20
|
+
The included `v21_real_acceptance.py` and `v22_real_acceptance.py` are the original public-repository acceptance programs; invoke from this repository root after installing the wheel:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
python examples/v21_real_acceptance.py
|
|
24
|
+
python examples/v22_real_acceptance.py
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
These scripts require public GitHub access, Docker and the pinned Python image. They create `build/v21` and `build/v22` reports, check the ZIP contents against recorded hashes, execute four independent cases per pair, and compare repeat ZIP hashes. **These scripts were not run during this export preparation** because Docker is unavailable in this workspace; their assertions encode historical acceptance expectations, not a new verification result. No third-party repository source is bundled.
|
|
28
|
+
|
|
29
|
+
| Example | Exact pinned inputs | Objective and interface evidence | Status and limits |
|
|
30
|
+
| --- | --- | --- | --- |
|
|
31
|
+
| V2.1 text | [python-stringcase](https://github.com/okunishinishi/python-stringcase) `57aae96649f5cf7fc98e50b1d62479456d492715` + [slugify](https://github.com/bakhbk/slugify) `c0c2053418f1ab722f05cc284f206b154eb8155e` | `snakecase` output to `slugify` `text`; four cases include null failure | Historical test asserts restricted Docker success and repeat hash. Re-run to confirm in new release environment. |
|
|
32
|
+
| V2.1 temperature | [temperature-conversion-hvt](https://github.com/hvitserk8/temperature-conversion-hvt) `1fbc5a2de7f3bab4166017808e7bad846c01d1e4` + [unit_conversion](https://github.com/clintonbf/unit_conversion) `c1a07ce4a58857730de436659155695a5498de39` | `c_to_f` result to `fahrenheit_to_kelvin` `temp_in_fahrenheit`; three numeric cases and null failure | Historical test asserts restricted Docker success and repeat hash; narrow units and exact pins only. |
|
|
33
|
+
| V2.2 noun plurality | [slugify](https://github.com/bakhbk/slugify) `c0c2053418f1ab722f05cc284f206b154eb8155e` + [pluralize-utils](https://github.com/jerrymazur/pluralize-utils) `18a56b0b6a9476cb79f3de4c1c84c4a2771bf2dc` | `slugify` result to `pluralize` `word`; four cases | Historical acceptance assertion only; requires selected mapping, explicit confirmation and Docker. |
|
|
34
|
+
|
|
35
|
+
The V2.2 script additionally exercises sentence word count and words per line. Inspect its explicit pinned commits, mappings and cases before running. AST compatibility is evidence for a **proposal**, not behavioral proof. License eligibility is heuristically detected as MIT-like; review each repository's current and pinned license manually before redistributing an adapter. The CLI's V3.1 `plan` may abstain on these historical V2.1/V2.2 examples because its selection rules are more conservative; run the included version-specific acceptance scripts to reproduce those exact historical integrations.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 StackLatch contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 StackLatch contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|