agent-usage-tracker 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (307) hide show
  1. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/CONTRACT.md +19 -0
  2. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/PKG-INFO +46 -2
  3. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/README.md +45 -1
  4. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/config.example.toml +2 -2
  5. agent_usage_tracker-0.2.0/docs/first-run.md +64 -0
  6. agent_usage_tracker-0.2.0/docs/improvement.md +834 -0
  7. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/local-labels.md +7 -2
  8. agent_usage_tracker-0.2.0/docs/quota.md +44 -0
  9. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/reference.md +20 -5
  10. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/aut-scan.sh +2 -0
  11. agent_usage_tracker-0.2.0/packaging/launchd/dev.aut.improve-draft.plist +31 -0
  12. agent_usage_tracker-0.2.0/packaging/windows/register-task.ps1 +50 -0
  13. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/pyproject.toml +6 -0
  14. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/__init__.py +1 -1
  15. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/cli.py +45 -26
  16. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/_util.py +5 -1
  17. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/codex.py +1 -1
  18. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_sdk.py +20 -1
  19. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/generic_sdk.py +3 -0
  20. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/config.py +47 -1
  21. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/coverage.py +6 -3
  22. agent_usage_tracker-0.2.0/src/agent_usage_tracker/demo.py +62 -0
  23. agent_usage_tracker-0.2.0/src/agent_usage_tracker/demo_cli.py +28 -0
  24. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/diagnostics.py +1 -1
  25. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/event.py +5 -1
  26. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_days.py +3 -14
  27. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/history_steers.py +27 -8
  28. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/case_view.py +76 -1
  29. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/cli.py +91 -0
  30. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/decide.py +406 -0
  31. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/draft.py +395 -0
  32. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/draft_adapters.py +232 -0
  33. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/groups.py +260 -0
  34. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/inbox.py +199 -0
  35. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/judge.py +217 -26
  36. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/outputs.py +227 -0
  37. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/proposals.py +14 -2
  38. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/qualify.py +288 -0
  39. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/report_card.py +385 -0
  40. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubric.py +64 -26
  41. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/schedule.py +20 -28
  42. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve/scores.py +75 -0
  43. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/store.py +13 -2
  44. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/validation.py +39 -25
  45. agent_usage_tracker-0.2.0/src/agent_usage_tracker/improve_publish.py +109 -0
  46. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/backends.py +15 -5
  47. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/bakeoff.py +45 -34
  48. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/core.py +14 -8
  49. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/evalset.py +26 -23
  50. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/gold.py +61 -23
  51. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/replay.py +21 -5
  52. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/run.py +23 -19
  53. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/tasks.py +14 -12
  54. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/teach.py +15 -6
  55. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_cli.py +2 -2
  56. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observations.py +7 -2
  57. agent_usage_tracker-0.2.0/src/agent_usage_tracker/operational_status.py +270 -0
  58. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/outcome_git.py +6 -2
  59. agent_usage_tracker-0.2.0/src/agent_usage_tracker/overview.py +178 -0
  60. agent_usage_tracker-0.2.0/src/agent_usage_tracker/overview_cli.py +83 -0
  61. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/pricing.py +89 -22
  62. agent_usage_tracker-0.2.0/src/agent_usage_tracker/pricing_cli.py +31 -0
  63. agent_usage_tracker-0.2.0/src/agent_usage_tracker/quota.py +255 -0
  64. agent_usage_tracker-0.2.0/src/agent_usage_tracker/quota_cli.py +147 -0
  65. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/scheduled.py +2 -0
  66. agent_usage_tracker-0.2.0/src/agent_usage_tracker/setup_cli.py +157 -0
  67. agent_usage_tracker-0.2.0/src/agent_usage_tracker/setup_schedule.py +164 -0
  68. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/README.md +6 -1
  69. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/dashboards/agents-effort.json +168 -4
  70. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/dashboards/agents-usage.json +99 -37
  71. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/01_schema.sql +31 -0
  72. agent_usage_tracker-0.2.0/src/agent_usage_tracker/sink_stack/sql/02_price.sql +73 -0
  73. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/03_effort.sql +9 -11
  74. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/04_grants.sql +2 -0
  75. agent_usage_tracker-0.2.0/src/agent_usage_tracker/summary.py +363 -0
  76. agent_usage_tracker-0.2.0/src/agent_usage_tracker/summary_cli.py +34 -0
  77. agent_usage_tracker-0.2.0/src/agent_usage_tracker/usage_price.py +112 -0
  78. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_collectors.py +18 -0
  79. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_generic_sdk.py +18 -0
  80. agent_usage_tracker-0.2.0/tests/fixtures/claude-statusline-quota.json +10 -0
  81. agent_usage_tracker-0.2.0/tests/improve/test_case_context.py +88 -0
  82. agent_usage_tracker-0.2.0/tests/improve/test_decide.py +439 -0
  83. agent_usage_tracker-0.2.0/tests/improve/test_draft.py +314 -0
  84. agent_usage_tracker-0.2.0/tests/improve/test_draft_adapters.py +186 -0
  85. agent_usage_tracker-0.2.0/tests/improve/test_groups.py +275 -0
  86. agent_usage_tracker-0.2.0/tests/improve/test_inbox.py +158 -0
  87. agent_usage_tracker-0.2.0/tests/improve/test_judge_queue.py +134 -0
  88. agent_usage_tracker-0.2.0/tests/improve/test_outputs.py +464 -0
  89. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_proposals.py +30 -0
  90. agent_usage_tracker-0.2.0/tests/improve/test_qualify.py +365 -0
  91. agent_usage_tracker-0.2.0/tests/improve/test_report_card.py +274 -0
  92. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_rubric.py +68 -3
  93. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_schedule.py +82 -0
  94. agent_usage_tracker-0.2.0/tests/improve/test_scores.py +101 -0
  95. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_store.py +15 -0
  96. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_t3.py +4 -0
  97. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_validation.py +52 -0
  98. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/label_helpers.py +18 -5
  99. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_history_steers.py +28 -2
  100. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label.py +5 -5
  101. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_bakeoff.py +63 -25
  102. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_context.py +5 -5
  103. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_core.py +25 -4
  104. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_evalset.py +49 -27
  105. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_gap.py +9 -8
  106. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_gold.py +8 -8
  107. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_replay.py +22 -1
  108. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_tasks.py +32 -12
  109. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_teach.py +11 -1
  110. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_writing.py +3 -3
  111. agent_usage_tracker-0.2.0/tests/pipeline/price_fixture.py +62 -0
  112. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage.py +2 -1
  113. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage_scan.py +2 -1
  114. agent_usage_tracker-0.2.0/tests/pipeline/test_delivery_notices.py +124 -0
  115. agent_usage_tracker-0.2.0/tests/pipeline/test_demo.py +52 -0
  116. agent_usage_tracker-0.2.0/tests/pipeline/test_first_run.py +229 -0
  117. agent_usage_tracker-0.2.0/tests/pipeline/test_ledger_zone.py +51 -0
  118. agent_usage_tracker-0.2.0/tests/pipeline/test_overview.py +101 -0
  119. agent_usage_tracker-0.2.0/tests/pipeline/test_overview_quota.py +82 -0
  120. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_pricing.py +87 -0
  121. agent_usage_tracker-0.2.0/tests/pipeline/test_publish_improve.py +172 -0
  122. agent_usage_tracker-0.2.0/tests/pipeline/test_quota.py +256 -0
  123. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_scan_wrapper.py +19 -0
  124. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sink.py +21 -1
  125. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sink_sql.py +180 -1
  126. agent_usage_tracker-0.2.0/tests/pipeline/test_summary.py +208 -0
  127. agent_usage_tracker-0.2.0/tests/pipeline/test_summary_native_counts.py +93 -0
  128. agent_usage_tracker-0.2.0/tests/test_public_projection.py +32 -0
  129. agent_usage_tracker-0.1.0/docs/improvement.md +0 -434
  130. agent_usage_tracker-0.1.0/packaging/windows/register-task.ps1 +0 -19
  131. agent_usage_tracker-0.1.0/src/agent_usage_tracker/sink_stack/sql/02_price.sql +0 -60
  132. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/.gitignore +0 -0
  133. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/DEPLOY.md +0 -0
  134. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/LICENSE +0 -0
  135. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/collectors-to-add.md +0 -0
  136. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/harness-coverage.md +0 -0
  137. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/2026-11-08-understanding-implicit-state-machines.html +0 -0
  138. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/2026-11-09-status-state-reliability-fixes.html +0 -0
  139. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/docs-index.json +0 -0
  140. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/human-html/index.html +0 -0
  141. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/improvement-studies.md +0 -0
  142. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/new-laptop.md +0 -0
  143. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/observations.md +0 -0
  144. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/codexbar-learnings.md +0 -0
  145. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/otel-lane.md +0 -0
  146. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/research/sdk-usage-capture.md +0 -0
  147. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/superpowers/plans/2026-07-22-aut-showcase-metrics.md +0 -0
  148. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/docs/superpowers/specs/2026-07-22-aut-showcase-metrics-design.md +0 -0
  149. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/README.md +0 -0
  150. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/claude/commands/outcome.md +0 -0
  151. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.backup.plist +0 -0
  152. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.improve-audit.plist +0 -0
  153. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.retry.plist +0 -0
  154. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/launchd/dev.aut.scan.plist +0 -0
  155. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/Dockerfile +0 -0
  156. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/Dockerfile.dockerignore +0 -0
  157. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/README.md +0 -0
  158. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/observations/aut-observations.service +0 -0
  159. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/sql/turn-snapshot-grant.sql +0 -0
  160. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/systemd/agent-usage-tracker.service +0 -0
  161. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/packaging/systemd/agent-usage-tracker.timer +0 -0
  162. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/backup.py +0 -0
  163. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/__init__.py +0 -0
  164. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/activity_common.py +0 -0
  165. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/activitywatch.py +0 -0
  166. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/claude_code.py +0 -0
  167. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/claude_code_activity.py +0 -0
  168. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/commits.py +0 -0
  169. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor.py +0 -0
  170. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_api.py +0 -0
  171. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/cursor_cli.py +0 -0
  172. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/pi.py +0 -0
  173. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/session_digest.py +0 -0
  174. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/collectors/t3.py +0 -0
  175. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/coverage_catalog.json +0 -0
  176. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/cursor_run.py +0 -0
  177. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/episode_store.py +0 -0
  178. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_day_cache.py +0 -0
  179. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/git_safe.py +0 -0
  180. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/harness_inventory.py +0 -0
  181. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/__init__.py +0 -0
  182. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/desktop.py +0 -0
  183. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/evidence.py +0 -0
  184. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/avoidable_recovery.md +0 -0
  185. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/code_quality.md +0 -0
  186. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/completion_supported.md +0 -0
  187. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/redundant_tests.md +0 -0
  188. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/rubrics/verbosity.md +0 -0
  189. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/runtime.py +0 -0
  190. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/search_check.py +0 -0
  191. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/studies.py +0 -0
  192. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_cli.py +0 -0
  193. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_decision.py +0 -0
  194. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/study_followup.py +0 -0
  195. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/t3.py +0 -0
  196. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/improve/trial.py +0 -0
  197. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/inspector.py +0 -0
  198. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/__init__.py +0 -0
  199. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/baseline.py +0 -0
  200. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/clef.py +0 -0
  201. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/context.py +0 -0
  202. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/covered_run.py +0 -0
  203. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/local.py +0 -0
  204. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/local_parallel.py +0 -0
  205. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/merge.py +0 -0
  206. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/label/outcome_coverage.py +0 -0
  207. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/local_page.py +0 -0
  208. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/manual_time.py +0 -0
  209. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/net.py +0 -0
  210. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_report.py +0 -0
  211. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/observation_server.py +0 -0
  212. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/outcomes.py +0 -0
  213. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/push.py +0 -0
  214. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/redact.py +0 -0
  215. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/repo_keys.py +0 -0
  216. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/review.py +0 -0
  217. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/scan.py +0 -0
  218. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sdk.py +0 -0
  219. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink.py +0 -0
  220. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/apply.sh +0 -0
  221. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/compose.yaml +0 -0
  222. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/env.example +0 -0
  223. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/provisioning/dashboards/aut.yaml +0 -0
  224. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/grafana/provisioning/datasources/agents.yaml +0 -0
  225. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sink_stack/sql/refresh.sql +0 -0
  226. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/sources.py +0 -0
  227. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/state.py +0 -0
  228. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/src/agent_usage_tracker/telemetry.py +0 -0
  229. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/codex_pi_helpers.py +0 -0
  230. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activity.py +0 -0
  231. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activitywatch.py +0 -0
  232. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_activitywatch_macos.py +0 -0
  233. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_claude_code.py +0 -0
  234. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_claude_profiles.py +0 -0
  235. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_codex.py +0 -0
  236. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_codex_pi.py +0 -0
  237. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_commits.py +0 -0
  238. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor.py +0 -0
  239. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_api.py +0 -0
  240. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_cli.py +0 -0
  241. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_cli_cache.py +0 -0
  242. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_cursor_sdk.py +0 -0
  243. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_links.py +0 -0
  244. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_links_claude.py +0 -0
  245. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_pi.py +0 -0
  246. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_read_horizon.py +0 -0
  247. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_session_digest.py +0 -0
  248. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_source_registry.py +0 -0
  249. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/collectors/test_t3.py +0 -0
  250. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/conftest.py +0 -0
  251. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/__init__.py +0 -0
  252. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/conftest.py +0 -0
  253. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_case_view.py +0 -0
  254. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_cli.py +0 -0
  255. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_desktop.py +0 -0
  256. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_evidence.py +0 -0
  257. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_evidence_citations.py +0 -0
  258. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge.py +0 -0
  259. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_choices.py +0 -0
  260. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_deadline.py +0 -0
  261. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_native_deadline.py +0 -0
  262. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_sampling.py +0 -0
  263. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_judge_stall.py +0 -0
  264. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_runtime.py +0 -0
  265. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_search_check.py +0 -0
  266. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_studies.py +0 -0
  267. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_studies_decision.py +0 -0
  268. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/improve/test_trial.py +0 -0
  269. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_context_paths.py +0 -0
  270. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_covered_run.py +0 -0
  271. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_cursor_origin.py +0 -0
  272. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_baseline.py +0 -0
  273. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_local.py +0 -0
  274. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_models.py +0 -0
  275. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_parallel.py +0 -0
  276. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_label_reliability.py +0 -0
  277. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/label/test_outcome_coverage.py +0 -0
  278. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcome_git.py +0 -0
  279. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcome_reliability.py +0 -0
  280. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/outcomes/test_outcomes.py +0 -0
  281. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/fake_psycopg.py +0 -0
  282. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_backup.py +0 -0
  283. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_cli.py +0 -0
  284. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_coverage_diagnostics.py +0 -0
  285. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_cursor_run.py +0 -0
  286. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_delivery_cli.py +0 -0
  287. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_git_day_cache.py +0 -0
  288. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_git_days.py +0 -0
  289. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_harness_inventory.py +0 -0
  290. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_heartbeat.py +0 -0
  291. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_inspect.py +0 -0
  292. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_local_page.py +0 -0
  293. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_net.py +0 -0
  294. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push.py +0 -0
  295. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push_outbox.py +0 -0
  296. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_push_snapshots.py +0 -0
  297. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_redact.py +0 -0
  298. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_repo_keys.py +0 -0
  299. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_review.py +0 -0
  300. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_sessions.py +0 -0
  301. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/pipeline/test_state.py +0 -0
  302. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_cli.py +0 -0
  303. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_report.py +0 -0
  304. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observation_server.py +0 -0
  305. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observations.py +0 -0
  306. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_observe_entrypoint.py +0 -0
  307. {agent_usage_tracker-0.1.0 → agent_usage_tracker-0.2.0}/tests/test_telemetry.py +0 -0
