craft your forge, build your project, grow your community freely
1<!--
2SPDX-FileCopyrightText: 2025 Romain Maneschi <romain@gitroot.dev>
3 4SPDX-License-Identifier: EUPL-1.2
5--> 6 7# Changelog
8 9This file is made for human readers. It contain important (not all) changes made for a release, as well as the release date. Each version contains a link to all closed issues into the current version and a link to the binary corresponding to the version.
10 11At any time, you can find the latest GitRoot binary for linux amd64 at [https://gitroot.dev/releases/gitroot-last](https://gitroot.dev/releases/gitroot-last).
12 13## unreleased
14 15### GitRoot
16 17- run plugins in order of project not root
18- if a plugin has no file impacted, it will not run anymore
19- integrate `pollen` and `hop` plugin in [tests](./app/testsuite/runtest.sh)
20- **BREAKING** plugin sdk changes:
21- create [model.File](app/libs/golang/plugin/model/file.go)
22- from `AddFile(path string)` to `AddFile(file model.File)` 23- from `ModFile(fromPath string, toPath string)` to `ModFile(file model.File)` 24- from `DelFile(path string)` to `DelFile(file model.File)` 25- new plugin api:
26-`ExportFunc(name string, callback func(args map[string]string) (map[string]string, error))` permit to export a function, when another plugin will call it, the callback will be called with args. Only string are permitted. Can return multiple values but only strings like args.
27-`CallFunc(plugin string, name string, args map[string]string) (map[string]string, error)` permit to call the function of another plugin. If the plugin don't exist or the plugin has not exported this function the rror will be `plugin or method not found`.
28 29### Plugins
30 31- hop
32- 0.0.2 compatible with gitroot plugin-sdk 0.4.0
33- pollen
34- 0.0.3 compatible with gitroot plugin-sdk 0.4.0
35- ladybug:
36- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
37- silo:
38- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
39- grafter:
40- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
41- apex:
42- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
43- render files in other branches than main [#de9a](./issues/close/de9a-apex-branch-graft.md)
44- emit report when render a file from other branch
45- fix bug: rendering of local link [#bf18](./issues/close/bf18-apex-local-link.md)
46- fix bug: impossible to put some metadata in apex [#71d7](./issues/close/71d7-apex-metadata-not-possible.md)
47- **BREAKING** don't render markdown by default. Install `apex_markdown` plugin to do it. And `apex_code` to hilight code in markdown.
48- **BREAKING** install `apex_code` plugin to render worktree with hilight on dource files.
49- depends on `apex_markdown` and `apex_code` which are optional dependencies
50- apex_markdown: export func `renderMd` with args `fp` the filepath of the mardown and `md` the content. Return `html` the result and `metas` the metadata.
51- depends on `apex_code` to render code
52- apex_code: export func `renderCode` with args `code` the code to render and `lang` the language of the code. Return `html` the result.
53 54## 0.3.0 (20/12/2025) [is last](https://gitroot.dev/releases/gitroot-last)
55 56Commit: `11ec919c30bb10bb73560e624f772675d1f34c91` 57 58[gitroot-0.3.0-linux-amd64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-linux-amd64) sha256 `9697a5a5b3ae2ecab339450908705bf53e393154d3d2c3ebed8b5f89cd0cee5e` 59[gitroot-0.3.0-linux-arm64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-linux-arm64) sha256 `e268cb95136f6f871d2090c1240c8d3952a58312fd4211b40646b553264ac32b` 60[gitroot-0.3.0-darwin-amd64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-darwin-amd64) sha256 `91eb4f5568acff907f99a51c38e14a443b65cae369c0451d033cc6b1a4bfa667` 61[gitroot-0.3.0-darwin-arm64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-darwin-arm64) sha256 `4b64f6807d01230ae6d2e4b89fa42c245ea9bf924a81d5eb5f929c6b12bfd5f7` 62 63### GitRoot
64 65- Add [🗨 Contact](./contact.md) page
66- Use mise tasks thanks to Zon Orti the #3 contributor 🚀
67- add in the plugin sdk the `report()` api, to be able to report something to user. Don't use it to report bad behavior, `log()` and `logError()` are here for that.
68- add `reporter` interface to plugin sdk, to prevent GitRoot that a plugin can report something to user. See grafter as the first use case.
69- **BREAKING** add `execconf` in forgeConf, permit to enable one kind of executor and to set it's conf
70- **BREAKING** add `externalsshaddr` and `externalhttpaddr` property in forgeConf, permit to display `git clone ssh://gitroot.dev/` in web for example [#a716](./issues/close/a716-conf-external-addr.md)
71- implement the first `updater` wich handle the previous breaking
72- add [rust](https://rust-lang.org/) lib to build plugin
73- add `Exec([]commands)` method for plugin, need exec permission
74- allow to name `malloc` and `free` function in wasn guest `gitrootAlloc` and `gitrootFree` 75- garbage memory of plugin between 2 calls
76- use [mise](https://mise.jdx.dev/) to simplify dev environment and update go, tinygo and node to latest version
77 78### Plugins
79 80- hop: execute process on host [hop-0.0.1.wasm](https://gitroot.dev/releases/0.3.0/hop-0.0.1.wasm) _sha256: b67e9418702648a493f40d4f5375b51a6ade2812382ddc43c4a1133d8c5c3b44_ 81- use the new report api
82- pollen: [pollen-0.0.2.wasm](https://gitroot.dev/releases/0.3.0/hop-0.0.2.wasm) _sha256: e6e94e93514d3fe1e65506f5ac72a01b84b792bc6c07009eadc194942fc63ca1_ 83- 0.0.2 compatible with gitroot plugin-sdk 0.3.0
84- ladybug: [ladybug-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/ladybug-0.0.3.wasm) _sha256: adfaf88dc15ca5d53019ff194a32abec9c914c6cdf676ef4de589c1a4cfd12d4_ 85- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
86- silo: [silo-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/silo-0.0.3.wasm) _sha256: f38f8b71b68eddd1ce895a645e8c27052aab1f7607fc8182beb66b4e3e0fd2df_ 87- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
88- grafter: [grafter-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/grafter-0.0.3.wasm) _sha256: 9d63e0a232ea8dcdbd28ffc5793b56eada5981fc85296dfb8fd7342b3379d4e2_ 89- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
90- implement reporter api to display hop reports
91- apex: [apex-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/apex-0.0.3.wasm) _sha256: 3f7e22f834ce7e16231f6fa08495517c1ec021cb801b9b2885345a8deb16ebf0_ 92- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
93- add favicon configuration [#8c3f](./issues/close/8c3f-apex-favicon.md)
94- add html metadata configuration
95- fix bug: 404 page not found is styled [#4c5b](./issues/close/4c5b-web-path-slash.md)
96- fix bug: current menu is now hilighted and marked with `aria-current="page"` [#6eeb](./issues/close/6eeb-apex-current-page.md)
97- **BREAKING** don't render metadata by default, file should have `apexRenderMetadatas: true` in metadata to allow it, not final solution but good enough for now
98 99## 0.2.0 (18/09/2025)
100101Commit: `089d7caca0dfd7ac079aa92021b5f896e9f0fdb1`102103[gitroot-0.2.0-linux-amd64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-linux-amd64) sha256 `91c37b86a36253dc9a25f89c772035ab8445fc7c2f8f330128cb12425cb9b2f6`104[gitroot-0.2.0-linux-arm64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-linux-arm64) sha256 `d866ac45007f94d4d9967915efcff6181a32fe0791e50845620c6152f8dc1651`105[gitroot-0.2.0-darwin-amd64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-darwin-amd64) sha256 `a8784f3b82c7814e36066c5dda7e540920378159654658dc7777c4fe73d1b59d`106[gitroot-0.2.0-darwin-arm64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-darwin-arm64) sha256 `70f23407a13b8dd20852382906c05dc2aa268f74cbef31358cec861cba89f04c`107108### GitRoot
109110- add [assemblyscript](https://www.assemblyscript.org/) lib to build plugin
111- add `ReplaceWebContentBuilder(filename, old, new)` method for plugin, need mod permission
112- after a merge delete branch and clean users.yml
113- cross compilation [#70d0](./issues/close/70d0-cross-compile.md)
114- add `Commits(from string, to string) ([]Commit, error)` method for plugin to access commits between 2 hash
115- check that the plugin is compatible with current version
116- update plugins: change URL in `plugins.yml` of root repository
117- download plugins from http(s) and checksum them
118- compile plugins AOT and keep compilation
119- garbage collect plugins after execution [#f1ab](./issues/close/f1ab-garbabe-collecte-plugins.md)
120- fix empty FS after execution [#95b0](./issues/close/95b0-plugins-fs-bug.md)
121122### Plugins
123124- pollen: rss generator [pollen-0.0.1.wasm](https://gitroot.dev/releases/0.2.0/pollen-0.0.1.wasm) _sha256: 49cd8e1846b1612a0d5686918b502fe29e070e7bf9613c1ba9a1dfe5417d0f2a_125- ladybug: [ladybug-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/ladybug-0.0.2.wasm) _sha256: 0c755bb2dc5cc037216b29ba1709875afee425ee429b6be97f0d5e137067acff_126- 0.0.2 compatible with gitroot
127- fix bug: do not delete `---` in body of files
128- silo: [silo-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/silo-0.0.2.wasm) _sha256: 66fe44b4e0984154bda0867a9b35ea39b0be3d92a89e4e542b70472fadf2f78e_129- 0.0.2 compatible with gitroot
130- create an empty board when nothing to display [#a7ca](./issues/close/a7ca-silo-empty-board.md)
131- fix bug: move of file delete old item [#7a80](./issues/close/7a80-silo-move-bug.md)
132- grafter: [grafter-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/grafter-0.0.2.wasm) _sha256: 9ce5e36af1fd53a6547ec51d55356a661a05ae617b16ef97b1eae0dd0cce22c0_133- 0.0.2 compatible with gitroot
134- better diff
135- **BREAKING** change state of graft in metadata
136- apex: [apex-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/apex-0.0.2.wasm) _sha256: 4c7d1b84f768a6aea11393ea2bc116a7be30fd12380fd7e11f283d5970028119_137- 0.0.2 compatible with gitroot
138- add line heading
139- generate branches page and one page by branch with commits
140141## 0.1.0 (20/05/2025)
142143Initial GitRoot version 🎉
144145Commit: `fa6d1600606efdc590eb2f0411305e971fdd854d`146147[gitroot-0.1.0-linux-amd64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-linux-amd64) sha256 `e70d24e2631708ae4b778f9f60de03fad5087dd1fb2845955a9ed5c758a5ca0a`148[gitroot-0.1.0-darwin-amd64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-darwin-amd64) sha256 `622abd155657f2b3674b9fab71de2438774005054deb30301787d3a1ff37ff1a`149[gitroot-0.1.0-darwin-arm64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-darwin-arm64) sha256 `7946ad03f109c7d9cdb93fc6ec1b0838b10dde3c7bf67d4254374f5f9b9b19a5`150151### GitRoot
152153- launch GitRoot by specifying where to store data (all data will be written in this path)
154- accept git commands through ssh (clone, pull and pull)
155- manage users (who can write in which repositories)
156- install and activate plugins
157- repositories can be viewed online
158159### Plugins
160161- ladybug: add properties to md files [ladybug-0.0.1.wasm](https://gitroot.dev/releases/0.1.0/ladybug-0.0.1.wasm) _sha256: af00a9f14a27399f383d0cc23415e14e7d6180c167d1504018f11166346ebb55_162- silo: regroup, filter, sort files in a new md file in git [silo-0.0.1.wasm](https://gitroot.dev/releases/0.1.0/silo-0.0.1.wasm) _sha256: 99bc06d9d6f020c5df216fd6134306079aec26eacee9ad9bbabbc259097e618a_163- grafter: manage, review and merge of branches in git [grafter-0.0.1.wasm](https://gitroot.dev/releases/0.1.0/grafter-0.0.1.wasm) _sha256: 6645615df36a9938adac300d8d46fe298f8f53fb2e69713a495b83b0f114f40a_164- apex: transform md file to html one and write them in web, optionally generate worktree [apex-0.0.1.wasm](https://gitroot.dev/releases/0.1.0/apex-0.0.1.wasm) _sha256: 9570f005ad70be04eab3c900acd11d5c2ccf48fef5d4c17536c9cf79c8fd333e_