docs: add release documentation and LICENSE [4/4] - #46

Merged
wyattjoh merged 2 commits into
mainfrom
wyattjoh/release-docs
Mar 25, 2026
Merged

docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom
wyattjoh/release-docs

Conversation

@wyattjoh

@wyattjohwyattjoh commented Mar 20, 2026•
edited by coderabbitai Bot
Loading

Copy link
Copy Markdown
Contributor

Summary

#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.

This PR adds:

  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.

Merge instructions

This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.

Test plan

Summary by CodeRabbit

  • Documentation

    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.

  • Chores

    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
Merged
Closed
Merged
Closed
@wyattjoh
wyattjoh requested a review from jfosheeMarch 20, 2026 16:54
@wyattjoh

wyattjoh commented Mar 20, 2026

Copy link
Copy Markdown
ContributorAuthor

PR Stack — Supersedes #31

PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR

Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.

@wyattjoh
wyattjoh marked this pull request as draft March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-infra branch from 2bb7c54 to ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 0de722e to 09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh mentioned this pull request Mar 20, 2026
Merged
3 tasks
@wyattjoh

wyattjoh commented Mar 20, 2026

Copy link
Copy Markdown
ContributorAuthor

PR Stack -- Supersedes #31

PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR

Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.

@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 09a21fc to 1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-infra branch from ba9a09c to 0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 1a4fb7a to bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-infra branch from 0aa883a to 51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from bd2b0e6 to 94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-infra branch from 51be70a to 2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 94c3027 to 0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-infra branch from 2b7f7c7 to d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit that referenced this pull request Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch 2 times, most recently from d76d44d to 9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit that referenced this pull request Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs
Base automatically changed from wyattjoh/release-infra to mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 9e33547 to 44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh marked this pull request as ready for review March 23, 2026 16:48
@coderabbitai

coderabbitaiBot commented Mar 23, 2026•
edited
Loading

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4

📥 Commits

Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.

📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough

Walkthrough

Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

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

coderabbitai[bot]
coderabbitaiBot reviewed Mar 23, 2026
View reviewed changes

@coderabbitaicoderabbitaiBot 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.
ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db

📥 Commits

Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.

📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts

Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed the wyattjoh/release-docs branch from 7110069 to ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh enabled auto-merge (squash) March 25, 2026 15:49
@wyattjoh
wyattjoh merged commit 5aa7be1 into mainMar 25, 2026
3 checks passed
@wyattjoh
wyattjoh deleted the wyattjoh/release-docs branch March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
docs: add release documentation and LICENSE [4/4] - #46
Merged
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Mar 25, 2026
Merged
docs: add release documentation and LICENSE [4/4]#46
wyattjoh merged 2 commits into
mainfrom 
wyattjoh/release-docs
Conversation
@wyattjoh
@wyattjohwyattjoh
commented
Mar 20, 2026•

edited by coderabbitai
Bot
Loading

Copy link


Copy Markdown

Contributor
Summary
#43, #47, and #45 add a non-trivial release pipeline with three channels, multiple CI workflows, and safeguards that aren't obvious from reading the code alone. Without documentation, contributors won't know how to cut a release, what the channel model is, or what guardrails exist.
This PR adds:
  • docs/releasing.md -- documents the full release flow end-to-end: the architecture (wrapper + platform packages), all three channels (stable, canary, snapshot) with their triggers and version formats, the versioning workflow via Changesets, and the safeguards built into each step (smoke tests, isPublished checks, org membership gating for snapshots).
  • README.md -- updated with current CLI help output reflecting the monorepo commands.
  • LICENSE -- MIT license.
