docs(v2.2.0): clawhub skill + URL fix for Plugin Pro upgrade pointer#104
Merged
saurabhjain1592 merged 5 commits intomainfrom May 6, 2026
Merged
Conversation
Two changes for the v2.2.0 release line:
1. New clawhub/2.2.0/SKILL.md
- Base copied verbatim from 2.1.1 to preserve all ClawScan-tuned
phrasing in the Deployment recommendation / Install / Mode-specific
reference sections (additive changes only — no rewrite).
- Adds "Plugin Pro tier" section between Configure and Environment
variables. Covers retention/quota deltas (3d/200 → 30d/1000),
90-day window + 14-day refund, how to find the tenant ID before
Stripe Checkout (axonflow-openclaw-status), how to install the
issued license token (AXONFLOW_LICENSE_TOKEN env or
pluginConfig.licenseToken), and how to recover lost
Community-SaaS credentials (axonflow-openclaw-recover CLI).
- Adds AXONFLOW_LICENSE_TOKEN + AXONFLOW_UPGRADE_URL to the
Environment variables table with documented defaults.
- Bumps minimum-version reference from 2.1.0 → 2.2.0.
2. Upgrade-pointer URL fix across all surfaces in this repo
- Old URL https://getaxonflow.com/pro returned 404 — the page was
referenced in PRDs but never built. Same for
https://getaxonflow.com/plugins/pro (also 404).
- Replaced with https://www.getaxonflow.com/pricing/ which already
resolves and carries the Plugin Pro $9.99 tier card with the
Stripe buy button. The pricing page covers both Plugin Pro and
team/enterprise plans — no need for a separate /pro page.
- Files touched: src/status.ts (STATUS_DEFAULT_UPGRADE_URL),
bin/axonflow-openclaw-status.mjs (header comment),
tests/status.test.ts (8 fixtures + assertions), README.md
(status sample output, Activate Pro tier section, licenseToken
config reference).
- All 21 test suites / 420 tests pass against the new URL.
- The status CLI's --json output (and human-readable output) now
prints the working pricing URL for free-tier users.
clawhub/CHANGELOG.md updated with the 2.2.0 entry summarising both
changes and noting the 2.1.1 base.
Self-review (HARD RULE #1):
- Walked every hunk per the 5-question protocol.
- Skill content additions are accurate against the v2.2.0 plugin
surface (the bin commands and env vars exist; verified by grep).
- ClawScan-careful: the new Plugin Pro section uses neutral
enumeration (what Pro extends, how to activate, how to recover),
links specifics to docs pages, and avoids trigger phrases like
"non-production" / "trial server" / "prevent data exfiltration".
- The 2.1.1 base is preserved bit-for-bit in the sections ClawScan
flagged on prior versions (Deployment recommendation, Mode-specific
reference, Tombstoned identifier semantics) so a re-scan of 2.2.0
shouldn't introduce regressions.
- npm run build + npm test clean.
- This commit ships only what was explicitly in scope per the user
direction: skill + README + URL fix. No MCP tool, no plugin code
refactor, no platform changes.
Out of scope (deferred):
- axonflow_get_tenant_id MCP tool (would require platform release).
- Cross-plugin coordination of the same URL fix (separate PRs per
axonflow-claude-plugin / axonflow-cursor-plugin / axonflow-codex-plugin).
Signed-off-by: Saurabh Jain <saurabhjain1592@gmail.com>
Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
Both versions had been published (clawhub/2.1.0/SKILL.md and clawhub/2.1.1/SKILL.md exist) but never received changelog entries — the gap was visible after adding 2.2.0 today. 2.1.0 (companion to plugin v2.1.0) — agent-callable governance tools note (v2.1.0+ block in the Explain a Decision section), minimum-version bump 2.0.4 → 2.1.0, npm @latest install spec, primary-install-path clarification. 2.1.1 — third ClawScan-retune on the v2.x line. Phrase-level rewording to clear renewed Concern flags after a scanner retrain. Specific trigger phrases dropped: "prevent data exfiltration" (description), "Community SaaS trial server" (body), "non-production infrastructure" (install warning), inline rate-limit numbers (moved to docs page). Operational accuracy preserved by linking to /docs/deployment/community-saas/. Both entries reflect the actual content delta vs the prior version (verified via diff against clawhub/<n>/SKILL.md). Signed-off-by: Saurabh Jain <saurabhjain1592@gmail.com> Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
…nt_id step Two self-review follow-ups: 1. Drop www. — pricing URL is now https://getaxonflow.com/pricing/ (no www subdomain) per user direction. Both forms resolve (200) today; we standardise on the bare domain since www is redundant in current convention. Sweep covers README, src/status.ts constant, bin CLI comment, tests/status.test.ts assertions, and clawhub/2.2.0/SKILL.md. 2. Restructure README "Activate Pro tier" section to lead with tenant_id discovery. The original numbered list assumed users already knew where to find the tenant_id and started at "buy through Stripe Checkout". Restructured into 4 explicit steps with bold headings: Find your tenant ID → Buy at the pricing page → Install the issued license token → Reload OpenClaw. Step 1 now embeds the exact `npx @axonflow/openclaw axonflow-openclaw-status` command and points at the [Check status] anchor for full output. Pricing summary line ($9.99 / 90 days, no auto-renewal, 14-day refund) added at the section top so users see commitments before committing. Signed-off-by: Saurabh Jain <saurabhjain1592@gmail.com> Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
Adds the runtime-e2e test required by HARD RULE #0 for the STATUS_DEFAULT_UPGRADE_URL change. The "Runtime E2E required for user-facing changes" CI gate fired on this PR because src/status.ts is a customer-visible surface (the URL constant ends up in the status CLI's stdout) but the prior commits in this PR didn't touch runtime-e2e/**. What the test does Invokes bin/axonflow-openclaw-status.mjs in both human-readable and --json modes against a temporary AXONFLOW_CONFIG_DIR (no developer state), and asserts: - bin exits 0 - human-readable output contains the new pricing URL - human-readable output does NOT contain stale /pro URLs - --json output parses as valid JSON - .upgrade_url === "https://getaxonflow.com/pricing/" byte-exact Pure-CLI test — no docker stack, no agent, no network. The status surface is read-only stdlib-only per src/status.ts header comment; the test exercises the same dispatch path a free-tier user runs. PASS evidence captured at runtime-e2e/status-cli-url/EVIDENCE/2026-05-06T131815Z/. Reproducing npm run build bash runtime-e2e/status-cli-url/test.sh Self-review (HARD RULE #1): - Test exercises the live dispatch path (node ./bin/...) — not just the format function it imports. Distinguishes "compiled bin works" from "source compiles" — the difference that bit the prior commit's run (compiled dist/ was stale until npm run build). - Uses isolated AXONFLOW_CONFIG_DIR so the test passes regardless of whether the developer has a real Community SaaS registration file at the OS-default config path. - No docker / network / agent dependency — runs in CI without external infra. - Fresh evidence dir per run (UTC timestamp); old runs not overwritten. Signed-off-by: Saurabh Jain <saurabhjain1592@gmail.com> Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
Per cross-plugin review feedback: the URL fix from getaxonflow.com/pro (404) to getaxonflow.com/pricing/ (working) was previously documented only via inline mentions in unrelated tier-line / status-output bullets. Adding a dedicated "### Fixed" bullet so the change is discoverable as a release-note line item, with a cross-reference to the same fix in companion plugins. Signed-off-by: Saurabh Jain <saurabhjain1592@gmail.com> Signed-off-by: Saurabh Jain <saurabh.jain@getaxonflow.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Three doc-only changes for the v2.2.0 release line — no plugin runtime behavior changes.
clawhub/2.2.0/SKILL.md(based on 2.1.1, additive only)clawhub/2.2.0/SKILL.mdclawhub/CHANGELOG.mdgetaxonflow.com/pro(404) →www.getaxonflow.com/pricing/(200) across status CLI, tests, READMEsrc/status.ts,bin/axonflow-openclaw-status.mjs,tests/status.test.ts,README.mdclawhub/2.2.0/SKILL.md highlights
Base copied verbatim from 2.1.1 to preserve all ClawScan-tuned phrasing in the Deployment recommendation, Install, and Mode-specific reference sections — only additive changes.
New "Plugin Pro tier" section between Configure and Environment variables. Covers what Pro extends (3d/200 → 30d/1000), 90-day window + 14-day refund, how to find tenant ID before checkout (
axonflow-openclaw-status), how to install the issued license token (AXONFLOW_LICENSE_TOKENenv orpluginConfig.licenseToken), and how to recover lost Community-SaaS credentials (axonflow-openclaw-recoverCLI).Two new env vars added to the Environment variables table:
AXONFLOW_LICENSE_TOKEN+AXONFLOW_UPGRADE_URL. Minimum-version reference bumped 2.1.0 → 2.2.0.URL fix
Old URL
getaxonflow.com/proreturned 404 — referenced in PRDs but never built. Same forgetaxonflow.com/plugins/pro(also 404). The pricing page atwww.getaxonflow.com/pricing/already resolves and carries the Plugin Pro $9.99 tier card with the Stripe buy button (covers both Plugin Pro and team/enterprise plans).Test plan
npm run buildcleannpm test— 21 suites / 420 tests pass against the new URLOut of scope
axonflow_get_tenant_idMCP tool — deferred (would have required platform release).