0disoft/Clarissimi
Draft maintainer-approved contribution recognition summaries.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 13, 2026
- License
- Apache 2.0
Pinned Snippet
uses: 0disoft/clarissimi@55c4e54eee5a8a9fff69430d6341402e13ca3a1a # v0.3.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| mode | Action mode. Use gate for a pre-merge maintainer decision check, dry-run for summaries, propose for approved event drafts, commit for an explicit direct commit, stage-draft for draft review PRs, or promote-draft for an approved draft file. | no | propose |
| gate-mode | Review gate enforcement. advisory reports a missing or stale decision without blocking; required fails the check. | no | advisory |
| event-path | Optional GitHub event payload path for local runs and write-mode live collection. | no | — |
| github-fixture | Optional GitHub merged pull request fixture path for fixture-first runs. | no | — |
| config-path | Optional Clarissimi config file path. Supports explicit JSON config files or clarissimi.config.ts. | no | — |
| markdown-summary | Optional CONTRIBUTORS.md summary layout. Use table for totals or gallery for stable-id GitHub avatars before the detailed sections. | no | — |
| include-automation-contributors | Include approved bot and AI-agent contribution records in public contributor outputs. Omit or use true to include them; use false to hide them. | no | — |
| comment-mode | Optional source pull request status comment behavior. Use upsert to create or update one Clarissimi-managed comment after a proposal succeeds. | no | none |
| draft-path | Approved .clarissimi/drafts/*.json path required by promote-draft mode. | no | — |
| base-branch | Base branch for propose, stage-draft, and promote-draft mode pull requests. | no | main |
| remote-name | Git remote name used to publish propose and stage-draft mode branches. | no | origin |
| staging-dir | Optional temporary staging directory for propose or stage-draft generated files. | no | — |
| summary-path | Optional workspace-relative path for a sanitized JSON run summary artifact. | no | — |
| provider | Draft provider id. Omit to use config-path provider or the runner fake default; use openai-compatible for an explicit live provider. | no | — |
| provider-model | Provider model name required when provider is openai-compatible. | no | — |
| provider-endpoint | Optional OpenAI-compatible chat completions endpoint. | no | — |
| provider-endpoint-trust | Endpoint trust policy. Use private-network only for an explicitly trusted self-hosted endpoint. | no | — |
| provider-thinking | Optional OpenAI-compatible thinking mode. Use disabled for providers that emit hidden reasoning in message content. | no | — |
Outputs
| name | description |
|---|---|
| draft-count | Number of recognition drafts created. |
| proposed-entry-count | Number of proposed public entries. |
| skipped-entry-count | Number of skipped events. |
| mode | Action output mode. |
| input-source | Source used for the action input. |
| approval-status | Draft approval status when a draft exists. |
| redaction-match-count | Number of redaction matches found before drafting. |
| staged-file-count | Number of generated files staged in propose or stage-draft mode. |
| proposal-branch | Proposal branch name created in propose or stage-draft mode. |
| proposal-commit-sha | Proposal branch commit SHA created in propose or stage-draft mode. |
| proposal-pull-request-number | Proposal pull request number created or updated in propose or stage-draft mode. |
| proposal-pull-request-url | Proposal pull request URL created or updated in propose or stage-draft mode. |
| proposal-pull-request-action | Whether propose or stage-draft mode created or updated the pull request. |
| source-comment-action | Whether the opt-in source pull request status comment was created, updated, or unchanged. |
| source-comment-url | URL of the opt-in Clarissimi-managed source pull request status comment. |
| summary-json-path | Absolute path to the sanitized JSON summary artifact when summary-path is set. |
| direct-commit-branch | Target branch used by explicit commit mode. |
| direct-commit-base-sha | Base commit SHA observed before explicit commit mode writes. |
| direct-commit-sha | Commit SHA created or confirmed by explicit commit mode. |
| direct-commit-created | Whether explicit commit mode created a new commit. |
| direct-commit-pushed | Whether explicit commit mode pushed a new commit. |
| gate-mode | Effective advisory or required review gate mode. |
| gate-passed | Whether one trusted maintainer decision matches the current PR head SHA. |
| gate-decision | Matching approved or skip decision when present. |
| gate-reason | Bounded review gate result reason. |