@@ -935,3 +935,22 @@ People can change coding tools without assuming that a successful collector capt
935
935
  Doctor does not fetch a website or manufacture a publisher receipt.
936
936
 
937
937
  The [coverage guide](docs/harness-coverage.md) defines the registry, limits and supported fields.
938
+
939
+ ### Advisory improvement scores
940
+
941
+ `aut publish-improve` sends sampled verdict counts and human adoption metadata to the private sink.
942
+ It sends no evidence text, paths, case identifiers, session identifiers, rationale or commit SHAs.
943
+
944
+ `agents.improve_score_daily` is append-only, keyed by
945
+ `(day, rubric_id, rubric_version, harness, trigger, pushed_at)`.
946
+ Counts are `passed`, `failed`, `unknown` (nonnegative integers), with a boolean `qualified`.
947
+ `day` is the work date in the configured ledger time zone.
948
+ Triggers are `control`, `error_result`, or `merge`; versions are nonnegative integers.
949
+ `agents.improve_score_latest` exposes the latest push for each key without `pushed_at`.
950
+ A zero row clears a key removed inside the publisher's recomputed date window.
951
+
952
+ `agents.improve_adoption` holds `adoption_id` (first 16 hex of the private record key),
953
+ `adopted_at` (local noon), operator-written `title` (1..120 characters),
954
+ `kind` (`instruction`, `skill`, `config`, `code`), `rubric_ids` (text array), and optional integer `pr`.
955
+ Adoptions use `ON CONFLICT (adoption_id) DO NOTHING`. They do not claim a benefit.
956
+ The writer can select and insert both tables. Grafana reads only the latest score view and adoption table.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: agent-usage-tracker
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: Passive, subscription-safe tracker of coding-agent work (Claude Code, Codex, Cursor, Pi): usage, sessions, activity, active time, outcomes and local labels. Reads local logs, normalizes, pushes to a self-hosted sink.
5
5
  Project-URL: Homepage, https://github.com/rhnfzl/agent-usage-tracker
