Files
W1---Opportunity-Intelligence/docs/VERSION-CONTROL.md
T

3.1 KiB

Version control baseline — W1-018

This repository is local only. W1-018 does not configure a remote, create a remote repository, or authorize any push. The revised work order supersedes the earlier conflicting push instruction. Publication would require a separate owner decision and a fresh review of the data being shared.

Tracked baseline

Track application source, the root command entry point, engineering instructions, tests, developer utilities, documentation, and data/opportunities.json. The pipeline includes owner-reviewed business decisions and must remain intact; local versioning is not permission to publish it.

The deliberately reviewed tests/fixtures/ corpus is included so the full regression suite runs from the baseline without network access. It is about 4.8 MB in total, with no individual file larger than 529 KB. These are the existing approved synthetic fixtures, public LRS snapshots, source manifests, seed-record snapshot, and expected brief. They are not a blanket inclusion of all historical HTML. Preserve fixture bytes because manifests and tests depend on their hashes.

Review found public-site anti-forgery form values in the two listing fixtures, not authenticated-account credentials. Other password-related matches describe help-desk job duties. No private applicant records or credential assignments were identified in the proposed baseline. Source/public contact information and the already approved pipeline remain present; no fixture was sanitized or altered.

Historical evidence

All of runs/ is ignored by Git, including the 107 previously verified artifacts, later verification output and archived source copies. Existing files stay at their original paths and are not deleted, normalized, rewritten or force-added. A Git clone does not contain this local archive. Preserve it separately through the owner's backup process; .gitignore is not a backup or access control. No backup service or data transfer is introduced by this work order.

Before including any future run artifact, review provenance, private information, credentials, size and necessity. Prefer a narrowly selected, documented fixture or summary over a whole run directory. Do not use git add -f runs/ as a shortcut.

tools/verify_refactor.py is the preserved one-time W1-017 utility and requires the local archive. Routine baseline validation uses the self-contained fixtures:

python -m unittest discover -s tests -v

Ignore and byte policies

.gitignore excludes Python caches/bytecode, virtual environments, build and test output, local editor state, .local/ diagnostics, temporary files, environment files and common credential/key paths. These patterns reduce accidents but do not replace inspection of git diff --cached before a commit.

.gitattributes preserves exact pipeline and fixture bytes. Source and operating documentation use LF text normalization in future checkouts. No application or test logic is changed by this work order.

Local W1-018 inspection inventories, hash checks and test results are kept in .local/w1-018/; they are intentionally not part of the project baseline.