Skip to content

SHA-12: slim README; move capability boundary to docs - #59

Merged
shaonianche merged 1 commit into
mainfrom
work/readme-slim
Aug 2, 2026
Merged

SHA-12: slim README; move capability boundary to docs#59
shaonianche merged 1 commit into
mainfrom
work/readme-slim

Conversation

@shaonianche

Copy link
Copy Markdown
Owner

Summary

  • Move the detailed Capability boundary matrix (and validation/encode notes) from README.md into docs/CAPABILITY_BOUNDARY.md.
  • Slim the README to install, public API table, and minimal read/stream/build/validate/encode examples.
  • Point design-doc and epic release notes at the new capability doc.
  • Re-checked matrix claims against code (IMPLEMENTED_FILE_TYPES, ProfileScope, EncodeMode, SDK_VERSION=21.205.0).

Related Multica SHA-12 docs hygiene after Stage 5.

Test plan

  • Spot-check links in README / design doc
  • Import smoke: from fit_tool import FitFile, EncodeMode, ProfileScope, SDK_VERSION
  • CI

- Add docs/CAPABILITY_BOUNDARY.md as the source of truth for Supported/
  Partial/Not-supported claims, validation levels, and encode policies
  (checked against current code: FILE_TYPE Activity/Workout/Course,
  ProfileScope CORE/DOMAIN/FULL, EncodeMode PRESERVE/CANONICAL).
- Slim README to install, public API, and minimal examples.
- Point design-doc and epic release notes at the new capability doc.

Co-authored-by: multica-agent <github@multica.ai>

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0a311076d9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md
Optional profile regeneration (maintainers only):

```bash
uv add 'fit-tool[gen]' # openpyxl, inflection, jinja2

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Use the checkout setup for generator dependencies

For maintainers running this from a repository checkout, uv add 'fit-tool[gen]' fails because the requirement name matches the current project and uv rejects self-dependencies, so the documented two-command regeneration procedure cannot reach gen-profile. Use the repository's uv sync --group dev or uv sync --extra gen setup here, reserving uv add for consumers of the published package.

AGENTS.md reference: AGENTS.md:L34-L38

Useful? React with 👍 / 👎.

@codecov

codecov Bot commented Aug 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.72%. Comparing base (14bda00) to head (0a31107).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #59   +/-   ##
=======================================
  Coverage   92.72%   92.72%           
=======================================
  Files          36       36           
  Lines        2721     2721           
  Branches      461      461           
=======================================
  Hits         2523     2523           
  Misses        117      117           
  Partials       81       81           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

@shaonianche
shaonianche merged commit 3fc6125 into main Aug 2, 2026
9 checks passed
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.

1 participant