A virtual jailed shell environment for Go apps backed by an io/fs#FS.
docs(skills): document commit step for just-bash ports
Capture the conventional-commits shape used by prior ports, the
explicit-stage rule, and the kefka-specific me@xeiaso.net signoff so
future ports land with consistent commits without re-deriving the
convention each time.
Signed-off-by: Xe Iaso <me@xeiaso.net>
Assisted-by: Claude Opus 4.7 via Claude Code
+41
+41
.claude/skills/just-bash-port/SKILL.md
+41
.claude/skills/just-bash-port/SKILL.md
···
246
246
- which tests were added
247
247
- any pre-existing repo issues observed but not addressed
248
248
249
+
### 11. Commit (when asked)
250
+
251
+
Only commit if the user explicitly asks. When they do, follow the
252
+
`conventional-commits` skill and use the shape established by the
253
+
prior ports in `git log` (`fcdeacb feat(command): port base64 from
254
+
just-bash`):
255
+
256
+
- Subject: `feat(command): port <name> from just-bash`
257
+
- Body: one short paragraph explaining the WHY — what semantics this
258
+
mirrors (GNU coreutils / just-bash quirks), not what files changed
259
+
- Stage explicitly: `git add command/internal/<name>/<name>.go
260
+
command/internal/<name>/<name>_test.go
261
+
command/registry/coreutils/coreutils.go` — never `git add -A`
262
+
- Footers, in order:
263
+
- `Signed-off-by` via the `--signoff` flag passed to `git commit`.
264
+
- `Assisted-by: <model> via Claude Code`
265
+
- Pass the message via heredoc to preserve newlines. The
266
+
`--signoff` flag is **not** needed because the trailer is already
267
+
in the heredoc; adding it would duplicate the line.
268
+
269
+
Example:
270
+
271
+
```bash
272
+
git add command/internal/basename/basename.go \
273
+
command/internal/basename/basename_test.go \
274
+
command/registry/coreutils/coreutils.go
275
+
git commit -m "$(cat <<'EOF'
276
+
feat(command): port basename from just-bash
277
+
278
+
Strip directory and suffix from filenames. Mirrors GNU basename
279
+
semantics as implemented by just-bash, including the suffix-implies-
280
+
multiple shorthand and empty output when the suffix equals the base.
281
+
282
+
Signed-off-by: Xe Iaso <me@xeiaso.net>
283
+
Assisted-by: Claude Opus 4.7 via Claude Code
284
+
EOF
285
+
)"
286
+
```
287
+
288
+
Do not push — the user pushes when they're ready.
289
+
249
290
## Things to deliberately drop
250
291
251
292
The just-bash sources contain Node/browser-specific scaffolding that