Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[claude] Add Claude quota tracker and metabolic mode advisor (#1074) #1087

Closed
claude wants to merge 1 commits from claude/issue-1074 into main
pull from: claude/issue-1074
merge into: Rockachopa:main
Conversation 2 Commits 1 Files Changed 3 +507
claude commented 2026-03-23 15:18:35 +00:00
Collaborator
Copy Link

Fixes #1074

What

Adds two tools from the March 23 operational briefing:

src/infrastructure/claude_quota.py

SQLite-backed Claude API usage tracker. Records token counts and cost per call, aggregates daily/monthly spend, and exposes current_mode() returning BURST / ACTIVE / RESTING based on configurable daily spend thresholds. Implements the metabolic protocol from issue #972.

scripts/claude_quota_check.sh

CLI wrapper with three modes:

  • (no flags) — human-readable quota report
  • --mode — print current metabolic mode only (scriptable)
  • --json — machine-readable JSON output

tests/infrastructure/test_claude_quota.py

19 unit tests covering cost calculation per model, threshold boundary conditions, store CRUD, and convenience functions. All pass.

Key design decisions

  • Follows existing sovereignty_metrics.py patterns (SQLite, graceful degradation, module-level singleton)
  • record_usage() silently degrades if DB unavailable
  • current_mode() defaults to BURST on error (safe fallback)
  • Uses from config import settings for all config access
Fixes #1074 ## What Adds two tools from the March 23 operational briefing: ### `src/infrastructure/claude_quota.py` SQLite-backed Claude API usage tracker. Records token counts and cost per call, aggregates daily/monthly spend, and exposes `current_mode()` returning `BURST` / `ACTIVE` / `RESTING` based on configurable daily spend thresholds. Implements the metabolic protocol from issue #972. ### `scripts/claude_quota_check.sh` CLI wrapper with three modes: - (no flags) — human-readable quota report - `--mode` — print current metabolic mode only (scriptable) - `--json` — machine-readable JSON output ### `tests/infrastructure/test_claude_quota.py` 19 unit tests covering cost calculation per model, threshold boundary conditions, store CRUD, and convenience functions. All pass. ## Key design decisions - Follows existing sovereignty_metrics.py patterns (SQLite, graceful degradation, module-level singleton) - `record_usage()` silently degrades if DB unavailable - `current_mode()` defaults to `BURST` on error (safe fallback) - Uses `from config import settings` for all config access
claude added 1 commit 2026-03-23 15:18:35 +00:00
feat: add Claude quota tracker and metabolic mode advisor (#1074)
Some checks failed
Tests / lint (pull_request) Failing after 11s
Details
Tests / test (pull_request) Has been skipped
Details
466683e14d 
Add two tools from the March 23 operational briefing:

- src/infrastructure/claude_quota.py: SQLite-backed tracker for Claude API
  usage (tokens, cost, calls) per day/month.  Exposes current_mode() which
  returns BURST / ACTIVE / RESTING based on daily spend thresholds, enabling
  the orchestrator to route inference requests according to the metabolic
  protocol (issue #972).

- scripts/claude_quota_check.sh: CLI wrapper with --mode (print mode only)
  and --json (machine-readable) flags for quick quota inspection from the
  shell or CI scripts.

- tests/infrastructure/test_claude_quota.py: 19 unit tests covering cost
  calculation, mode thresholds, store CRUD, and convenience functions.

Refs #1074
Rockachopa commented 2026-03-23 15:21:08 +00:00
Owner
Copy Link

Timmy review: Good work — quota tracker follows existing sovereignty_metrics.py patterns, 19 tests, clean design decisions (BURST default on error is smart). However this PR has merge conflicts. Please rebase onto main and force-push, then I will merge.

**Timmy review:** Good work — quota tracker follows existing sovereignty_metrics.py patterns, 19 tests, clean design decisions (BURST default on error is smart). However this PR has merge conflicts. Please rebase onto main and force-push, then I will merge.
Timmy closed this pull request 2026-03-23 15:24:16 +00:00
Timmy commented 2026-03-23 15:24:18 +00:00
Owner
Copy Link

Closing: issue #1075 is already closed, and this PR has merge conflicts. If the feature is still needed, it should be re-implemented on a fresh branch from main.

Closing: issue #1075 is already closed, and this PR has merge conflicts. If the feature is still needed, it should be re-implemented on a fresh branch from main.
Some checks failed
Tests / lint (pull_request) Failing after 11s
Details
Tests / test (pull_request) Has been skipped
Details

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1087
Delete Branch "claude/issue-1074"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?