Add MVP of one-shot implementation

[ppinchuk]

The core fundamentals for using one-shot extraction are in place.

Still TODO (future PR):

• LLM-generated website keywords
• LLM-generated keyword heuristic
• Text extractor based on extraction schema

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 39 out of 41 changed files in this pull request and generated 6 comments.

Comments suppressed due to low confidence (1)

pyproject.toml:50

• compass.utilities.io now imports yaml and toml at runtime, but neither PyYAML nor a toml package is listed in the project dependencies. This will raise ImportError in environments where they aren't installed transitively. Add the needed dependencies (or switch TOML loading to the stdlib tomllib for Python 3.12+), and consider gating YAML/TOML support behind optional extras if you don't want them in the core install set.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 53.03030% with 217 lines in your changes missing coverage. Please review.
✅ Project coverage is 56.46%. Comparing base (b44c642) to head (37168ee).

Files with missing lines	Patch %	Lines
compass/plugin/one_shot/base.py	14.49%	118 Missing ⚠️
compass/plugin/one_shot/components.py	39.39%	40 Missing ⚠️
compass/plugin/noop.py	54.05%	17 Missing ⚠️
compass/plugin/one_shot/generators.py	38.46%	16 Missing ⚠️
compass/_cli/process.py	0.00%	6 Missing ⚠️
compass/utilities/enums.py	77.77%	4 Missing and 2 partials ⚠️
compass/extraction/date.py	25.00%	3 Missing ⚠️
compass/extraction/water/plugin.py	57.14%	3 Missing ⚠️
compass/plugin/interface.py	86.95%	3 Missing ⚠️
compass/_cli/finalize.py	0.00%	2 Missing ⚠️
... and 2 more

❌ Your patch status has failed because the patch coverage (53.03%) is below the target coverage (80.00%). You can increase the patch coverage or adjust the target coverage.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #378      +/-   ##
==========================================
- Coverage   57.03%   56.46%   -0.57%     
==========================================
  Files          56       60       +4     
  Lines        4955     5366     +411     
  Branches      447      484      +37     
==========================================
+ Hits         2826     3030     +204     
- Misses       2086     2291     +205     
- Partials       43       45       +2     

Flag	Coverage Δ
unittests	56.46% <53.03%> (-0.57%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.