geomind_code/dev_docs
22
0
Fork 0
Code Issues 10 Pull requests 1 Projects Releases 2 Packages 1 Wiki Activity Actions

Skills update — port registration, oschema guide, forge_workflow, FORGEJO_TOKEN standardization, CI gotchas #17

Closed
mik-tf wants to merge 12 commits from development_skills_update_feb into development
pull from: development_skills_update_feb
merge into: geomind_code:development
Conversation 1 Commits 12 Files changed 14 +2153 -435
mik-tf commented 2026-02-17 19:14:20 +00:00
Member
Copy link

Consolidates all pending skills work into one PR with granular commits.

Changes

  • Register port 3395 for freezone_backend in hero_ports
  • Add oschema-backend-port skill (comprehensive porting guide)
  • Add forge_workflow skill (issue → PR → merge workflow with templates)
  • Retire forge_issues skill (absorbed into forge_workflow)
  • Remove INDEX.md (skills are self-discoverable)
  • Standardize FORGEJO_TOKEN across all forge skills (retire GIT_TOKEN)
  • Add rustup container crash to forge_ci Common CI Issues
  • Add "When build_lib.sh is not available" section to build_lib
  • Add duplicate-check step to forge_workflow issue template
  • Update env_secrets FORGEJO_TOKEN description

Testing

  • All changes are documentation/skill files — no runtime code
  • Verified no GIT_TOKEN references remain in touched skills

Closes #10, Closes #12, Closes #14, Closes #16

Consolidates all pending skills work into one PR with granular commits. ## Changes - Register port 3395 for freezone_backend in hero_ports - Add oschema-backend-port skill (comprehensive porting guide) - Add forge_workflow skill (issue → PR → merge workflow with templates) - Retire forge_issues skill (absorbed into forge_workflow) - Remove INDEX.md (skills are self-discoverable) - Standardize FORGEJO_TOKEN across all forge skills (retire GIT_TOKEN) - Add rustup container crash to forge_ci Common CI Issues - Add "When build_lib.sh is not available" section to build_lib - Add duplicate-check step to forge_workflow issue template - Update env_secrets FORGEJO_TOKEN description ## Testing - All changes are documentation/skill files — no runtime code - Verified no GIT_TOKEN references remain in touched skills Closes #10, Closes #12, Closes #14, Closes #16
Adds freezone_backend (freezone_server) to the hero_ports registry
at port 3395. Updates next available backend port to 3396.

Closes #12
- Detail steps for porting backends to OSchema-generated OpenRPC servers
- Explain storage and proxy/bridge operating modes with examples
- Provide OSchema syntax reference for type and service definitions
- Include common pitfalls, tips, and a quick checklist for developers
Complete issue-to-merge workflow: templates, WIP convention,
writing style, and API calls. Absorbs forge_issues content.

Closes #14
- Replace all GIT_TOKEN references with FORGEJO_TOKEN across forge_api,
  forge_ci, forge_release, and forge_workflow skills
- Add rustup crash row to forge_ci Common CI Issues table
- Add "When build_lib.sh is not available" section to build_lib skill
- Add duplicate-check step to forge_workflow issue template
- Update env_secrets FORGEJO_TOKEN description to cover API calls
- Fix forge_api gotcha #4: one token for everything, not two

Closes #16
mik-tf changed title from WIP: Skills update — port registration, oschema guide, forge_workflow, FORGEJO_TOKEN standardization, CI gotchas to Skills update — port registration, oschema guide, forge_workflow, FORGEJO_TOKEN standardization, CI gotchas 2026-02-17 19:16:46 +00:00 
Add cross-repo deps.txt reference section to forge_ci (§8) covering
file format, CI usage, maintenance rules after dependency migrations,
and cargo check vs wasm-pack for WASM compilation. Add four new CI
issue rows for stale deps.txt, generated code, package name mismatches,
and fragile wasm-pack paths. Update hero_coderoot with deps.txt sync
checklist and real-world migration example.

Closes #18

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Expand the "Porting an Existing UI" section in the archipelagos skill
from a brief checklist into a complete step-by-step guide covering:

- Two porting modes: SDK (hero_osis) vs HTTP (external API)
- View enum with FromStr trait pattern (not inherent from_str)
- Dual-target service layer (gloo-net WASM + native stubs)
- Tera-to-RSX conversion reference table
- JavaScript interop via js_sys::eval
- Island entry point wiring (signal-based navigation, no Router)
- Standalone lib.rs boilerplate with cfg gates
- CI/Clippy gotchas (#[component] _props bug, cfg-gated params,
  rustfmt::skip for generated code, standalone import gating)
- Complete porting checklist

Also update the Dioxus skill to reference the archipelagos skill for
island work, clarifying that islands don't use Router or Server Functions.

Based on lessons learned porting hero_books (Tera templates) to a native
Dioxus island in hero_archipelagos.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Section 3 of forge_ci skill now documents the undocumented internal
endpoint that the Forgejo web UI uses to fetch job step logs. This
enables programmatic CI log retrieval with token authentication,
removing the need to always reproduce failures locally or copy-paste
from the browser.

Closes #20

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- forge_ci: fix List Runs field names (index_in_repo, prettyref, title
  instead of index, head_branch, name) and List Tasks fields
- forge_ci: document that web log endpoint returns 404 for private repos
  (Forgejo web routes require session cookies, no token auth works)
- forge_ci: correct response format (wrapped in state/logs, "lines" not
  "logLines", Unix timestamps)
- forge_ci: promote local reproduction to Option 1 (fastest, works for
  all repos, catches errors before pushing)
- forge_ci: add build_lib.sh build() argument order gotcha
- forge_ci: add explicit warning to never toggle repo visibility
- makefile_helper: add ci-local target pattern with scripts/ci-local.sh
  that neutralizes workspace .cargo/config.toml for CI-equivalent builds
- hero_coderoot: document workspace .cargo/config.toml interference with
  CI builds and link to ci-local workaround

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- makefile_helper: test-all.sh uses make targets (not raw cargo), ci-local
  calls make test-all with CARGO_NET_GIT_FETCH_WITH_CLI, new ci-docker
  convention with Docker template and ci-patch-deps.sh for cross-repo deps
- forge_ci: Option 1 updated with three-tier strategy and careful language
  ("CI should pass" not "will pass")
- build_lib: build.yaml simplified to single make test-all step

Proven in practice: ci-local pass → remote CI pass (hero_zero PR #14).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
mik-tf commented 2026-02-19 03:01:54 +00:00
Author
Member
Copy link

Superseded by #21 — consolidated to development_mik branch with latest development merged in.

Superseded by #21 — consolidated to `development_mik` branch with latest `development` merged in.
mik-tf closed this pull request 2026-02-19 03:01:56 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
geomind_code/dev_docs!17
No description provided.