Skip to content

Docs: align live agent/client guidance with the v1.2 contract #30

Description

@onlyxItachi

Current main (e00854c) is released as v1.2.0, declares Python >=3.10, and exposes seven MCP tools, but several live guidance surfaces still describe the older contract:

  • CLAUDE.md:55 says v1.2.0 is "pre-release, in review".
  • CLAUDE.md:115 says Python 3.11+, conflicting with pyproject.toml:6 and the 3.10 CI floor.
  • docs/clients.md:37-39 tells users to confirm only three digest tools plus the two capture-advisory tools.
  • src/perfdigest/server/tools.py:3-7 likewise omits summarize_report and compare_metrics from its tier-1 overview.
  • CLAUDE.md:3-5 calls docs/INIT_PROMPT.md canonical, while that intentionally frozen kickoff spec still locks Python 3.11+ (:54) and three tools (:117-130).

This can make agents and integration reviewers validate the wrong release state, runtime floor, and MCP surface.

Suggested scope: keep INIT_PROMPT.md frozen if that convention remains intentional, but label its superseded clauses clearly in the live agent guide; update CLAUDE.md, docs/clients.md, and the server module overview to the released seven-tool v1.2 contract.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions