# 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 `). ## 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 ` in the body.