Skip to content

docs: upgrading from 0.1.0 to 0.2.0, and the cli skill on bootstrap's refusal - #103

Open
Teg79 wants to merge 1 commit into
mainfrom
docs/upgrading-0.2.0
Open

Teg79 wants to merge 1 commit into
mainfrom
docs/upgrading-0.2.0

Conversation

@Teg79

@Teg79 Teg79 commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

For v0.2.0 (Teg's decision: from main, with the guard of urbforge/urbex-cli#135):

  • docs/upgrading.md: From 0.1.0 to 0.2.0:

    • 0.2.0 carries the Java4Shell mitigation and replaces Gitea 1.24 with Forgejo 15 LTS (ADR-0034);
    • a 0.1.0 platform can't be bootstrapped in place: Forgejo can't open Gitea's database, and urbex bootstrap refuses;
    • the steps to start it again: back up the volumes, destroy the environments, teardown --yes, upgrade, bootstrap, push and apply;
    • the workspace needs no change;
    • staying on 0.1.0, and what it keeps (Java4Shell exposure).

    The plugin section: urbex 0.2.0 needs no newer plugin. The table is 0.2.0 to 0.2.3.

  • skills/cli/SKILL.md: when urbex bootstrap refuses because "the platform's forge is Gitea", the agent explains it, points to the upgrading page, and runs none of the destroying steps unless the user asks, one confirmation each.

  • Plugin 0.2.3: plugin.json, the skill's version line, CHANGELOG.md (Plugin 0.2.3, and a Docs line).

The plugin's minimum CLI stays 0.1.0. The skills pass the workspace explicitly (-w ~/urbex-work) and read both the forge* and the gitea* credential names, so they work with 0.1.0 and 0.2.0.

Merge after #96 (plugin 0.2.2): this one bumps to 0.2.3 on top. The version lines in plugin.json, the cli skill and upgrading.md will conflict trivially, and I'll resolve them once #96 is in.

Why

urbforge/urbex-cli#134 and the v0.2.0 release (urbforge/urbex-cli#133 has the CLI's Breaking/Upgrading).

Tests I ran

  • tests/plugin-scripts.sh passes (CHANGELOG.md has plugin 0.2.3); the new section's links and anchors resolve.

Checklist before review

  • Linked issue, Conventional Commit title
  • Plugin version bumped, CHANGELOG entry
  • No secrets, tokens or private addresses

Part of urbforge/urbex-cli#134.

🤖 Generated with Claude Code

https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA

…gain, Java4Shell; the cli skill knows bootstrap's refusal

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant