reprovane 2.0.0__tar.gz

reprovane-2.0.0/ARCHITECTURE.md

@@ -0,0 +1,11 @@
+# Kiến trúc Reprovane
+
+Product version ở `reprovane/_version.py`: **2.0.0**. Database schema: **13**. Tên gói không phải phiên bản định dạng dữ liệu.
+
+Luồng chính: project/revision → acquisition/snapshot/record → typed observations → publication/venue resolution → discovery → frontier/search validation → human screening/adjudication → immutable corpus → OA fulltext. Mỗi lớp giữ bằng chứng và tham chiếu lớp trước; một bước tìm thấy dữ liệu không tự cấp quyền quyết định cho bước sau.
+
+Người dùng bắt đầu bằng [Quick Start](QUICKSTART_vi.md) và [User Guide](USER_GUIDE_vi.md). Các tài liệu trong [docs/architecture](docs/architecture/) là hợp đồng kỹ thuật: [persistence](docs/architecture/persistence_foundation.md), [observations](docs/architecture/typed_observations.md), [publication identity](docs/architecture/publication_identity_resolution.md), [venue resolution](docs/architecture/venue_resolution_scimago.md), [provider intelligence](docs/architecture/scopus_wos_venue_intelligence.md), [acquisition](docs/architecture/openalex_acquisition_migration.md), [discovery](docs/architecture/discovery_provenance_citation_expansion.md), [frontier/search validation](docs/architecture/frontier_policy_search_validation.md), [screening](docs/architecture/screening_separation.md), [corpus](docs/architecture/immutable_corpus_release.md), [fulltext](docs/architecture/fulltext_acquisition.md) và [pinned mirror](docs/architecture/pinned_github_mirror_sync.md).
+
+Phân giải không dùng fuzzy title để tự hợp nhất bài mơ hồ. SCImago, Scopus, WoS có ngữ nghĩa riêng. AI/OCR không sở hữu quyền quyết định trước khi đóng băng; screening thuộc con người. Fulltext failure không thay membership. Các thuật toán, quy tắc phiên bản PDF, SSRF, CAS, hash và 13 migration SQL không đổi trong rebrand.
+
+Adapter legacy v4 chỉ đưa bằng chứng lịch sử vào ngữ cảnh riêng, không biến phân loại máy cũ thành quyết định screening/corpus hiện hành. [Migration hiện tại](MIGRATION_FROM_SCHOLARFLOW_1.md) khác với [tài liệu chuyển tiếp lịch sử](MIGRATION_TO_SCHOLARFLOW.md). Các locator `db/litintel.sqlite` và `.litintel-writer.lock` giữ nguyên để workspace/schema13 và khóa writer tương tác được. Xem [Operations](OPERATIONS.md) cho snapshot đọc, backup, upgrade và giới hạn filesystem.

reprovane-2.0.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## 2.0.0
+
+First public Reprovane release, bringing reproducible literature discovery, human screening, and evidence management into one review workflow.
+
+- Collect literature from OpenAlex and expand searches through citations.
+- Keep venue evidence and human review decisions traceable.
+- Freeze a review corpus, organize eligible open-access full text, and track unresolved items in a manual queue.
+- Verify workspace and export integrity.
+
+Breaking package-name change: the distribution, Python import and CLI are now `reprovane`. Users of ScholarFlow 1.x can follow [the migration guide](MIGRATION_FROM_SCHOLARFLOW_1.md).
+
+## 1.0.0
+
+ScholarFlow 1.0.0 promotes the validated 1.0.0-rc1 architecture without scientific-semantic changes.
+
+- Reproducible acquisition, typed observations and conservative publication/venue identity resolution.
+- Separate provider intelligence, citation discovery, bounded frontier and search validation.
+- Human screening/adjudication, immutable corpus releases and policy-bound OA full-text acquisition with a manual queue.
+- Hash/provenance verification and copy-on-write predecessor migration.
+- Product version becomes 1.0.0; database schema remains 13 and migrations 0001–0013 are unchanged. Stable tag/release publication is a separate reviewed step.
+
+## 1.0.0-rc1
+
+Initial ScholarFlow release candidate.
+
+- Reproducible acquisition and immutable provider evidence/typed observations.
+- Conservative publication/venue identity and separate provider intelligence.
+- Citation discovery, bounded frontier and search validation.
+- Human screening and conflict adjudication, immutable corpus releases.
+- Policy-bound OA acquisition, verified PDF artifacts and manual queue.
+- Copy-on-write legacy migration, offline verification/doctor, OS locks and backup-first upgrade.
+- Canonical scholarflow namespace, one scholarflow console entry point and clean wheel/sdist packaging.
+
+ScholarFlow succeeds openalex-literature-intelligence; historical lineage is in PROVENANCE.md. Product version1 does not reset schema13. Nothing is tagged or published by bootstrap preparation.

reprovane-2.0.0/LICENSE

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

reprovane-2.0.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE README.md CHANGELOG.md SECURITY.md ARCHITECTURE.md MIGRATION_TO_SCHOLARFLOW.md OPERATIONS.md
+recursive-include reprovane/core/migrations *.sql
+prune tests
+prune data
+prune cache
+prune dist
+prune build
+global-exclude *.pyc *.sqlite *.db .env config.json
+
+include PROVENANCE.md OLD_REPOSITORY_ARCHIVE_NOTICE.md
+prune docs/legacy
+
+include QUICKSTART_vi.md USER_GUIDE_vi.md MIGRATION_FROM_SCHOLARFLOW_1.md THIRD_PARTY_DATA.md

reprovane-2.0.0/MIGRATION_FROM_SCHOLARFLOW_1.md

@@ -0,0 +1,40 @@
+# Chuyển từ ScholarFlow 1.x sang Reprovane 2.0.0
+
+Gói `scholarflow`, câu lệnh `scholarflow` và `import scholarflow` của bản 1 được thay bằng `reprovane`, `reprovane` và `import reprovane`. Bản 2 không cài gói tương thích hoặc bí danh lệnh cũ. Vì đây là thay đổi giao diện, version tăng thành **2.0.0**; schema vẫn **13**, không có migration 0014 cho đổi tên.
+
+## Trước khi chuyển
+
+1. Dừng mọi chương trình đang ghi workspace, gồm notebook/script Python. Không mở hai phiên bản cùng lúc để ghi.
+2. Giữ môi trường cài ScholarFlow 1 và bản wheel cũ để có thể kiểm tra lại. Các release `v1.0.0` và `v1.0.0-rc1` cùng tài sản cũ vẫn giữ nguyên.
+3. Sao lưu toàn bộ workspace sau khi dừng chương trình, gồm `db/`, dữ liệu CAS và các tệp kèm theo. Một bản sao DB đơn lẻ không chứa đủ PDF/bằng chứng CAS. Đặt bản sao ở vị trí khác, không chồng lên thư mục gốc.
+4. Chạy doctor đầy đủ bằng bản cũ, lưu kết quả và các hash quan trọng. Nếu đang có lỗi integrity, xử lý trước khi chuyển.
+
+## Cài riêng và kiểm tra dữ liệu cũ
+
+Làm theo bước cài wheel trong [Quick Start](QUICKSTART_vi.md), dùng một venv mới. Trong PowerShell, thay đường dẫn workspace bằng bản sao kiểm thử của bạn:
+
+```powershell
+$rp = "$HOME\Downloads\.venv-reprovane\Scripts\reprovane.exe"
+$ws = "$HOME\Documents\existing-review-copy"
+& $rp --version
+& $rp doctor --offline --workspace "$ws" --full
+& $rp verify --offline --workspace "$ws"
+```
+
+Kỳ vọng version `2.0.0`, schema `13`, không thêm migration và không có vi phạm khóa ngoại. Lệnh kiểm tra dùng bản chụp DB tạm; không chuyển đổi quyết định, không niêm phong lại run, không thay thành viên corpus hay xếp hạng PDF. Không cần chạy `legacy migrate` hoặc `workspace upgrade` chỉ vì đổi tên. `legacy migrate` dành cho dữ liệu tiền nhiệm v4, không dành cho workspace ScholarFlow 1.
+
+## Các tên trên đĩa phải giữ nguyên
+
+- `db/litintel.sqlite` vẫn là cơ sở dữ liệu.
+- `.litintel-writer.lock` vẫn là khóa writer thực tế của bản 1.0.0 và bản 2.0.0. Một số tài liệu cũ gọi nhầm là `.scholarflow-writer.lock`; mã và wheel công khai dùng `.litintel-writer.lock`. Không tự đổi tên hoặc tạo thêm `.reprovane-writer.lock`.
+- Đường dẫn CAS, các ID revision, manifest corpus/release và hash cũ giữ nguyên. Không tìm-thay tên sản phẩm trong DB/JSON đã niêm phong.
+
+Đây là các locator tương thích dữ liệu, không phải thương hiệu hiện hành. Một khóa OS duy nhất bảo vệ writer; xóa tệp khóa không phải cách mở khóa an toàn.
+
+## Sửa script của bạn
+
+Đổi `from scholarflow...` thành `from reprovane...`, đổi lệnh gọi CLI và tên distribution trong công cụ cài đặt. Không đổi `OPENALEX_API_KEY`, `UNPAYWALL_EMAIL` hoặc các tên nhà cung cấp. Cài đúng wheel từ dự án này; không cài một gói trùng tên cũ trên registry để làm shim.
+
+Chỉ sau khi kiểm tra bản sao thành công mới áp dụng môi trường mới cho workspace chính. Nếu cần quay lại, dừng chương trình mới và dùng môi trường cũ với bản sao đã xác minh; không sửa lịch sử migration để ép mở dữ liệu.
+
+Kho chính thức hiện là [tvquynh/reprovane](https://github.com/tvquynh/reprovane), đã đổi tên tại chỗ và giữ nguyên lịch sử. GitHub hiện chuyển hướng URL cũ `tvquynh/scholarflow` sang kho này. Mã nguồn Reprovane 2.0.0 đã có trên main; chưa tạo tag/release v2.0.0 và chưa phát hành PyPI/TestPyPI. Chuyển hướng kho GitHub không chuyển hướng tên distribution/import/CLI cũ; tiếp tục dùng môi trường riêng như hướng dẫn ở trên.

reprovane-2.0.0/MIGRATION_TO_SCHOLARFLOW.md

@@ -0,0 +1,31 @@
+# Historical migration to ScholarFlow
+
+Historical reference: predecessor legacy v4.1.0 -> ScholarFlow 1.0.0. Commands below require the historical v1 environment. Current users start with MIGRATION_FROM_SCHOLARFLOW_1.md and USER_GUIDE_vi.md; use `reprovane legacy --help` for the retained v4 adapter.
+
+Legacy baseline: f70796d1ef6003e24ce3afa1328088cc515dc0a0. Product version is reported by `scholarflow --version` (1.0.0).
+
+V4 wrote flattened OpenAlex `_raw.jsonl` and `_raw.csv`, enriched CSV/JSONL, main/excluded/source-audit/preprint CSVs, checkpoint/summary/run-metadata JSON and fetch-oa state/log/manual/downloaded outputs and PDFs. Its raw filename does not mean exact original API bytes. A legacy main or excluded group is a historical machine filtering result, never a modern human screening decision. No legacy classification becomes ScreeningDecision, ScreeningOutcome, CorpusReleaseItem or a primary FullTextArtifact.
+
+Keep the original directory unchanged and backed up. Migration never writes there, never resumes a legacy cursor, never extracts an archive and never fuzzy-matches a title or PDF filename. Use a separate non-overlapping target. Audit inventories all ordinary files, with documented exclusions for .git, .venv, venv and __pycache__. Symlinks fail closed. Finite scope defaults: 1000 files, 64 MiB/file, 256 MiB total, 100000 rows/file; oversized sources need explicit future adapter work, not silent partial import.
+
+```powershell
+scholarflow legacy audit --source "legacy results"
+scholarflow legacy migrate --dry-run --source "legacy results"
+# Write UTF-8 without PowerShell's historical UTF-16 redirect behavior:
+scholarflow legacy plan --source "legacy results" --project-key imported-review | Set-Content -Encoding utf8 migration-plan.json
+scholarflow legacy migrate --source "legacy results" --target "ScholarFlow workspace" --plan migration-plan.json
+scholarflow legacy verify --workspace "ScholarFlow workspace" --migration-id <migration-id> --source "legacy results"
+scholarflow verify --workspace "ScholarFlow workspace" --offline
+```
+
+Dry-run emits JSON only, creates no target, and includes source version if detectable, exact relative inventory/size/SHA, type, row and identifier coverage, duplicates, planned objects and unsupported/manual warnings. Version is read from VERSION or the actual run-metadata tool_version field. Missing evidence reports unknown; contradictory versions are reported without guessing. A detected 4.1.0 is not a cryptographic proof of source software origin. The plan binds inventory hash, explicit adapter versions, target project/revision, all import/secret/duplicate/fulltext policies and the separate-target destination policy. The actual absolute target path is a runtime argument excluded from semantic hashes. Execution recomputes the plan/source before writing and rechecks before completion. Record order and duplicate occurrences are preserved, not guessed away.
+
+Safe `_raw`/`_enriched` rows with a valid Work ID become MANUAL_IMPORT ProviderRecords in a LEGACY_V4_IMPORT snapshot. Original file bytes, row ordinals and canonical row hashes are preserved. Complete attached Work objects, if present within those families, use the accepted OpenAlex typed normalizer. Actual v4 flat rows use the separately named legacy-v4-flat profile for explicitly present publication identifiers, metadata and venue descriptions. Flattened author strings and OA/venue ranking/status fields remain exact legacy evidence; no reconstructed authorship positions, collection membership or quartile authority is manufactured. Original OpenAlex request SHA stays null, explicitly LEGACY_INCOMPLETE_REQUEST_PROVENANCE; the hashed plan is the migration import spec, not a claimed original request. Query/cursor metadata stays historical. Stage03 generates/evaluates conservative identity candidates; ambiguous/conflicting rows retain Stage03 behavior. A later live acquisition uses a new Stage07 spec and fresh cursor identity.
+
+LegacyMigrationRun/Artifact/RecordMap/Warning tables bind exact source fingerprint and plan to project/revision, snapshot and Stage03 resolution. Files containing recognized secrets/private paths are hash-inventoried but not copied; config/logs and unsupported artifacts are not copied. Detection is conservative (whole-file refusal can include false positives) and cannot recognize every unknown secret. Known runtime credential values are checked without printing. Filenames with secret-like content are anonymized and not copied. Reconfigure OPENALEX_API_KEY and UNPAYWALL_EMAIL in runtime/User environment; never paste values into the plan.
+
+Main/excluded CSVs and venue/source statuses are historical-only artifacts. Downloaded PDFs are SHA-inventoried/copied only as LEGACY_FULLTEXT_UNBOUND evidence, without primary selection or matching. Modern full text requires an exact sealed corpus handoff and frozen Stage11B policy; manual ingest remains unimplemented. Unknown files are listed as UNSUPPORTED_ARTIFACT, not hidden. ZIP/archive inputs remain unsupported attachments; migrate an ordinary already-prepared directory.
+
+A migration first commits an OPEN ledger entry, then transactionally imports the logical phase, verifies source/CAS/maps/observations/snapshot/Stage03/warnings and manifest, and commits COMPLETE. A failure rolls back semantic import and leaves OPEN (or an earlier pre-creation failure), never success; orphan CAS objects can remain from pre-registration placement. Same source+same plan into its owned target reuses verified completed state or resumes the rolled-back OPEN state. A different plan requires another target. Verification can check the target without the source, but source-drift verification requires `--source`.
+
+Rollback: keep using the unchanged v4 source. Preserve an incomplete target for diagnosis; use a new target for changed inputs/policy. Never delete the original. For existing modern DB upgrades, use `scholarflow workspace upgrade` with separate source/target/backup directories (see operations). Backups do not include private configuration or duplicate immutable CAS; the upgrade target gets a verified CAS copy. Do not manually rewrite old migration hashes or promote old classifications into new decisions.

reprovane-2.0.0/OLD_REPOSITORY_ARCHIVE_NOTICE.md

@@ -0,0 +1,7 @@
+# Predecessor archive notice — unpublished draft
+
+For a human to publish only after ScholarFlow final acceptance:
+
+> This repository has been superseded by ScholarFlow. It remains archived for reproducibility and historical provenance. New development continues at https://github.com/tvquynh/scholarflow.
+
+This file is a draft. Bootstrap preparation does not create the successor repository, archive/delete the predecessor, change remotes, push, tag, merge, create a GitHub Release or upload to PyPI. The human workflow is to create/import/verify the new repository after acceptance, then archive the predecessor and add the successor notice, and release ScholarFlow 1.0.0 only when approved.

reprovane-2.0.0/OPERATIONS.md

@@ -0,0 +1,71 @@
+# Vận hành Reprovane
+
+Đọc [Quick Start](QUICKSTART_vi.md) để cài và [hướng dẫn sử dụng](USER_GUIDE_vi.md) để thực hiện đề tài. Reprovane dùng Python 3.11+, `requests>=2.31,<3`, `pypdf>=6,<7`. Mã nguồn bản 2.0.0 đã có trên main của kho chính thức `tvquynh/reprovane`; chưa tạo tag/release v2.0.0 và chưa phát hành trên PyPI/TestPyPI. Các ví dụ `reprovane` dưới đây cần môi trường đã cài được đưa vào PATH; người mới dùng đường dẫn `$rp` như Quick Start.
+
+## Nhận diện đúng thư mục và trạng thái
+
+Thư mục cài chứa chương trình; workspace chứa dữ liệu nghiên cứu. Đừng trộn chúng. Ghi lại đường dẫn workspace, phiên bản phần mềm, project/revision/run ID và hash manifest trong sổ theo dõi của nhóm. Trong PowerShell, `Get-Location` cho biết thư mục đang đứng; dùng đường dẫn tuyệt đối có dấu nháy để tránh thao tác nhầm.
+
+```text
+reprovane --version
+reprovane doctor --offline --workspace "research workspace" --full
+reprovane verify --offline --workspace "research workspace"
+```
+
+`--version` là 2.0.0; workspace hiện hành phải có schema 13, không có vi phạm khóa ngoại. `doctor --full` kiểm tra toàn bộ đối tượng đã niêm phong; doctor mặc định chỉ lấy mẫu một đối tượng mỗi nhóm. Workspace mới có sealed_count bằng 0 là bình thường. `database: ABSENT` yêu cầu kiểm tra đường dẫn, không phải lý do tự xóa/tạo lại dữ liệu. Trạng thái cấu hình chỉ báo biến hiện diện trong process, không đọc/in key Windows User environment.
+
+## Quy trình và chỗ có mạng
+
+| Nhóm lệnh | Công việc | Kết nối |
+|---|---|---|
+| workspace, project | Khởi tạo, mô tả đề tài, revision | Ngoại tuyến |
+| acquisition | Lấy/resume OpenAlex có giới hạn | Acquire/resume có mạng; inspect không |
+| resolution, venue-resolution | Phân giải bảo thủ, niêm phong bằng chứng | Ngoại tuyến |
+| scimago, venue-data | Đồng bộ nguồn ghim, import/resolve/query riêng từng provider | Sync cần mạng trừ chế độ offline/cache |
+| discovery, frontier | Nguồn gốc phát hiện, trích dẫn, mở rộng có giới hạn | Các bước mở rộng/chạy acquisition có mạng |
+| search-validation | So sánh chiến lược/sentinel | Ngoại tuyến trên acquisition có sẵn |
+| screening | Packet, quyết định của người, phân xử | Ngoại tuyến |
+| corpus | Đóng băng thành viên/metadata, export | Ngoại tuyến |
+| fulltext | Kế hoạch và thu nhận OA cho corpus | Discover/acquire có thể có mạng; verify/export không |
+| legacy | Audit/plan/migrate bản v4 sang workspace riêng | Ngoại tuyến |
+
+Chạy `reprovane <nhóm> --help`, rồi `reprovane <nhóm> <lệnh> --help` để xem tham số. Các nhãn `<...>` trong mô tả là chỗ cần thay, không chép dấu ngoặc vào PowerShell. Read-only inspect/verify/doctor dùng bản chụp DB tạm và không thay byte dữ liệu nguồn. API trực tiếp cần quản lý khóa như mục sau.
+
+## Một writer và khóa trên đĩa
+
+Khóa thực tế là **`.litintel-writer.lock`**, giữ nguyên từ wheel công khai ScholarFlow 1.0.0. Tài liệu cũ ghi `.scholarflow-writer.lock` là sai tên thực tế; không tạo thêm `.reprovane-writer.lock`. DB vẫn là `db/litintel.sqlite`. Đây là tên tương thích định dạng, không cần “dọn sạch” để đổi thương hiệu.
+
+CLI ghi giữ khóa của hệ điều hành; tệp tồn tại chỉ là metadata, không chứng minh còn writer. Khi tiến trình đóng/crash, OS nhả khóa nhưng tệp có thể còn. Nếu báo active writer, tìm và dừng đúng chương trình theo cách bình thường, chờ nó đóng rồi doctor lại. Không xóa lock hoặc kill hàng loạt tiến trình để ép chạy. API Python trực tiếp phải giữ `reprovane.operations.lock.workspace_lock()` bao quanh các bước ghi liên quan. Không chạy hai phiên bản cùng ghi một workspace. Ổ mạng hoặc writer cũ không tham gia cơ chế khóa không được chứng nhận an toàn.
+
+## Sao lưu thường ngày
+
+1. Dừng mọi CLI/script/notebook đang dùng workspace, chờ kết thúc ghi.
+2. Sao chép **toàn bộ workspace** sang thư mục riêng có ngày/giờ. Giữ `db/` và toàn bộ CAS cùng nhau; không chỉ sao chép tệp SQLite khi còn writer/WAL đang thay đổi.
+3. Chạy doctor/verify trên bản sao và lưu kết quả. Giữ bản gốc; đừng dùng bản sao duy nhất làm nơi thử nghiệm.
+4. Giữ ít nhất một bản ngoài ổ đang làm việc theo chính sách nhóm. Không đưa API key hay cấu hình riêng tư vào kho Git/ZIP chia sẻ.
+
+CAS là kho nội dung theo hash, chứa bằng chứng thô và artifact; mất CAS thì DB riêng lẻ không phục hồi đủ dữ liệu. Bản sao đầy đủ có thể chứa bài/bằng chứng nhạy cảm: kiểm soát quyền truy cập.
+
+## Upgrade có backup và phục hồi
+
+Đổi tên 1.0.0 → 2.0.0 không cần upgrade schema. Khi có nhu cầu upgrade thực sự, dùng ba thư mục tách rời, không lồng nhau:
+
+```text
+reprovane doctor --offline --workspace "current workspace" --full
+reprovane workspace upgrade --workspace "current workspace" --target "upgraded workspace" --backup "verified DB backup"
+reprovane verify --offline --workspace "upgraded workspace"
+```
+
+Nguồn giữ nguyên. SQLite backup API tạo bản sao DB đầy đủ về trạng thái giao dịch; kiểm hash và migration history. Thư mục backup này **không nhân bản CAS**, còn target vận hành nhận CAS đã kiểm tra. Vì vậy giữ CAS gốc cùng DB backup. Private config/logs không được chuyển. Target thiếu upgrade manifest xác minh là chưa hoàn tất; không sử dụng như bản thành công. Replay chỉ dùng lại target nếu fingerprint/backup và mọi kiểm tra vẫn khớp; thay nguồn thì chọn target mới.
+
+Cách phục hồi dễ nhất là dùng bản sao toàn workspace đã xác minh ở thư mục mới. Nếu người quản trị phục hồi từ DB backup riêng, đặt DB vào đúng `db/litintel.sqlite` của workspace mới và khôi phục CAS nguyên gốc tương ứng, rồi doctor/verify đầy đủ. Không đổi thành `db/reprovane.sqlite` hoặc chỉnh tay lịch sử migration. Nếu integrity vẫn lỗi, giữ nguyên bằng chứng và nhờ người phụ trách; không chạy ghi tiếp.
+
+## Đọc lỗi và xin hỗ trợ
+
+Root CLI trả 0 khi thao tác thành công; 2 khi cấu hình/validation/lock không hợp lệ; 3 khi integrity/history sai; 4 cho lỗi vận hành/transport ở root scimago; 5 cho lỗi thực thi migration. Các CLI được route giữ mã an toàn 2 của module; không có mã thoát chung thể hiện include/exclude khoa học. Xem trạng thái acquisition đã lưu khi gặp lỗi mạng; không in response riêng tư ra màn hình để đoán.
+
+Trước khi gửi issue, chạy offline doctor, lưu version, tên lệnh, mã thoát và các trường trạng thái đã bỏ dữ liệu riêng. Không gửi key, header Authorization, cookie, đường dẫn tài khoản cá nhân, DB/PDF thật. Nếu thao tác tạo đối tượng đã thành công mà lệnh kế tiếp lỗi, inspect bằng ID có sẵn trước khi chạy lại create.
+
+## Giới hạn tái lập
+
+Suite E2E dùng ID và đồng hồ cố định **chỉ trong fixture**. Production vẫn sinh ID ngẫu nhiên, tham gia manifest; hai lần chạy độc lập không được hứa có cùng hash. Checksum kiểm nội dung so với hash đáng tin, không phải chữ ký nguồn, bảo đảm quyền sao chép hay chứng minh khoa học. Export từ chối symlink/tệp xung đột; dùng đích mới cho nội dung khác. UTF-8 cho JSON/JSONL/Markdown, CSV xác định dùng LF. Không sửa bytes đã niêm phong để “đẹp” hơn.

reprovane-2.0.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: reprovane
+Version: 2.0.0
+Summary: Reprovane — Reproducible literature discovery, screening, and evidence management.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tvquynh/reprovane
+Project-URL: Repository, https://github.com/tvquynh/reprovane
+Project-URL: Issues, https://github.com/tvquynh/reprovane/issues
+Project-URL: Documentation, https://github.com/tvquynh/reprovane#documentation
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.31
+Requires-Dist: pypdf<7,>=6
+Dynamic: license-file
+
+# Reprovane
+
+Reproducible literature discovery, screening, and evidence management.
+
+Reprovane is an open-source tool that helps researchers collect literature,
+record review decisions, freeze a review corpus, and organize eligible
+open-access full text with a traceable record of the work.
+
+**Reprovane 2.0.0 is the first public release of Reprovane.**
+
+Human reviewers remain responsible for screening and study inclusion decisions.
+
+## What you can do
+
+- Search and collect literature from OpenAlex with reproducible provenance.
+- Expand your search through backward and forward citations.
+- Track venue evidence from SCImago, Scopus, and Web of Science.
+- Record human screening decisions and resolve reviewer disagreements.
+- Freeze a review corpus with its selected studies and supporting metadata.
+- Find eligible open-access full text and keep unresolved items in a manual queue.
+- Check the integrity of your workspace and exported results.
+
+## Install
+
+Requires **Python 3.11 or newer**.
+
+```bash
+pip install reprovane
+```
+
+You can also install a Reprovane wheel from [GitHub Releases](https://github.com/tvquynh/reprovane/releases).
+For a separate Python environment and Windows setup, follow the
+[Vietnamese Quick Start](QUICKSTART_vi.md).
+
+## Quick start
+
+```bash
+reprovane --version
+reprovane doctor --offline
+reprovane workspace init --workspace "my-review"
+```
+
+These first steps work offline and do not need an API key.
+Continue with the [Quick Start](QUICKSTART_vi.md) to create your first project,
+then use the [User Guide](USER_GUIDE_vi.md) for a complete review workflow.
+
+## How Reprovane works
+
+Define your project → collect literature → follow citations → review studies
+→ freeze your corpus → organize full text → verify and export.
+
+Keep your search plans and reviewer decisions alongside the results so the
+review process can be inspected later. Full-text availability does not decide
+whether a study belongs in your review.
+
+## Documentation
+
+- [Quick Start — Windows, Linux, and macOS](QUICKSTART_vi.md)
+- [User Guide — from search to corpus and full text](USER_GUIDE_vi.md)
+- [Operations — backups, recovery, and troubleshooting](OPERATIONS.md)
+- [Security and privacy](SECURITY.md)
+- [Third-party data and redistribution](THIRD_PARTY_DATA.md)
+- [Changelog](CHANGELOG.md)
+
+For development and architecture details, see [Architecture](ARCHITECTURE.md).
+Source and issues: [tvquynh/reprovane](https://github.com/tvquynh/reprovane).
+
+## License
+
+Reprovane is available under the [MIT License](LICENSE).

reprovane-2.0.0/PROVENANCE.md

@@ -0,0 +1,27 @@
+# Reprovane provenance
+
+Lineage: **OpenAlex Literature Intelligence 4.1.0 → ScholarFlow 1.0.0 → Reprovane 2.0.0**.
+
+Reprovane 2.0.0 is the breaking distribution/import/CLI rebrand of the accepted ScholarFlow 1.0.0 source at commit `95120023dc738021963b8b1f78f81a7cfd6b2d4b`, tree `74d34d63588dfb05385c950f96c6e0d37decd3b7`. Scientific semantics, schema13, migration bytes, database/CAS paths and the actual `.litintel-writer.lock` locator remain unchanged. No `.reprovane-writer.lock` is introduced. Old documentation's `.scholarflow-writer.lock` wording did not match the shipped v1 implementation and is corrected here.
+
+The rebrand was merge-committed into main and the same GitHub repository was renamed in place to `tvquynh/reprovane`. Its canonical URL is https://github.com/tvquynh/reprovane. GitHub currently redirects the former `tvquynh/scholarflow` repository URL. Reprovane 2.0.0 source is on main; no v2.0.0 tag/release or PyPI/TestPyPI publication has occurred. Historical v1 stable/RC tags, release IDs and assets remain intact. The predecessor remains archived and unchanged.
+
+The ScholarFlow repository began as a separate bootstrap, not imported predecessor Git ancestry. Reprovane continues that same repository's history. The following historical bootstrap record is preserved as a dated account of that transition; statements about unpublished bootstrap activity describe that earlier milestone, not the present remote state.
+
+## Historical ScholarFlow bootstrap record
+
+# ScholarFlow provenance
+
+ScholarFlow is the successor to `tvquynh/openalex-literature-intelligence`, not a v5 rename-in-place. The predecessor's legacy/tool baseline is v4.1.0; architecture development continued through the technically accepted Stage12 implementation. ScholarFlow starts its own product version line at 1.0.0, beginning with 1.0.0rc1.
+
+- Legacy baseline: `f70796d1ef6003e24ce3afa1328088cc515dc0a0`.
+- Accepted Stage11B baseline: `87da7dff3e2ddc6dcbac0ec5fe6e8dd8241f88b5`, tree `2df6fd9a777422b5c686f42e6f3864d6d797a62a`.
+- Technically accepted Stage12 implementation: `6ad3dde25d2a7a6e21591e8e6f131f3885b62ce7`, tree `0223eb31cc71d7dc18c449157d9ea20a1c9b2818`.
+
+The predecessor Stage12 technical candidate was 5.0.0rc1; that artifact is not a ScholarFlow release. No scientific identity, screening, corpus, provider or full-text policy is redesigned here. All thirteen SQL migration filenames/order/bytes are retained. The schema version remains 13 while the product line resets to 1.
+
+Technical workspace compatibility allowlist: `db/litintel.sqlite` and `.litintel-writer.lock` are established on-disk format/locking locators, not product/package/CLI names. Keeping them permits schema13 workspaces and writer exclusion to interoperate without an artificial data migration. Only those exact filename literals remain in the canonical namespace; no runtime import requires the predecessor package.
+
+All accepted semantic tests are ported to scholarflow. Historical CLI/config regression references are retained under tests/legacy_reference solely to preserve scientific coverage; they are excluded from runtime wheel/sdist and are not installed console commands. Historical manuals/notices are isolated in docs/legacy/. Copyright/license notices retain their original attribution.
+
+Intended successor repository: https://github.com/tvquynh/scholarflow. No repository has been created or pushed by this bootstrap. The release manifest records deterministic bootstrap tree/hash and artifact hashes externally to avoid self-referential source hashes. Final acceptance and any later stable release remain human/review actions.

reprovane-2.0.0/QUICKSTART_vi.md

@@ -0,0 +1,137 @@
+# Bắt đầu với Reprovane
+
+Hướng dẫn này giúp bạn cài Reprovane, tạo nơi lưu dữ liệu và lập hồ sơ đề tài đầu tiên. Bài thực hành chưa tìm bài hay tải PDF, nên không cần API key.
+
+## 1. Chuẩn bị
+
+Cần **Python 3.11 trở lên**, kết nối mạng để cài phần mềm và một thư mục bạn có quyền ghi. Mở **Windows PowerShell** từ menu Start. Chép từng khối lệnh, chờ chạy xong rồi làm bước tiếp; không chép dấu `PS>` của cửa sổ PowerShell và không gõ vào dấu nhắc `>>>` của Python.
+
+```powershell
+python --version
+```
+
+Nếu không tìm thấy Python hoặc Windows mở Microsoft Store, cài Python từ trang chính thức rồi mở lại PowerShell. Máy có Python Launcher có thể dùng `py -3 --version` và thay `python -m venv` bằng `py -3 -m venv` ở bước sau.
+
+## 2. Cài Reprovane vào môi trường riêng
+
+Tạo một thư mục làm việc trong Documents. Môi trường riêng giữ phần mềm và thư viện của Reprovane tách khỏi các công việc Python khác. Các lệnh dưới đây không cần kích hoạt môi trường hay đổi Execution Policy.
+
+```powershell
+$base = "$HOME\Documents\Reprovane"
+New-Item -ItemType Directory -Force "$base" | Out-Null
+Set-Location "$base"
+$env:PYTHONUTF8 = "1"
+python -m venv .venv-reprovane
+.\.venv-reprovane\Scripts\python.exe -m pip install --upgrade pip
+.\.venv-reprovane\Scripts\python.exe -m pip install reprovane
+$rp = ".\.venv-reprovane\Scripts\reprovane.exe"
+& $rp --version
+& $rp doctor --offline
+```
+
+Phiên bản của hướng dẫn là `2.0.0`. Doctor in một bản ghi JSON gồm tên trường và giá trị; `offline: true`, `python_supported: true`, các thư viện trong `dependencies` có giá trị `true` là kết quả mong đợi. Thông báo chưa có API key không cản trở bài thực hành này.
+
+Nếu Windows báo Application Control chặn `reprovane.exe`, dùng cách gọi Python module ở mục xử lý lỗi bên dưới rồi tiếp tục. Không cần tắt chính sách bảo vệ máy.
+
+## 3. Tạo workspace và đề tài
+
+**Workspace** là thư mục chứa dữ liệu nghiên cứu, khác với thư mục cài phần mềm. Dùng thư mục mới cho bài thực hành; giữ dấu nháy quanh đường dẫn có khoảng trắng.
+
+```powershell
+$ws = Join-Path $base "my-review"
+& $rp workspace init --workspace "$ws"
+& $rp doctor --offline --workspace "$ws"
+$project = (& $rp project create --workspace "$ws" --key practice-review --display-name "Đề tài thực hành" | ConvertFrom-Json)
+if ($LASTEXITCODE -ne 0) { throw "Chưa tạo được đề tài; dừng và đọc thông báo." }
+$project.project_id
+```
+
+Giữ ID vừa in ra: đó là mã riêng của đề tài này. Nếu đã tạo thành công, không chạy lại `project create` với cùng key; dùng ID đã lưu hoặc bắt đầu bài thử trong workspace mới. Workspace chưa có bài sau bước này là bình thường.
+
+Tạo bản mô tả câu hỏi. Đây là hồ sơ thực hành; nhóm sẽ lập kế hoạch tìm kiếm và tiêu chí sàng lọc riêng trước khi làm nghiên cứu thật.
+
+```powershell
+$manifest = Join-Path $base "practice-project.json"
+@'
+{
+  "title": "Đề tài thực hành",
+  "question": "Câu hỏi nghiên cứu sẽ được nhóm hoàn thiện trước khi thu thập",
+  "status": "TRAINING_ONLY"
+}
+'@ | Set-Content -Encoding utf8 "$manifest"
+$revision = (& $rp project revision --workspace "$ws" --project-id $project.project_id --number 1 --manifest "$manifest" | ConvertFrom-Json)
+if ($LASTEXITCODE -ne 0) { throw "Chưa tạo được phiên bản đề tài." }
+$revision.revision_id
+& $rp project inspect --workspace "$ws" --project-id $project.project_id
+& $rp verify --offline --workspace "$ws"
+```
+
+**Revision** là phiên bản đã lưu của mô tả đề tài. Khi thay câu hỏi, tạo revision mới để giữ lại lịch sử. Lệnh inspect cho phép đọc lại thông tin; verify kiểm tra dữ liệu đã có.
+
+## 4. Mở lại và tiếp tục
+
+Đóng PowerShell không xóa dữ liệu. Lần sau mở cửa sổ mới, đặt lại đường dẫn và chế độ tiếng Việt:
+
+```powershell
+$base = "$HOME\Documents\Reprovane"
+Set-Location "$base"
+$env:PYTHONUTF8 = "1"
+$rp = ".\.venv-reprovane\Scripts\reprovane.exe"
+$ws = Join-Path $base "my-review"
+& $rp doctor --offline --workspace "$ws"
+& $rp --help
+```
+
+Đọc [Hướng dẫn sử dụng](USER_GUIDE_vi.md) để tiếp tục thu thập, theo dõi trích dẫn, sàng lọc và xuất tập bài. Con người quyết định đưa bài vào nghiên cứu; công cụ lưu bằng chứng và kết quả của quy trình đó.
+
+## Khi bị lỗi
+
+| Hiện tượng | Cách xử lý |
+|---|---|
+| Không tìm thấy Python hoặc tệp chương trình | Kiểm tra Python và thư mục đang đứng bằng `Get-Location`; quay lại thư mục `$base`. |
+| Cài đặt lỗi mạng | Kiểm tra mạng/proxy rồi chạy lại bước cài. Xem cách cài từ wheel nếu dùng tệp tải từ GitHub Releases. |
+| API key chưa được cấu hình | Tiếp tục bài ngoại tuyến; cấu hình key khi đến bước tìm kiếm trong User Guide. |
+| Writer đang hoạt động | Chờ chương trình đang dùng workspace kết thúc; không xóa tệp khóa để ép chạy. |
+| Doctor báo database ABSENT | Kiểm tra `$ws` có đúng thư mục đã khởi tạo không. |
+| Lệnh lỗi khi in tên tiếng Việt | Đặt `$env:PYTHONUTF8 = "1"` trước khi chạy; inspect trạng thái đã có trước khi tạo lại đối tượng. |
+| Integrity verification failed | Dừng ghi dữ liệu, giữ nguyên thư mục và xem [hướng dẫn phục hồi](OPERATIONS.md). |
+
+Nếu Application Control chặn launcher, dùng cùng CLI qua Python đã được cho phép:
+
+```powershell
+$py = ".\.venv-reprovane\Scripts\python.exe"
+& $py -m reprovane --version
+& $py -m reprovane doctor --offline
+```
+
+Ở các bước còn lại, thay `& $rp` bằng `& $py -m reprovane`, giữ nguyên mọi tham số phía sau. Khi mở cửa sổ mới, quay lại `$base` và đặt lại `$py`.
+
+Khi nhờ hỗ trợ, gửi tên lệnh, mã thoát và thông báo đã bỏ thông tin riêng tư. Không gửi API key, mật khẩu, cookie, cơ sở dữ liệu hoặc PDF nghiên cứu vào issue công khai.
+
+## Cài từ GitHub Releases hoặc dùng ngoại tuyến
+
+Nếu chọn wheel Reprovane từ [GitHub Releases](https://github.com/tvquynh/reprovane/releases), cài vào môi trường trên bằng lệnh sau, thay đường dẫn bằng nơi bạn lưu tệp:
+
+```powershell
+.\.venv-reprovane\Scripts\python.exe -m pip install "C:\Downloads\reprovane-2.0.0-py3-none-any.whl"
+```
+
+Máy không có mạng cần chuẩn bị cả các thư viện phụ thuộc. Xem [Operations](OPERATIONS.md) cho hướng dẫn cài ngoại tuyến, kiểm tra tệp và sao lưu.
+
+## Trên Linux/macOS
+
+Dùng `python3 -m venv .venv-reprovane`, `.venv-reprovane/bin/python -m pip install reprovane`, rồi `.venv-reprovane/bin/reprovane --version`. Các tham số CLI giữ nguyên; thay biến/đường dẫn PowerShell bằng cú pháp shell của bạn. Không chép nguyên `& $rp` sang Bash.
+
+## Advanced: build from source
+
+Dành cho người đã cài Git và muốn tự build. Chọn thư mục mới cho mã nguồn, rồi chạy:
+
+```powershell
+git clone --branch main --single-branch https://github.com/tvquynh/reprovane.git reprovane-source
+Set-Location .\reprovane-source
+python -m venv .venv-build
+.\.venv-build\Scripts\python.exe -m pip install build
+.\.venv-build\Scripts\python.exe -m build
+```
+
+Wheel nằm trong `dist`. Xem [Architecture](ARCHITECTURE.md) cho tài liệu kỹ thuật và [Operations](OPERATIONS.md) cho kiểm tra bản cài.

reprovane-2.0.0/README.md

@@ -0,0 +1,70 @@
+# Reprovane
+
+Reproducible literature discovery, screening, and evidence management.
+
+Reprovane is an open-source tool that helps researchers collect literature,
+record review decisions, freeze a review corpus, and organize eligible
+open-access full text with a traceable record of the work.
+
+**Reprovane 2.0.0 is the first public release of Reprovane.**
+
+Human reviewers remain responsible for screening and study inclusion decisions.
+
+## What you can do
+
+- Search and collect literature from OpenAlex with reproducible provenance.
+- Expand your search through backward and forward citations.
+- Track venue evidence from SCImago, Scopus, and Web of Science.
+- Record human screening decisions and resolve reviewer disagreements.
+- Freeze a review corpus with its selected studies and supporting metadata.
+- Find eligible open-access full text and keep unresolved items in a manual queue.
+- Check the integrity of your workspace and exported results.
+
+## Install
+
+Requires **Python 3.11 or newer**.
+
+```bash
+pip install reprovane
+```
+
+You can also install a Reprovane wheel from [GitHub Releases](https://github.com/tvquynh/reprovane/releases).
+For a separate Python environment and Windows setup, follow the
+[Vietnamese Quick Start](QUICKSTART_vi.md).
+
+## Quick start
+
+```bash
+reprovane --version
+reprovane doctor --offline
+reprovane workspace init --workspace "my-review"
+```
+
+These first steps work offline and do not need an API key.
+Continue with the [Quick Start](QUICKSTART_vi.md) to create your first project,
+then use the [User Guide](USER_GUIDE_vi.md) for a complete review workflow.
+
+## How Reprovane works
+
+Define your project → collect literature → follow citations → review studies
+→ freeze your corpus → organize full text → verify and export.
+
+Keep your search plans and reviewer decisions alongside the results so the
+review process can be inspected later. Full-text availability does not decide
+whether a study belongs in your review.
+
+## Documentation
+
+- [Quick Start — Windows, Linux, and macOS](QUICKSTART_vi.md)
+- [User Guide — from search to corpus and full text](USER_GUIDE_vi.md)
+- [Operations — backups, recovery, and troubleshooting](OPERATIONS.md)
+- [Security and privacy](SECURITY.md)
+- [Third-party data and redistribution](THIRD_PARTY_DATA.md)
+- [Changelog](CHANGELOG.md)
+
+For development and architecture details, see [Architecture](ARCHITECTURE.md).
+Source and issues: [tvquynh/reprovane](https://github.com/tvquynh/reprovane).
+
+## License
+
+Reprovane is available under the [MIT License](LICENSE).

reprovane-2.0.0/SECURITY.md

@@ -0,0 +1,17 @@
+# Bảo mật khi dùng Reprovane
+
+## Người sử dụng cần làm gì?
+
+Chỉ cài wheel đúng nguồn và đối chiếu hash. Để `OPENALEX_API_KEY` và `UNPAYWALL_EMAIL` trong runtime/User environment; không ghi giá trị vào source, plan, workspace, báo cáo hoặc URL chia sẻ. Doctor chỉ báo có/không trong process. Không gửi key, mật khẩu, header Authorization, cookie, hồ sơ trình duyệt hoặc DB/PDF thật lên issue công khai. Khi cần báo lỗi nhạy cảm, trước hết liên hệ người duy trì để thống nhất kênh riêng; không giả định dự án có hộp thư bảo mật chuyên dụng.
+
+Đọc [Quick Start](QUICKSTART_vi.md) để cài, [User Guide](USER_GUIDE_vi.md) để thao tác và [Operations](OPERATIONS.md) để sao lưu. Dừng tiến trình ghi trước khi sao lưu; giữ DB và CAS. Không sửa SQL/manifest, xóa lock để vượt kiểm tra hoặc ép nhận PDF bị từ chối.
+
+## Ranh giới thu nhận toàn văn
+
+Fulltext transport ghim IP công khai đã phân giải, xác thực TLS theo hostname gốc, kiểm tra redirect và giới hạn request/byte/retry/redirect. PDF phải đạt kiểm tra cấu trúc. Mặc định từ chối submitted/unknown version, không scrape landing page, không vượt paywall/anti-bot, không dùng AI/OCR dự phòng. Không tự động hóa login/SSO/cookie của cơ quan. URL và metadata nguồn là dữ liệu chưa đáng tin. Response chứa bí mật nhận diện được hoặc signed URL secret bị từ chối. Heuristic bảo mật không bảo đảm nhận diện mọi bí mật chưa biết.
+
+## Ranh giới dữ liệu và filesystem
+
+Legacy migration chỉ nhận thư mục thường, có giới hạn, copy-on-write và từ chối symlink; không giải nén archive hay thực thi pickle/eval/payload. Secret/config/log của legacy được kiểm kê bằng hash thay vì sao chép. SQL bind tham số; tên bảng/cột động từ allowlist nội bộ. CLI writer dùng khóa OS; API trực tiếp phải tham gia cùng khóa. Export bất biến từ chối symlink/bytes xung đột. Filesystem có tiến trình đối kháng đồng thời và giới hạn CPU/RAM của parser PDF không được chứng nhận. DB-only backup cần CAS nguyên gốc riêng để khôi phục đủ.
+
+Reprovane không cài CLI lịch sử hoặc shim package cũ. Mã execution tiền nhiệm chỉ ở tham chiếu test, không nằm trong wheel/sdist. Checksum chứng minh nhất quán với hash đáng tin, không xác thực nhà xuất bản hoặc quyền phân phối. Xem [Third-party data](THIRD_PARTY_DATA.md) trước khi chia sẻ dữ liệu.

reprovane-2.0.0/THIRD_PARTY_DATA.md

@@ -0,0 +1,9 @@
+# Dữ liệu từ bên thứ ba
+
+Reprovane xử lý metadata OpenAlex và các bằng chứng nguồn xuất bản được cấu hình, gồm SCImago, Scopus, Web of Science; fulltext có thể dùng Unpaywall khi được bật. Dự án không đóng gói bộ CSV SCImago hay PDF nghiên cứu thật trong wheel/sdist.
+
+Người dùng cần ghi nhà cung cấp, snapshot/ref/commit, checksum và thời điểm của bằng chứng. Một checksum hợp lệ không biến một mirror thành nguồn có thẩm quyền và không cho phép tự suy diễn membership/ranking ngoài phạm vi dữ liệu. Bộ đồng bộ GitHub dùng nguồn ghim theo hợp đồng [pinned mirror](docs/architecture/pinned_github_mirror_sync.md); đọc `reprovane scimago --help` và `reprovane venue-data --help` cho CLI hiện hành.
+
+Trước khi phân phối lại dữ liệu, metadata, corpus hoặc PDF, người phụ trách phải xem điều khoản, giấy phép, nghĩa vụ ghi nguồn và giới hạn phân phối của từng nhà cung cấp/tác phẩm. Công cụ chạy được hoặc tải thành công không phải giấy phép phân phối. Nếu chưa rõ quyền, chỉ chia sẻ báo cáo/manifest phù hợp chính sách nhóm và nhờ người phụ trách kiểm tra. Không công khai toàn bộ workspace, key hoặc URL riêng tư.
+
+Tài liệu dưới `docs/legacy/` mô tả các mirror/config/CLI của tiền nhiệm; không áp dụng tự động các cờ cũ vào Reprovane. [User Guide](USER_GUIDE_vi.md) giải thích sự khác biệt giữa bằng chứng nguồn, quyết định sàng lọc và artifact toàn văn.