Drops news's own sources (Bluesky, Mastodon, X, podcast) and the tools only they use (video, posts, walls), with the PodcastSource and segment_profile exports. scrape, article, checks, browser and framing stay: base.py imports scrape's Getter at module level and scrape imports the other four, so dropping them would mean editing the plugin contract. desk/README.md records the source of truth, the prune and how to refresh. All 371 tests pass. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
24 lines
1.9 KiB
Markdown
24 lines
1.9 KiB
Markdown
# desk
|
|
|
|
The plugin contract (`desk.sources`), the model task (`desk.modeltask`), the settings sections (`desk.config`), the shared models and notices, and the tools roledesk uses: `agent`, `embedding`, `http`, `failures`, `marks`.
|
|
|
|
## Source of truth
|
|
|
|
`../news/desk`. This folder is a downstream copy. A fix lands in news first and is copied here, otherwise the next refresh reverts it. The commit that brought each copy in says which news commit it came from (`from news/desk at <sha>`).
|
|
|
|
## What was pruned, and why
|
|
|
|
news's own sources and the tools only they use: `sources/bluesky.py`, `mastodon.py`, `x.py`, `podcast.py`, and `tools/video/`, `posts.py`, `walls.py`. roledesk's one plugin is `plugins/ats.py`, which imports none of them. `sources/__init__.py` drops the `PodcastSource` and `segment_profile` exports with them, and its and `tools/__init__.py`'s docstrings say what is left.
|
|
|
|
Kept although nothing in roledesk calls them: `tools/scrape.py`, because `sources/base.py` imports its `Getter` at module level, and `tools/article.py`, `checks.py`, `browser.py` and `framing.py`, because `scrape.py` imports them. Pruning them would mean editing the contract itself. `tools/credentials.py` stays because `agent.py` imports it. `sources/sources.md` and `tools/tools.md` are news's and still describe the full set.
|
|
|
|
## Refreshing
|
|
|
|
```bash
|
|
git -C ../news archive --format=tar HEAD desk | tar -x -C .
|
|
rm -rf desk/sources/bluesky.py desk/sources/mastodon.py desk/sources/x.py desk/sources/podcast.py desk/tools/video desk/tools/posts.py desk/tools/walls.py
|
|
git diff desk/sources/__init__.py desk/tools/__init__.py
|
|
```
|
|
|
|
The archive overwrites the two `__init__.py` files. If news did not change them, `git checkout -- desk/sources/__init__.py desk/tools/__init__.py` restores the pruned versions; if it did, merge its change into them by hand. Then run `uv run pytest` and commit with `from news/desk at <sha>` in the body.
|