Merge instructions
This is the last PR in a 4-PR stack (#43, #47, #45, #46). Squash-merge normally, no rebase needed after.
Test plan
Summary by CodeRabbit
  • Documentation
    • Added comprehensive contribution guidelines covering development setup, pre-release installation, and PR workflow.
    • Enhanced README with Installation and Usage sections for the CLI.
    • Added release process documentation.
    • Updated project guidance to reference contribution instructions.
  • Chores
    • Added MIT License file.
    • Packaging now embeds the LICENSE into generated platform packages.

This was referenced Mar 20, 2026
 Merged

 Closed

 Merged

 Closed

@wyattjoh
wyattjoh
requested a review
from jfosheeMarch 20, 2026 16:54
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack — Supersedes #31
PRDescription
1#43Monorepo restructure
2#44Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE — ← this PR
Review in parallel, merge sequentially 1→2→3→4.
Squash-merge each PR, then rebase the next branch onto the updated base before merging it.
@wyattjoh
wyattjoh
marked this pull request as draft
March 20, 2026 17:08
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2bb7c54 to
ba9a09cCompareMarch 20, 2026 17:48
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
0de722e to
09a21fcCompareMarch 20, 2026 17:48
@wyattjohwyattjoh
mentioned this pull request
Mar 20, 2026
 Merged

3 tasks
@wyattjoh
wyattjoh
commented
Mar 20, 2026

Copy link


Copy Markdown

ContributorAuthor
PR Stack -- Supersedes #31
PRDescription
1#43Monorepo restructure (merged)
2#47Cross-compile build + smoke tests
3#45Release infrastructure (changesets)
4#46Release documentation + LICENSE -- ← this PR
Review in parallel, merge sequentially. Squash-merge each PR, retarget the next PR to main before deleting the branch, then rebase.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
09a21fc to
1a4fb7aCompareMarch 20, 2026 19:53
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
ba9a09c to
0aa883aCompareMarch 20, 2026 19:54
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
1a4fb7a to
bd2b0e6CompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
0aa883a to
51be70aCompareMarch 20, 2026 19:59
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
bd2b0e6 to
94c3027CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
51be70a to
2b7f7c7CompareMarch 20, 2026 20:01
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
94c3027 to
0d8287dCompareMarch 20, 2026 20:18
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-infra
branch
from
2b7f7c7 to
d849ce6CompareMarch 20, 2026 20:18
wyattjoh added a commit
that referenced
this pull request
Mar 20, 2026
@wyattjoh
fix: harden release infrastructure
3d5e9ab
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
2 times, most recently
from
d76d44d to
9e33547CompareMarch 20, 2026 22:49
wyattjoh added a commit
that referenced
this pull request
Mar 23, 2026
@wyattjoh
feat: add release infrastructure with changesets [3/4] (#45)
a2c0cc5
* feat: add release infrastructure with changesets
Add the complete release pipeline:
- Changesets for versioning (stable, canary, snapshot channels)
- Releaser script for npm publish, git tags, and GitHub Releases
- CI workflows for stable/canary releases and PR snapshot comments
* fix: harden release infrastructure
- Remove LICENSE copy from platform packages (added in PR #46)
- Make stable release tag/release creation idempotent (remote-aware
tag check, independent release existence check)
- Add --clobber to GitHub Release asset uploads for safe reruns
- Block snapshot publish on fork PRs to prevent OIDC token exposure
- Fix notify-failure to fire even when publish job is skipped
* ci: declare Blacksmith runner label for actionlint
* ci: reorder check-release before changesets to prevent premature release
* ci: add fork guards to snapshot build and smoke-test jobs

Base automatically changed from
wyattjoh/release-infra to
mainMarch 23, 2026 16:47
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
9e33547 to
44c29bcCompareMarch 23, 2026 16:47
@wyattjoh
wyattjoh
marked this pull request as ready for review
March 23, 2026 16:48
@coderabbitai
coderabbitaiBot
commented
Mar 23, 2026•

edited

Loading

Copy link


Copy Markdown

No actionable comments were generated in the recent review. 🎉
ℹ️ Recent review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 631b482b-b8b0-4eb1-a387-f75b21600ce4
📥 Commits
Reviewing files that changed from the base of the PR and between 7110069 and ff18bb3.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
📝 Walkthrough
Walkthrough
Added CONTRIBUTING.md with local development, testing, PR, and pre-release installation guidance. Added a top-level LICENSE file containing the MIT license (2026 copyright). Added docs/releasing.md describing stable, canary, and snapshot release flows and tooling. Updated README with Installation and Usage sections (including npm install -g clerk). Updated scripts/releaser to copy the repository LICENSE into each generated platform package. Added a cross-reference to CONTRIBUTING.md in CLAUDE.md.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring 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 (2 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the pull request as adding release documentation and a LICENSE file, and the [4/4] notation clearly contextualizes it as the final part of a multi-PR stack.
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
Comment @coderabbitai help to get the list of available commands and usage tips.
coderabbitai[bot]
coderabbitaiBot
reviewed
Mar 23, 2026
View reviewed changes
@coderabbitaicoderabbitaiBot
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.

Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@scripts/releaser/index.ts`:
- Around line 69-71: The packaging change now copies LICENSE (licensePath /
copyFile) into each platform package but there is no test; add a
unit/integration test that invokes the packaging step (call
generatePlatformPackage or the equivalent function used by the releaser) against
a temporary output location, then assert that each produced package output
(directory or archive for each platform) contains a top-level LICENSE file;
ensure the test creates its own temp workspace, runs the packaging function,
inspects each generated package (extract archive if needed) to check for a file
named "LICENSE", and cleans up after itself.

ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: ASSERTIVE
Plan: Pro
Run ID: 1bee525e-0583-43ad-8091-31330d8ac5db
📥 Commits
Reviewing files that changed from the base of the PR and between a2c0cc5 and 7110069.
📒 Files selected for processing (6)
  • CLAUDE.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • docs/releasing.md
  • scripts/releaser/index.ts
Comment threadscripts/releaser/index.ts
@wyattjoh
docs: add release documentation and LICENSE
90d3a98
Add docs/releasing.md covering the full release flow, channels, and
safeguards. Update README with current help output. Add MIT license.
@wyattjoh
wyattjohforce-pushed
the
wyattjoh/release-docs
branch
from
7110069 to
ff18bb3CompareMarch 25, 2026 15:49
@wyattjoh
wyattjoh
enabled auto-merge (squash)
March 25, 2026 15:49
@wyattjoh
wyattjoh
merged commit 5aa7be1
into
mainMar 25, 2026

3 checks passed

@wyattjoh
wyattjoh
deleted the

wyattjoh/release-docs

branch
March 25, 2026 15:53
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@coderabbitaicoderabbitai[bot]coderabbitai[bot] left review comments
@brkalowbrkalowbrkalow approved these changes
@jfosheejfosheeAwaiting requested review from jfoshee

Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

2 participants

@wyattjoh@brkalow