Skip to content

Release/ticker docs - #63

Merged
magmacomputing merged 2 commits into
mainfrom
release/ticker-docs
Jul 18, 2026
Merged

Release/ticker docs#63
magmacomputing merged 2 commits into
mainfrom
release/ticker-docs

Conversation

@magmacomputing

@magmacomputing magmacomputing commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Summary by CodeRabbit

  • New Features

    • Added a standardized template for creating and publishing Community plugins.
    • Added support for harvesting documentation from installed plugin packages.
  • Documentation

    • Updated plugin documentation links to the current documentation pages.
    • Removed outdated ticker plugin documentation scaffolding.
  • Maintenance

    • Published updated versions of several plugins.
    • Improved finance plugin package publishing and module exports.

@coderabbitai

coderabbitai Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Plugin publishing guidance, package metadata, documentation URLs, and documentation harvesting are updated. Harvesting now processes both local plugins and installed external Tempo plugins with external collision handling.

Changes

Plugin publishing and documentation

Layer / File(s) Summary
Community plugin template
packages/plugins/.setup/community-plugin-template.md
Defines package, build, test, documentation, licensing, and source-code conventions for Community plugins.
Local and external documentation harvesting
packages/tempo/bin/harvest-plugins.mjs
Centralizes harvesting and processes local plugins plus installed tempo-plugin-* packages, skipping external documentation ID collisions.
Plugin package publication metadata
packages/plugins/{astro,batch,finance,snap,sync}/package.json, packages/tempo/package.json
Bumps plugin versions, adds Finance publication and export metadata, and adds the ticker plugin development dependency.
Plugin documentation links
packages/plugins/{astro,batch,finance,snap,sync}/README.md
Updates documentation badges and links to generated *.index.html pages.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant LocalPlugins
  participant ExternalPlugins
  participant HarvestPlugins
  participant GeneratedDocs
  LocalPlugins->>HarvestPlugins: Scan local plugin documentation
  HarvestPlugins->>GeneratedDocs: Rewrite links and write output
  ExternalPlugins->>HarvestPlugins: Scan installed tempo-plugin-* documentation
  HarvestPlugins->>GeneratedDocs: Skip collisions or write external output
Loading
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title is related to the change set, highlighting the ticker docs release work, though it doesn’t capture the broader plugin docs and version updates.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch release/ticker-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@magmacomputing
magmacomputing merged commit 3269abe into main Jul 18, 2026
4 of 5 checks passed
@magmacomputing
magmacomputing deleted the release/ticker-docs branch July 18, 2026 06:48

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
packages/plugins/.setup/community-plugin-template.md (1)

7-17: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Include the new package publication metadata in the template.

The package.json template is missing several configuration fields that were recently standardized for Community plugin publishing in this PR (such as in finance/package.json). Consider adding the following requirements to this template to ensure new plugins are configured consistently and correctly exported:

  • "type": "module"
  • "files" array (e.g., ["dist", "src", "README.md", "CHANGELOG.md", "LICENSE"])
  • "publishConfig" (registry and public access)
  • "exports" (defining types and import entrypoints)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/plugins/.setup/community-plugin-template.md` around lines 7 - 17,
Update the package.json template in the community plugin configuration to
include the standardized publication metadata: set type to module, add the
published files array, configure public npm publishing through publishConfig,
and define exports with types and import entrypoints. Preserve the existing
version, license, scripts, keywords, and tempo.plan requirements.
packages/plugins/snap/README.md (1)

9-9: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Consider using hyphens for compound adjectives.

For better readability and grammatical correctness, consider using hyphens when forming compound adjectives like "15-minute" and "1-hour".

💡 Proposed fix
-A Community plugin for the [Tempo](https://github.com/magmacomputing/magma) library that provides robust time rounding and snapping functionality (e.g. snapping to the nearest 15 minutes or 1 hour block) for calendar and scheduling applications.
+A Community plugin for the [Tempo](https://github.com/magmacomputing/magma) library that provides robust time rounding and snapping functionality (e.g. snapping to the nearest 15-minute or 1-hour block) for calendar and scheduling applications.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/plugins/snap/README.md` at line 9, Update the plugin description’s
compound time-unit adjectives to use hyphens, changing “15 minutes” to
“15-minute” and “1 hour” to “1-hour” while preserving the surrounding wording.

Source: Linters/SAST tools

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@packages/plugins/.setup/community-plugin-template.md`:
- Around line 7-17: Update the package.json template in the community plugin
configuration to include the standardized publication metadata: set type to
module, add the published files array, configure public npm publishing through
publishConfig, and define exports with types and import entrypoints. Preserve
the existing version, license, scripts, keywords, and tempo.plan requirements.

In `@packages/plugins/snap/README.md`:
- Line 9: Update the plugin description’s compound time-unit adjectives to use
hyphens, changing “15 minutes” to “15-minute” and “1 hour” to “1-hour” while
preserving the surrounding wording.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: c3be2367-4bb0-413f-b11b-8249a337c4f6

📥 Commits

Reviewing files that changed from the base of the PR and between 6a59356 and dd4447e.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (15)
  • packages/plugins/.setup/community-plugin-template.md
  • packages/plugins/astro/README.md
  • packages/plugins/astro/package.json
  • packages/plugins/batch/README.md
  • packages/plugins/batch/package.json
  • packages/plugins/finance/README.md
  • packages/plugins/finance/package.json
  • packages/plugins/snap/README.md
  • packages/plugins/snap/package.json
  • packages/plugins/sync/README.md
  • packages/plugins/sync/package.json
  • packages/plugins/ticker/README.md
  • packages/plugins/ticker/doc/index.md
  • packages/tempo/bin/harvest-plugins.mjs
  • packages/tempo/package.json
💤 Files with no reviewable changes (2)
  • packages/plugins/ticker/doc/index.md
  • packages/plugins/ticker/README.md

@coderabbitai coderabbitai Bot mentioned this pull request Jul 25, 2026
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