6
6
  Project-URL: Issues, https://github.com/rhnfzl/agent-usage-tracker/issues
@@ -95,6 +95,37 @@ It reads your current user's logs and writes usage rows to a local CSV.
95
95
  Cursor CLI contributes prompt rows, not token counts; choose a Cursor token source below for those.
96
96
  An unreadable source makes export exit nonzero, so a partial file cannot silently count as a complete export.
97
97
 
98
+ ### Read a local usage summary
99
+
100
+ Use the summary to see recorded usage by agent, model, or project.
101
+ It reads local logs without a database, a provider account, or a network connection.
102
+ Try a synthetic example first, or preview local setup.
103
+
104
+ ```bash
105
+ aut demo
106
+ aut setup
107
+ aut summary
108
+ aut summary --period week --group-by model
109
+ aut summary --since 2026-06-01 --until 2026-07-01 --group-by project --json
110
+ aut overview
111
+ ```
112
+
113
+ The report uses the configured ledger time zone. The end date is exclusive.
114
+ Source coverage describes what AUT can read. JSON uses `null` when no values are known for a count.
115
+ The `unknown_events` field shows how many records lack each value.
116
+ Keep the output private if it includes project names.
117
+
118
+ Use `aut setup --apply` to create a starter configuration if you need one.
119
+ The [first-run guide](docs/first-run.md) covers optional scheduled delivery.
120
+
121
+ `aut sync-prices` explicitly refreshes local API list rates. The summary separates the known
122
+ estimated subtotal from the full estimate and from costs recorded in source logs.
123
+ Use `aut summary --compare-prices MODEL_A MODEL_B` to apply two rates to the same observed token mix.
124
+
125
+ Use `aut statusline` to check cached quota, reset times, and scan freshness.
126
+ The [quota guide](docs/quota.md) shows how to feed Claude Code statusline input into AUT
127
+ and enable local notices for quota or pending delivery.
128
+
98
129
  ### Keep history in your own database
99
130
 
100
131
  Install the PostgreSQL extra:
@@ -193,7 +224,7 @@ They can also classify your instructions and infer whether a piece of work is re
193
224
 
194
225
  Local estimates read Claude Code, Codex, Cursor CLI, and Pi inputs.
195
226
  Prompts and final replies stay inside the episode's time bounds.
196
- Daily work also stops at local midnight, so shared sessions cannot mix separate work days.
227
+ Daily work also stops at midnight in `ledger_timezone`, so shared sessions cannot mix separate work days.
197
228
  Cursor replies are omitted because their stores lack reliable per-reply timestamps.
198
229
  Cases without sufficient evidence stay unclassified; uncertain model decisions stay unknown.
199
230
 
@@ -253,11 +284,17 @@ Native desktop receipts use `aut improve desktop`; command success does not esta
253
284
  ```bash
254
285
  aut improve audit --days 7 --limit 30
255
286
  aut improve status
287
+ aut improve report-card --days 28 --format md
256
288
  ```
257
289
 
258
290
  Local judging uses cached models through the existing label extra.
259
291
  Bounded reviews preserve completed judgments and resume unfinished work within the configured budget.
260
292
  `aut improve inspect --case CASE_ID` writes a private view of a captured attempt and its source references.
293
+
294
+ `aut improve label --rubric completion_supported` opens a private human review page to check an advisory judge against captured cases.
295
+ `aut improve draft` prepares small changes for human review in private candidates. Remote drafters receive selected redacted file text; conversation excerpts stay off by default.
296
+
297
+ Captured commit results can attach redacted local diffs for `code_quality` judging and human labels. Local commit-state changes queue another advisory review.
261
298
  Missing or clipped evidence stays explicit; inspection does not upgrade a judgment.
262
299
  Read the [private improvement guide](docs/improvement.md) before judging, staging changes, or executing trials.
263
300
  The guide covers executable judge references, independent agent-task acceptance, and stable wheel installations.
@@ -273,6 +310,8 @@ Update the installed package before copying a new wrapper; the wrapper calls `au
273
310
  The scheduler prevents overlapping runs and records daily success only after each step completes.
274
311
  Failed or unfinished daily steps retry after the next successful scan.
275
312
  Local scheduled labels require `AUT_LABEL=1` and `AUT_LABEL_MODE=local` in `scan.env`, plus saved recipes.
313
+ `AUT_IMPROVE_PUBLISH=1` adds daily advisory score and adoption-marker delivery after outcomes.
314
+ Deploy the updated sink schema first. Preview with `aut publish-improve --dry-run`.
276
315
  An interrupted historical replay resumes when you invoke its saved job again; preparing a job does not install a scheduler.
277
316
 
278
317
  Follow the [timer setup](packaging/README.md) and [wrapper reference](docs/reference.md#scheduling).
@@ -316,6 +355,11 @@ Read the [full privacy and network-call reference](docs/reference.md#privacy-mod
316
355
  | Start with | Purpose |
317
356
  |---|---|
318
357
  | `aut status` | Check configuration, progress, and backup age |
358
+ | `aut setup` | Preview configuration, source checks, and delivery status |
359
+ | `aut demo` | Try the local summary on synthetic agent logs |
360
+ | `aut summary --period week` | See local usage, source coverage, and unknown counts |
361
+ | `aut overview` | Open a private page with usage, source health, and available evidence |
362
+ | `aut statusline` | Check cached quota, reset times, and scan freshness |
319
363
  | `aut scan --dry-run` | Inspect parsed totals without sending rows |
320
364
  | `aut scan` | Deliver new usage and activity |
321
365
  | `aut export --out usage.csv` | Export local usage without a sink |
@@ -63,6 +63,37 @@ It reads your current user's logs and writes usage rows to a local CSV.
63
63
  Cursor CLI contributes prompt rows, not token counts; choose a Cursor token source below for those.
64
64
  An unreadable source makes export exit nonzero, so a partial file cannot silently count as a complete export.
65
65
 
66
+ ### Read a local usage summary
67
+
68
+ Use the summary to see recorded usage by agent, model, or project.
69
+ It reads local logs without a database, a provider account, or a network connection.
70
+ Try a synthetic example first, or preview local setup.
71
+
72
+ ```bash
73
+ aut demo
74
+ aut setup
75
+ aut summary
76
+ aut summary --period week --group-by model
77
+ aut summary --since 2026-06-01 --until 2026-07-01 --group-by project --json
78
+ aut overview
79
+ ```
80
+
81
+ The report uses the configured ledger time zone. The end date is exclusive.
82
+ Source coverage describes what AUT can read. JSON uses `null` when no values are known for a count.
83
+ The `unknown_events` field shows how many records lack each value.
84
+ Keep the output private if it includes project names.
85
+
86
+ Use `aut setup --apply` to create a starter configuration if you need one.
87
+ The [first-run guide](docs/first-run.md) covers optional scheduled delivery.
88
+
89
+ `aut sync-prices` explicitly refreshes local API list rates. The summary separates the known
90
+ estimated subtotal from the full estimate and from costs recorded in source logs.
91
+ Use `aut summary --compare-prices MODEL_A MODEL_B` to apply two rates to the same observed token mix.
92
+
93
+ Use `aut statusline` to check cached quota, reset times, and scan freshness.
94
+ The [quota guide](docs/quota.md) shows how to feed Claude Code statusline input into AUT
95
+ and enable local notices for quota or pending delivery.
96
+
66
97
  ### Keep history in your own database
67
98
 
68
99
  Install the PostgreSQL extra:
@@ -161,7 +192,7 @@ They can also classify your instructions and infer whether a piece of work is re
161
192
 
162
193
  Local estimates read Claude Code, Codex, Cursor CLI, and Pi inputs.
163
194
  Prompts and final replies stay inside the episode's time bounds.
164
- Daily work also stops at local midnight, so shared sessions cannot mix separate work days.
195
+ Daily work also stops at midnight in `ledger_timezone`, so shared sessions cannot mix separate work days.
165
196
  Cursor replies are omitted because their stores lack reliable per-reply timestamps.
166
197
  Cases without sufficient evidence stay unclassified; uncertain model decisions stay unknown.
167
198
 
@@ -221,11 +252,17 @@ Native desktop receipts use `aut improve desktop`; command success does not esta
221
252
  ```bash
