Skip to content

docs: specify scoped agent timekeeping - #10

Merged
ECWireless merged 1 commit into
mainfrom
docs/agent-timekeeping-spec
Jul 23, 2026
Merged

docs: specify scoped agent timekeeping#10
ECWireless merged 1 commit into
mainfrom
docs/agent-timekeeping-spec

Conversation

@ECWireless

@ECWireless ECWireless commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Summary

Documents the approved design for scoped agent timekeeping in SPEC.md.

This PR is specification-only. It does not implement database migrations, /api/agent/v1 routes, key-management Server Actions, dashboard UI, or Codex harness installation. Those changes will be delivered in later, separately reviewed implementation PRs.

Specified behavior

  • Defines one hashed bearer credential per selected node, including bounded token format, rotation, revocation, allowlist enforcement, and concurrency guarantees.
  • Defines dynamic subtree authorization that includes the selected root and descendants while excluding parents, siblings, and outside branches.
  • Defines four narrow, versioned agent API operations with allowlisted responses, stable errors, replay behavior, and timer integrity rules.
  • Defines agent session placement, start/stop, ambiguous-timer, timezone, and failure-reconciliation behavior.
  • Defines the once-per-harness global Codex skill setup and per-repository TIMETREE_API_KEY experience.
  • Updates the target architecture, data model, routes, dashboard contract, and verification boundary to reflect the approved future implementation.
  • Records one final synthetic live verification scenario after the backend and UI implementation PRs pass their review and QA gates.

Verification

  • git diff --check main -- SPEC.md
  • Repository-wide specification consistency review
  • Fresh-context technical/product review
  • Fresh-context security/privacy review
  • Focused re-review of all accepted findings

No runtime or browser tests were run because this PR changes documentation only.

Copilot AI review requested due to automatic review settings July 23, 2026 14:16
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
timetree Ready Ready Preview, Comment Jul 23, 2026 2:16pm

Request Review

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates SPEC.md to define and scope a “scoped agent timekeeping” integration, including credential lifecycle, subtree authorization rules, a versioned agent API surface, and corresponding updates to the documented data model and server boundary.

Changes:

  • Added a comprehensive “Scoped agent timekeeping” specification (credential format/lifecycle, dynamic subtree boundary, agent API operations, and harness setup expectations).
  • Updated existing spec sections (detail view, architecture/server boundary, routes, data model, and quality boundary) to include the agent integration.
  • Expanded the documented verification expectations to include agent-key lifecycle and scoped-authorization scenarios.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SPEC.md
@ECWireless
ECWireless merged commit fc579bb into main Jul 23, 2026
4 checks passed
@ECWireless
ECWireless deleted the docs/agent-timekeeping-spec branch July 23, 2026 14:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants