@andrioid/paseo-attention-span 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andri Óskarsson
+
+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.

package/OVERVIEW.md

@@ -0,0 +1,63 @@
+Attention Span lists the GitHub issues and pull requests that are waiting on you, grouped by why they need you, and starts Paseo agent sessions to act on them. It is for when your attention is spread thin: a short list of what needs you now instead of a stream of notifications.
+
+## What it shows
+
+The screen has four tabs. A sidebar entry, Attention, shows how many items need you.
+
+- **Doing:** what needs you, in sections: waiting for your reply, review requested, CI failing, changes requested, ready to merge, needs upstream, waiting too long, and your drafts. Each item appears once, under its most urgent reason. An issue and the pull requests that close it are one item, and so is a stack of pull requests.
+- **Waiting:** your work where someone else has the next move.
+- **Next up:** issues assigned to you, then open issues nobody has claimed, ranked by priority and effort when your org uses issue fields for them. Unclaimed issues come from the repositories you choose, or else from your Paseo projects' repositories.
+- **History:** what you finished and reviewed in recent weeks.
+
+A mention only counts while the person is still waiting for you; replying or reacting clears it. Mentions of your teams are left out. You can dismiss an item until something new happens on it.
+
+## Setup
+
+- The GitHub CLI, `gh`, must be installed and signed in on the machine that runs the Paseo daemon. The plugin uses that sign-in and stores no token of its own.
+- To start sessions, the repositories need to be registered as Paseo projects, with their GitHub remote. Items in other repositories can still be opened on GitHub.
+- Requires Paseo 0.13.0 or later. Tested on Linux.
+
+When `gh` is missing or signed out, or `config.json` can't be read, the screen shows a setup checklist instead of the lists: what's missing, how to fix it, and a button to check again. It also says what the plugin covers, how many of your projects it can start sessions in, and which agent sessions will use.
+
+It works without configuration: the lists about you cover everything on GitHub that involves you, and Next up looks for unclaimed issues in your Paseo projects' repositories.
+
+To narrow it down, choose organizations and repositories under Settings, Plugins, Attention Span, or with the gear on the screen. Each one is checked on GitHub as you add it. Next up's unclaimed issues use them too, instead of your projects.
+
+Everything else is set in `~/.config/paseo-attention-span/config.json` on the daemon host, which the settings screen also writes to:
+- `profiles`: the Paseo agent profile per session type. Reviews use `review`, everything else `default`, and a missing profile falls back to Paseo's defaults.
+- `prompts`: your own prompt template per session type, replacing the built-in one.
+- `mergeMethods`: squash, merge or rebase per repository.
+- `codeRepos`: where an issue repository's code lives, for issues kept apart from the code. The screen asks and fills this in when needed.
+- `nextUp`: which repositories to pick from, and the org issue fields for priority, effort and scope.
+- `refreshMinutes` (15), `waitingTooLongDays` (3), `staleDraftDays` (30), `mentionDays` (30) and `historyWeeks` (4).
+
+## Actions
+
+Each item has a main action, and opening it shows every action with a line saying what it will do. An agent icon marks the actions that start an agent session; the rest change GitHub right away.
+
+Agent sessions run in a worktree of the registered project, or resume the existing workspace for that branch:
+
+- **Review** reviews a pull request and reports back. Nothing is posted.
+- **Fix CI** and **Address comments** commit fixes without pushing.
+- **Rebase** rebases a pull request or a whole stack. It pushes only when there were no conflicts.
+- **Refresh draft** rebases a stale draft and says what it still needs.
+- **Start** reads an issue and proposes a plan.
+
+GitHub actions, which happen only when you tap them:
+
+- Rerun failed jobs, update a branch, mark a draft ready for review, turn on auto-merge, merge, and close a draft. Merge and close ask first.
+- React 👍 to the comments waiting on you, after reading them in full.
+- Claim or unclaim an issue.
+
+Where GitHub allows it, an Undo appears after an action.
+
+## Data
+
+- **GitHub:** the plugin reads your pull requests, review requests, mentions and issues through `gh`, scoped to the configured organizations and repositories. It refreshes every 15 minutes by default, using under 6% of GitHub's hourly API allowance.
+- **Local files:** a cache of what it shows, your dismissals and your Next up filter are kept in `~/.config/paseo-attention-span/state.json` on the daemon host.
+- **Agent providers:** when a session starts, the item's context goes into the agent's prompt. That includes descriptions, comments, review threads and failing CI logs. The prompt is sent to whichever provider the agent profile uses.
+
+## Limits
+
+- github.com only. Other forges and GitHub Enterprise are not supported yet.
+- Apart from organizations and repositories, settings are edited by hand.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+<img src="assets/icon.png" width="96" alt="">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Attention Span
+
+For when your attention is spread thin. A [Paseo](https://paseo.sh) plugin that lists the GitHub issues and pull requests waiting on you, grouped by why, and starts agent sessions to act on them.
+
+![Doing](docs/screenshots/desktop-dark-doing.png)
+
+[OVERVIEW.md](OVERVIEW.md) explains what it shows, its actions, its settings and where data goes.
+
+## Install
+
+```bash
+paseo plugin add andrioid/attention-span
+```
+
+That's the reviewed release from the Paseo plugin registry. For the unreleased latest from `main`, use `paseo plugin add git:andrioid/paseo-attention-span` instead.
+
+Then open Attention in the sidebar. Until it can reach GitHub, it shows a checklist of what's missing:
+
+- The GitHub CLI, installed and signed in on the machine that runs Paseo: `gh auth login`.
+- The repositories you work in, registered as Paseo projects, so items can start sessions.
+
+To narrow it down to some organizations and repositories, use the gear on the screen, or Settings, Plugins, Attention Span. Everything else is in `~/.config/paseo-attention-span/config.json`.
+
+![Setup](docs/screenshots/desktop-dark-setup.png)
+
+## Develop
+
+See [CONTRIBUTING.md](CONTRIBUTING.md), [requirements.yaml](requirements.yaml) and [docs/architecture.md](docs/architecture.md).
+
+## License
+
+[MIT](LICENSE)

package/assets/favicon.svg

@@ -0,0 +1,7 @@
+<svg viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" role="img" aria-label="Attention Span"><title>Attention Span</title>
+<rect width="1024" height="1024" rx="224" fill="#FEFEFE"/>
+<path d="M0 0 C14.27 11.58 23.15 25.41 32.56 41 C36.62 47.72 40.77 54.38 45 61 C61.54 86.87 77.71 112.99 93.45 139.36 C96.66 144.74 99.9 150.12 103.12 155.5 C104.39 157.6 105.65 159.71 106.91 161.81 C107.45 162.7 107.98 163.6 108.54 164.52 C110.04 167.03 111.55 169.55 113.06 172.06 C112.73 172.72 112.4 173.38 112.06 174.06 C110.82 172.77 109.57 171.48 108.29 170.14 C77.7 138.76 42.75 118.9 -1.64 117.1 C-65.62 116.63 -119.11 155.24 -163.94 197.06 C-165.32 198.35 -166.69 199.63 -168.11 200.96 C-178.47 210.65 -188.63 220.35 -197.94 231.06 C-200.27 233.4 -202.6 235.73 -204.94 238.06 C-207.28 240.72 -209.62 243.39 -211.94 246.06 C-213.56 247.84 -215.18 249.61 -216.81 251.38 C-220.94 255.89 -224.82 260.55 -228.66 265.31 C-231 268.14 -233.45 270.86 -235.94 273.56 C-240 277.98 -243.83 282.52 -247.6 287.19 C-250.12 290.29 -252.71 293.33 -255.31 296.38 C-260.02 301.92 -264.52 307.59 -268.99 313.33 C-272.25 317.46 -275.58 321.51 -278.94 325.56 C-283.17 330.68 -287.35 335.82 -291.44 341.06 C-314.44 370.52 -314.44 370.52 -321.94 373.06 C-328.43 373.83 -333.44 373.75 -339.44 371 C-343.87 367.28 -347.09 363.6 -348.94 358.06 C-349.59 348.4 -346.23 341.98 -340.62 334.31 C-339.55 332.83 -338.48 331.35 -337.38 329.82 C-336.24 328.25 -335.11 326.68 -333.94 325.06 C-331.64 321.8 -329.35 318.53 -327.06 315.25 C-325.88 313.56 -324.7 311.87 -323.52 310.18 C-322.93 309.34 -322.34 308.5 -321.73 307.63 C-319.93 305.05 -318.13 302.48 -316.32 299.91 C-310.95 292.25 -305.6 284.59 -300.31 276.88 C-295.68 270.11 -290.96 263.41 -286.22 256.72 C-280.44 248.52 -274.73 240.28 -269 232.03 C-265.65 227.21 -262.29 222.39 -258.94 217.56 C-257.6 215.65 -256.27 213.73 -254.94 211.81 C-198.94 131.31 -198.94 131.31 -196.94 128.44 C-195.6 126.52 -194.27 124.61 -192.94 122.69 C-189.6 117.88 -186.25 113.08 -182.9 108.28 C-174.43 96.12 -166.04 83.91 -157.71 71.66 C-154.94 67.6 -152.16 63.55 -149.38 59.5 C-144.76 52.76 -140.21 45.99 -135.69 39.19 C-134.51 37.42 -133.33 35.66 -132.16 33.89 C-130.23 31.01 -128.32 28.12 -126.41 25.23 C-112.15 4.06 -92.65 -10.94 -67.31 -16.52 C-42.69 -19.6 -20.08 -14.99 0 0 Z " fill="#202020" transform="translate(562.9375,297.9375)"/>
+<path d="M0 0 C0.84 0 0.84 0 5.1 0.02 C16.45 0.13 27.19 0.57 38.25 3.31 C39.84 3.7 41.44 4.09 43.08 4.5 C76.38 13.6 106.16 34.03 127.25 61.31 C128.47 62.8 129.68 64.28 130.94 65.81 C141.9 79.56 151.98 94.05 162.25 108.31 C163.33 109.81 164.42 111.3 165.53 112.84 C171.81 121.52 178.03 130.24 184.2 139 C188.49 145.07 192.87 151.08 197.24 157.09 C205.02 168 208.5 174.89 207.25 188.31 C203.49 198.29 197.68 205.84 188.25 210.75 C175.96 216.3 164.1 216.87 151.25 212.31 C132.08 203.72 118.74 188.76 106.25 172.31 C105.44 171.27 104.63 170.23 103.79 169.16 C96.7 160.06 89.98 150.69 83.25 141.31 C81.08 138.31 78.92 135.31 76.75 132.31 C75.68 130.83 74.61 129.35 73.51 127.83 C71.31 124.78 69.1 121.72 66.89 118.67 C62.01 111.92 57.14 105.17 52.31 98.38 C33.72 72.37 33.72 72.37 24.25 62.31 C23.2 61.03 22.15 59.75 21.06 58.44 C7.25 43.5 -9.72 32.43 -28.75 25.31 C-29.75 24.92 -30.76 24.54 -31.79 24.14 C-44.62 19.48 -57.6 19.02 -71.12 19.19 C-72.54 19.2 -73.96 19.21 -75.41 19.21 C-78.86 19.24 -82.3 19.27 -85.75 19.31 C-77.11 10.67 -57.8 7.54 -46.19 4.88 C-45.17 4.64 -44.15 4.41 -43.1 4.17 C-28.73 1.04 -14.7 -0.05 0 0 Z " fill="#212120" transform="translate(576.75,472.6875)"/>
+<path d="M0 0 C0.46 0.21 0.46 0.21 2.77 1.27 C20.26 9.94 33.55 26.75 40.38 44.81 C43.26 54.02 44.34 62.23 44.31 71.81 C44.33 72.91 44.34 74.01 44.36 75.14 C44.37 96.06 34.39 114.2 20.31 129.19 C14.81 134.51 8.67 138.31 2 142 C1.16 142.46 1.16 142.46 -3.06 144.81 C-21.11 152.81 -41.64 153.19 -60.26 146.9 C-82.19 138.2 -97.87 122.93 -107.54 101.6 C-114.84 83.59 -115.58 63.35 -109 45 C-105.06 35.75 -100.54 27.63 -94 20 C-93.11 18.85 -92.23 17.69 -91.31 16.5 C-67.5 -8.66 -30.92 -14.91 0 0 Z " fill="#0367FF" transform="translate(510,543)"/>
+<path d="M0 0 C6.02 3.85 9.17 7.83 11.81 14.44 C12.28 20.87 11.75 25.67 8.81 31.44 C3.36 36.79 -0.24 39.33 -8 39.75 C-13.1 39.63 -16.78 39.2 -21.19 36.44 C-28.43 28.85 -29.69 25.49 -29.58 15.22 C-29.01 9.7 -27.22 7.19 -23.19 3.44 C-15.13 -1.59 -9.04 -3.37 0 0 Z " fill="#FAFDFF" transform="translate(465.1875,570.5625)"/>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,7 @@
+<svg viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" role="img" aria-label="attention_span_icon_1024"><title>attention_span_icon_1024</title>
+<path d="M0 0 C337.92 0 675.84 0 1024 0 C1024 337.92 1024 675.84 1024 1024 C686.08 1024 348.16 1024 0 1024 C0 686.08 0 348.16 0 0 Z " fill="#FEFEFE" transform="translate(0,0)"/>
+<path d="M0 0 C14.27 11.58 23.15 25.41 32.56 41 C36.62 47.72 40.77 54.38 45 61 C61.54 86.87 77.71 112.99 93.45 139.36 C96.66 144.74 99.9 150.12 103.12 155.5 C104.39 157.6 105.65 159.71 106.91 161.81 C107.45 162.7 107.98 163.6 108.54 164.52 C110.04 167.03 111.55 169.55 113.06 172.06 C112.73 172.72 112.4 173.38 112.06 174.06 C110.82 172.77 109.57 171.48 108.29 170.14 C77.7 138.76 42.75 118.9 -1.64 117.1 C-65.62 116.63 -119.11 155.24 -163.94 197.06 C-165.32 198.35 -166.69 199.63 -168.11 200.96 C-178.47 210.65 -188.63 220.35 -197.94 231.06 C-200.27 233.4 -202.6 235.73 -204.94 238.06 C-207.28 240.72 -209.62 243.39 -211.94 246.06 C-213.56 247.84 -215.18 249.61 -216.81 251.38 C-220.94 255.89 -224.82 260.55 -228.66 265.31 C-231 268.14 -233.45 270.86 -235.94 273.56 C-240 277.98 -243.83 282.52 -247.6 287.19 C-250.12 290.29 -252.71 293.33 -255.31 296.38 C-260.02 301.92 -264.52 307.59 -268.99 313.33 C-272.25 317.46 -275.58 321.51 -278.94 325.56 C-283.17 330.68 -287.35 335.82 -291.44 341.06 C-314.44 370.52 -314.44 370.52 -321.94 373.06 C-328.43 373.83 -333.44 373.75 -339.44 371 C-343.87 367.28 -347.09 363.6 -348.94 358.06 C-349.59 348.4 -346.23 341.98 -340.62 334.31 C-339.55 332.83 -338.48 331.35 -337.38 329.82 C-336.24 328.25 -335.11 326.68 -333.94 325.06 C-331.64 321.8 -329.35 318.53 -327.06 315.25 C-325.88 313.56 -324.7 311.87 -323.52 310.18 C-322.93 309.34 -322.34 308.5 -321.73 307.63 C-319.93 305.05 -318.13 302.48 -316.32 299.91 C-310.95 292.25 -305.6 284.59 -300.31 276.88 C-295.68 270.11 -290.96 263.41 -286.22 256.72 C-280.44 248.52 -274.73 240.28 -269 232.03 C-265.65 227.21 -262.29 222.39 -258.94 217.56 C-257.6 215.65 -256.27 213.73 -254.94 211.81 C-198.94 131.31 -198.94 131.31 -196.94 128.44 C-195.6 126.52 -194.27 124.61 -192.94 122.69 C-189.6 117.88 -186.25 113.08 -182.9 108.28 C-174.43 96.12 -166.04 83.91 -157.71 71.66 C-154.94 67.6 -152.16 63.55 -149.38 59.5 C-144.76 52.76 -140.21 45.99 -135.69 39.19 C-134.51 37.42 -133.33 35.66 -132.16 33.89 C-130.23 31.01 -128.32 28.12 -126.41 25.23 C-112.15 4.06 -92.65 -10.94 -67.31 -16.52 C-42.69 -19.6 -20.08 -14.99 0 0 Z " fill="#202020" transform="translate(562.9375,297.9375)"/>
+<path d="M0 0 C0.84 0 0.84 0 5.1 0.02 C16.45 0.13 27.19 0.57 38.25 3.31 C39.84 3.7 41.44 4.09 43.08 4.5 C76.38 13.6 106.16 34.03 127.25 61.31 C128.47 62.8 129.68 64.28 130.94 65.81 C141.9 79.56 151.98 94.05 162.25 108.31 C163.33 109.81 164.42 111.3 165.53 112.84 C171.81 121.52 178.03 130.24 184.2 139 C188.49 145.07 192.87 151.08 197.24 157.09 C205.02 168 208.5 174.89 207.25 188.31 C203.49 198.29 197.68 205.84 188.25 210.75 C175.96 216.3 164.1 216.87 151.25 212.31 C132.08 203.72 118.74 188.76 106.25 172.31 C105.44 171.27 104.63 170.23 103.79 169.16 C96.7 160.06 89.98 150.69 83.25 141.31 C81.08 138.31 78.92 135.31 76.75 132.31 C75.68 130.83 74.61 129.35 73.51 127.83 C71.31 124.78 69.1 121.72 66.89 118.67 C62.01 111.92 57.14 105.17 52.31 98.38 C33.72 72.37 33.72 72.37 24.25 62.31 C23.2 61.03 22.15 59.75 21.06 58.44 C7.25 43.5 -9.72 32.43 -28.75 25.31 C-29.75 24.92 -30.76 24.54 -31.79 24.14 C-44.62 19.48 -57.6 19.02 -71.12 19.19 C-72.54 19.2 -73.96 19.21 -75.41 19.21 C-78.86 19.24 -82.3 19.27 -85.75 19.31 C-77.11 10.67 -57.8 7.54 -46.19 4.88 C-45.17 4.64 -44.15 4.41 -43.1 4.17 C-28.73 1.04 -14.7 -0.05 0 0 Z " fill="#212120" transform="translate(576.75,472.6875)"/>
+<path d="M0 0 C0.46 0.21 0.46 0.21 2.77 1.27 C20.26 9.94 33.55 26.75 40.38 44.81 C43.26 54.02 44.34 62.23 44.31 71.81 C44.33 72.91 44.34 74.01 44.36 75.14 C44.37 96.06 34.39 114.2 20.31 129.19 C14.81 134.51 8.67 138.31 2 142 C1.16 142.46 1.16 142.46 -3.06 144.81 C-21.11 152.81 -41.64 153.19 -60.26 146.9 C-82.19 138.2 -97.87 122.93 -107.54 101.6 C-114.84 83.59 -115.58 63.35 -109 45 C-105.06 35.75 -100.54 27.63 -94 20 C-93.11 18.85 -92.23 17.69 -91.31 16.5 C-67.5 -8.66 -30.92 -14.91 0 0 Z " fill="#0367FF" transform="translate(510,543)"/>
+<path d="M0 0 C6.02 3.85 9.17 7.83 11.81 14.44 C12.28 20.87 11.75 25.67 8.81 31.44 C3.36 36.79 -0.24 39.33 -8 39.75 C-13.1 39.63 -16.78 39.2 -21.19 36.44 C-28.43 28.85 -29.69 25.49 -29.58 15.22 C-29.01 9.7 -27.22 7.19 -23.19 3.44 C-15.13 -1.59 -9.04 -3.37 0 0 Z " fill="#FAFDFF" transform="translate(465.1875,570.5625)"/>
+</svg>