222
253
  aut improve audit --days 7 --limit 30
223
254
  aut improve status
255
+ aut improve report-card --days 28 --format md
224
256
  ```
225
257
 
226
258
  Local judging uses cached models through the existing label extra.
227
259
  Bounded reviews preserve completed judgments and resume unfinished work within the configured budget.
228
260
  `aut improve inspect --case CASE_ID` writes a private view of a captured attempt and its source references.
261
+
262
+ `aut improve label --rubric completion_supported` opens a private human review page to check an advisory judge against captured cases.
263
+ `aut improve draft` prepares small changes for human review in private candidates. Remote drafters receive selected redacted file text; conversation excerpts stay off by default.
264
+
265
+ Captured commit results can attach redacted local diffs for `code_quality` judging and human labels. Local commit-state changes queue another advisory review.
229
266
  Missing or clipped evidence stays explicit; inspection does not upgrade a judgment.
230
267
  Read the [private improvement guide](docs/improvement.md) before judging, staging changes, or executing trials.
231
268
  The guide covers executable judge references, independent agent-task acceptance, and stable wheel installations.
@@ -241,6 +278,8 @@ Update the installed package before copying a new wrapper; the wrapper calls `au
241
278
  The scheduler prevents overlapping runs and records daily success only after each step completes.
242
279
  Failed or unfinished daily steps retry after the next successful scan.
243
280
  Local scheduled labels require `AUT_LABEL=1` and `AUT_LABEL_MODE=local` in `scan.env`, plus saved recipes.
281
+ `AUT_IMPROVE_PUBLISH=1` adds daily advisory score and adoption-marker delivery after outcomes.
282
+ Deploy the updated sink schema first. Preview with `aut publish-improve --dry-run`.
244
283
  An interrupted historical replay resumes when you invoke its saved job again; preparing a job does not install a scheduler.
245
284
 
246
285
  Follow the [timer setup](packaging/README.md) and [wrapper reference](docs/reference.md#scheduling).
@@ -284,6 +323,11 @@ Read the [full privacy and network-call reference](docs/reference.md#privacy-mod
284
323
  | Start with | Purpose |
285
324
  |---|---|
286
325
  | `aut status` | Check configuration, progress, and backup age |
326
+ | `aut setup` | Preview configuration, source checks, and delivery status |
327
+ | `aut demo` | Try the local summary on synthetic agent logs |
328
+ | `aut summary --period week` | See local usage, source coverage, and unknown counts |
329
+ | `aut overview` | Open a private page with usage, source health, and available evidence |
330
+ | `aut statusline` | Check cached quota, reset times, and scan freshness |
287
331
  | `aut scan --dry-run` | Inspect parsed totals without sending rows |
288
332
  | `aut scan` | Deliver new usage and activity |
289
333
  | `aut export --out usage.csv` | Export local usage without a sink |
@@ -10,8 +10,8 @@
10
10
  machine = "laptop"
11
11
 
12
12
  # What a "day" is in the sink's views: the IANA zone the sink was installed with (its AUT_TZ).
13
- # Default: Europe/Amsterdam. git-days counts days in it; history-steers uses it to find days
14
- # already counted. Both stop when it differs from the zone a sink_stack sink records.
13
+ # Default: Europe/Amsterdam. git-days, history-steers and the label commands count days in it.
14
+ # git-days and history-steers stop when it differs from the zone a sink_stack sink records.
15
15
  # ledger_timezone = "Europe/Berlin"
16
16
 
17
17
  # Which agents to collect. Omit to collect every collector except the opt-in activitywatch.
@@ -0,0 +1,64 @@
1
+ # First run
2
+
3
+ AUT reads the logs your coding agents already save. You can try it and check local coverage before
4
+ you choose a database or send any data.
5
+
6
+ ## Start with a local report
7
+
8
+ ```sh
9
+ aut setup
10
+ aut demo
11
+ aut setup --apply
12
+ aut summary
13
+ aut overview
14
+ ```
15
+
16
+ `aut setup` previews the config path and checks local source metadata. Use `--json` for a
17
+ receipt with separate settings, source observations and delivery state. A scan receipt
18
+ describes locally emitted rows. The local queue can show pending rows, while delivery remains
19
+ unverified until you check the sink. A missing source can mean that the agent has yet to log
20
+ any work. Run `aut doctor --json` for the full private coverage report.
21
+
22
+ `aut setup --apply` creates the starter config only when the file is missing. The starter
23
+ uses local logs and leaves delivery off. The [config example](../config.example.toml) describes
24
+ optional sources and transport settings. The demo uses sample logs in a temporary directory.
25
+ It needs no provider account, database or previous setup.
26
+
27
+ The overview opens a private loopback page. Choose a date range and group by agent, model
28
+ or project. It shows when usage was last seen and whether scan evidence is fresh. If an
29
+ improvement store exists, the page links to its private report card. Use
30
+ `aut overview --no-browser` to get the local URL and Ctrl-C to close the page.
31
+ Quota appears after a [local capture](quota.md). The overview reads the cache for each page
32
+ request and shows freshness, the reset time and any supported pace estimate.
33
+
34
+ Use `aut improve inspect --case CASE_ID` to review the private context for a saved case.
35
+ The view links text sizes, exact repeat reads and observed compactions to their frozen events.
36
+ Captured text sizes use UTF-8 bytes and can be clipped. Actual model context tokens are unknown.
37
+
38
+ ## Schedule delivery to your own sink
39
+
40
+ Set the transport in your local config. The scheduled job needs access to any environment
41
+ variables that the config names. AUT leaves credentials out of scheduler entries. Use a stable
42
+ `aut` executable, such as one from `uv tool install agent-usage-tracker`.
43
+
44
+ ```sh
45
+ aut setup --schedule
46
+ aut setup --apply --schedule
47
+ ```
48
+
49
+ The first command previews. The second enables a per-user scan timer, which can start a scan
50
+ as soon as the scheduler loads it. It uses launchd on macOS, a systemd user timer on Linux,
51
+ and a scheduled task for the current interactive user on Windows. It keeps existing config and
52
+ refuses to replace a schedule created outside guided setup. On macOS the scheduled logs are
53
+ under `~/Library/Logs`. Linux uses the user journal and Windows uses Task Scheduler history.
54
+
55
+ On Windows, setup uses a process-local execution policy for the packaged script. Group Policy
56
+ can still block it. Use Task Scheduler to run `aut scan` if your administrator permits it.
57
+
58
+ The guided timer uses the default AUT config and state paths. For a custom setup, an existing
59
+ manual timer, or a system without a supported user scheduler, see
60
+ [the scheduler templates](../packaging/README.md). Use `aut summary` for local reporting on demand.
61
+
62
+ `aut setup --uninstall` removes only the scan entry created by guided setup. It keeps config,
63
+ scan state and logs. It can remove the managed entry when the config is unreadable.
64
+ Custom daily jobs and manual scan timers have their own removal procedures.