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- sync plugin inactive plugin in sub repositories
20- integrate `pollen` and `hop` plugin in [tests](./app/testsuite/runtest.sh)
21- **BREAKING** plugin sdk changes:
22- create [model.File](app/libs/golang/plugin/model/file.go)
23- from `AddFile(path string)` to `AddFile(file model.File)` 24- from `ModFile(fromPath string, toPath string)` to `ModFile(file model.File)` 25- from `DelFile(path string)` to `DelFile(file model.File)` 26- new plugin api:
27-`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.
28-`CanCallFunc(plugin string, name string, args map[string]string) bool` check if a plugin can call a function. If plugin is not installed/activated, has not the func or user has disable the call to it, you will get a false.
29-`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`.
30-`CopyFile(fromFs model.FsBase, fromPath string, toFs model.FsBase, toPath string) error` copy a file from an fs to another
31-`DeleteFile(fromFs model.FsBase, filename string) error` delete a file
32-`MoveFile(fromFs model.FsBase, fromPath string, toFs model.FsBase, toPath string) error` move a file fron a fs to another
33-`ReplaceContent(fromFs model.FsBase, filepath string, oldContent string, content string) error ` replace content of a file
34-`WriteContent(fromFs model.FsBase, filepath string, content string) error` write to a file
35- deprecated plugin api:
36-`ModifyContent(filepath, content string)` use `Worktree().WriteContent(filepath, content string)` 37-`ModifyWebContent(filepath, content string)` use `Webcontent().WriteContent(filepath, content string)` 38-`ReplaceWebContent(filepath, oldContent, content string)` use `Webcontent().ReplaceContent(filepath, oldContent, content string)` 39-`ModifyCacheContent(filepath, content string)` use `Cache().WriteContent(filepath, content string)` 40- new executors features:
41- stats of sub cmd [#ea2f](./issues/close/ea2f-executor-stats-v2.md)
42- ssh stats [#d9ee](./issues/close/d9ee-ssh-executor-stats.md)
43- can have cache [#94af](./issues/94af-executor-cache.md)
44- can have artifacts [#9ea8](./issues/close/9ea8-executor-artifacts.md)
45- set env var correctly
46- **BREAKING** Removed the requirement to sign commits and push using the same SSH key.
47- GitRoot no longer generates `.gitroot/init.sh` and `.gitroot/allowed_signers` files.
48- Users can now push unsigned commits or commits from other authors (enabling rebases with plugin commits).
49- The `stigma` plugin can be used to restore this functionality with the following behavior:
50- Generates `.gitroot/init.sh` and `.gitroot/allowed_signers` files.
51- Maintains the `.gitroot/allowed_signers` file with all valid keys.
52- Reports unsigned commits as warnings.
53- Reports invalidly signed commits as errors.
54- start to clean tests by adding libs and cmd in testsuite.
55 56### Plugins
57 58- stigma: assists in configuring, verifying, and reporting on commit signatures.
59- hop
60- 0.0.2 compatible with gitroot plugin-sdk 0.4.0
61- rework report layout
62- **BREAKING** add `pipelinesToWebDir` in conf to make artifacts and logs accessible in web, set empty to desable, `/pipelines` by default
63- pollen
64- 0.0.3 compatible with gitroot plugin-sdk 0.4.0
65- ladybug:
66- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
67- silo:
68- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
69- clean cache when conf has changed [#4f54](./issues/close/4f54-change-global-conf.md)
70- grafter:
71- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
72- apex:
73- 0.0.4 compatible with gitroot plugin-sdk 0.4.0
74- render files in other branches than main [#de9a](./issues/close/de9a-apex-branch-graft.md)
75- emit report when render a file from other branch
76- fix bug: rendering of local link [#bf18](./issues/close/bf18-apex-local-link.md)
77- fix bug: impossible to put some metadata in apex [#71d7](./issues/close/71d7-apex-metadata-not-possible.md)
78- **BREAKING** don't render markdown by default. Install `apex_markdown` plugin to do it. And `apex_code` to hilight code in markdown.
79- **BREAKING** install `apex_code` plugin to render worktree with hilight on dource files.
80- depends on `apex_markdown` and `apex_code` which are optional dependencies
81- add layouts to extend representation of data [#bbf1](./issues/close/bbf1-apex-layout-materialization.md)
82- 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.
83- depends on `apex_code` to render code
84- depends on `apex_mermaid` to render mermaid charts
85- apex_code: export func `renderCode` with args `code` the code to render and `lang` the language of the code. Return `html` the result.
86- apex_mermaid: export func `renderCode` with args `code` the code mermaid to render. Return `html` (svg) the result.
87 88## 0.3.0 (20/12/2025) [is last](https://gitroot.dev/releases/gitroot-last)
89 90Commit: `11ec919c30bb10bb73560e624f772675d1f34c91` 91 92[gitroot-0.3.0-linux-amd64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-linux-amd64) sha256 `9697a5a5b3ae2ecab339450908705bf53e393154d3d2c3ebed8b5f89cd0cee5e` 93[gitroot-0.3.0-linux-arm64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-linux-arm64) sha256 `e268cb95136f6f871d2090c1240c8d3952a58312fd4211b40646b553264ac32b` 94[gitroot-0.3.0-darwin-amd64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-darwin-amd64) sha256 `91eb4f5568acff907f99a51c38e14a443b65cae369c0451d033cc6b1a4bfa667` 95[gitroot-0.3.0-darwin-arm64](https://gitroot.dev/releases/0.3.0/gitroot-0.3.0-darwin-arm64) sha256 `4b64f6807d01230ae6d2e4b89fa42c245ea9bf924a81d5eb5f929c6b12bfd5f7` 96 97### GitRoot
98 99- Add [🗨 Contact](./contact.md) page
100- Use mise tasks thanks to Zon Orti the #3 contributor 🚀
101- 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.
102- add `reporter` interface to plugin sdk, to prevent GitRoot that a plugin can report something to user. See grafter as the first use case.
103- **BREAKING** add `execconf` in forgeConf, permit to enable one kind of executor and to set it's conf
104- **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)
105- implement the first `updater` wich handle the previous breaking
106- add [rust](https://rust-lang.org/) lib to build plugin
107- add `Exec([]commands)` method for plugin, need exec permission
108- allow to name `malloc` and `free` function in wasn guest `gitrootAlloc` and `gitrootFree`109- garbage memory of plugin between 2 calls
110- use [mise](https://mise.jdx.dev/) to simplify dev environment and update go, tinygo and node to latest version
111112### Plugins
113114- hop: execute process on host [hop-0.0.1.wasm](https://gitroot.dev/releases/0.3.0/hop-0.0.1.wasm) _sha256: b67e9418702648a493f40d4f5375b51a6ade2812382ddc43c4a1133d8c5c3b44_115- use the new report api
116- pollen: [pollen-0.0.2.wasm](https://gitroot.dev/releases/0.3.0/hop-0.0.2.wasm) _sha256: e6e94e93514d3fe1e65506f5ac72a01b84b792bc6c07009eadc194942fc63ca1_117- 0.0.2 compatible with gitroot plugin-sdk 0.3.0
118- ladybug: [ladybug-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/ladybug-0.0.3.wasm) _sha256: adfaf88dc15ca5d53019ff194a32abec9c914c6cdf676ef4de589c1a4cfd12d4_119- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
120- silo: [silo-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/silo-0.0.3.wasm) _sha256: f38f8b71b68eddd1ce895a645e8c27052aab1f7607fc8182beb66b4e3e0fd2df_121- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
122- grafter: [grafter-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/grafter-0.0.3.wasm) _sha256: 9d63e0a232ea8dcdbd28ffc5793b56eada5981fc85296dfb8fd7342b3379d4e2_123- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
124- implement reporter api to display hop reports
125- apex: [apex-0.0.3.wasm](https://gitroot.dev/releases/0.3.0/apex-0.0.3.wasm) _sha256: 3f7e22f834ce7e16231f6fa08495517c1ec021cb801b9b2885345a8deb16ebf0_126- 0.0.3 compatible with gitroot plugin-sdk 0.3.0
127- add favicon configuration [#8c3f](./issues/close/8c3f-apex-favicon.md)
128- add html metadata configuration
129- fix bug: 404 page not found is styled [#4c5b](./issues/close/4c5b-web-path-slash.md)
130- fix bug: current menu is now hilighted and marked with `aria-current="page"` [#6eeb](./issues/close/6eeb-apex-current-page.md)
131- **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
132133## 0.2.0 (18/09/2025)
134135Commit: `089d7caca0dfd7ac079aa92021b5f896e9f0fdb1`136137[gitroot-0.2.0-linux-amd64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-linux-amd64) sha256 `91c37b86a36253dc9a25f89c772035ab8445fc7c2f8f330128cb12425cb9b2f6`138[gitroot-0.2.0-linux-arm64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-linux-arm64) sha256 `d866ac45007f94d4d9967915efcff6181a32fe0791e50845620c6152f8dc1651`139[gitroot-0.2.0-darwin-amd64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-darwin-amd64) sha256 `a8784f3b82c7814e36066c5dda7e540920378159654658dc7777c4fe73d1b59d`140[gitroot-0.2.0-darwin-arm64](https://gitroot.dev/releases/0.2.0/gitroot-0.2.0-darwin-arm64) sha256 `70f23407a13b8dd20852382906c05dc2aa268f74cbef31358cec861cba89f04c`141142### GitRoot
143144- add [assemblyscript](https://www.assemblyscript.org/) lib to build plugin
145- add `ReplaceWebContentBuilder(filename, old, new)` method for plugin, need mod permission
146- after a merge delete branch and clean users.yml
147- cross compilation [#70d0](./issues/close/70d0-cross-compile.md)
148- add `Commits(from string, to string) ([]Commit, error)` method for plugin to access commits between 2 hash
149- check that the plugin is compatible with current version
150- update plugins: change URL in `plugins.yml` of root repository
151- download plugins from http(s) and checksum them
152- compile plugins AOT and keep compilation
153- garbage collect plugins after execution [#f1ab](./issues/close/f1ab-garbabe-collecte-plugins.md)
154- fix empty FS after execution [#95b0](./issues/close/95b0-plugins-fs-bug.md)
155156### Plugins
157158- pollen: rss generator [pollen-0.0.1.wasm](https://gitroot.dev/releases/0.2.0/pollen-0.0.1.wasm) _sha256: 49cd8e1846b1612a0d5686918b502fe29e070e7bf9613c1ba9a1dfe5417d0f2a_159- ladybug: [ladybug-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/ladybug-0.0.2.wasm) _sha256: 0c755bb2dc5cc037216b29ba1709875afee425ee429b6be97f0d5e137067acff_160- 0.0.2 compatible with gitroot
161- fix bug: do not delete `---` in body of files
162- silo: [silo-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/silo-0.0.2.wasm) _sha256: 66fe44b4e0984154bda0867a9b35ea39b0be3d92a89e4e542b70472fadf2f78e_163- 0.0.2 compatible with gitroot
164- create an empty board when nothing to display [#a7ca](./issues/close/a7ca-silo-empty-board.md)
165- fix bug: move of file delete old item [#7a80](./issues/close/7a80-silo-move-bug.md)
166- grafter: [grafter-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/grafter-0.0.2.wasm) _sha256: 9ce5e36af1fd53a6547ec51d55356a661a05ae617b16ef97b1eae0dd0cce22c0_167- 0.0.2 compatible with gitroot
168- better diff
169- **BREAKING** change state of graft in metadata
170- apex: [apex-0.0.2.wasm](https://gitroot.dev/releases/0.2.0/apex-0.0.2.wasm) _sha256: 4c7d1b84f768a6aea11393ea2bc116a7be30fd12380fd7e11f283d5970028119_171- 0.0.2 compatible with gitroot
172- add line heading
173- generate branches page and one page by branch with commits
174175## 0.1.0 (20/05/2025)
176177Initial GitRoot version 🎉
178179Commit: `fa6d1600606efdc590eb2f0411305e971fdd854d`180181[gitroot-0.1.0-linux-amd64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-linux-amd64) sha256 `e70d24e2631708ae4b778f9f60de03fad5087dd1fb2845955a9ed5c758a5ca0a`182[gitroot-0.1.0-darwin-amd64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-darwin-amd64) sha256 `622abd155657f2b3674b9fab71de2438774005054deb30301787d3a1ff37ff1a`183[gitroot-0.1.0-darwin-arm64](https://gitroot.dev/releases/0.1.0/gitroot-0.1.0-darwin-arm64) sha256 `7946ad03f109c7d9cdb93fc6ec1b0838b10dde3c7bf67d4254374f5f9b9b19a5`184185### GitRoot
186187- launch GitRoot by specifying where to store data (all data will be written in this path)
188- accept git commands through ssh (clone, pull and pull)
189- manage users (who can write in which repositories)
190- install and activate plugins
191- repositories can be viewed online
192193### Plugins
194195- 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_196- 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_197- 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_198- 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_