Skip to content

Commit 45fde55

Browse files
committed
Add Linux native packaging README
1 parent ece8f3e commit 45fde55

1 file changed

Lines changed: 53 additions & 0 deletions

File tree

packaging/linux/README.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# TurtleTerm Linux Native Packaging
2+
3+
TurtleTerm is Linux-first. This directory stages native Linux package metadata after Homebrew and release tarball install paths.
4+
5+
## Current package scaffolds
6+
7+
- `deb/control`
8+
- `rpm/turtle-term.spec`
9+
- `arch/PKGBUILD`
10+
11+
## Shared package layout
12+
13+
All native package lanes should use:
14+
15+
```bash
16+
packaging/scripts/stage-linux-package.sh
17+
```
18+
19+
The staged layout includes:
20+
21+
```text
22+
bin/turtleterm
23+
bin/turtleterm-mux-server
24+
bin/turtle-term
25+
bin/turtle-agentd
26+
bin/turtle-agentctl
27+
bin/turtle-tmux
28+
bin/sourceos-term
29+
etc/turtle-term/turtleterm.lua
30+
libexec/turtle-term/
31+
share/applications/ai.sourceos.TurtleTerm.desktop
32+
share/metainfo/ai.sourceos.TurtleTerm.metainfo.xml
33+
share/icons/hicolor/scalable/apps/ai.sourceos.TurtleTerm.svg
34+
share/turtle-term/
35+
```
36+
37+
## Validation
38+
39+
Run:
40+
41+
```bash
42+
packaging/scripts/verify-linux-package-layout.sh
43+
```
44+
45+
The verifier stages the package layout with stub runtime binaries and checks public commands, private runtime isolation, metadata, profile, and agent CLI behavior.
46+
47+
## Not done yet
48+
49+
- Real `.deb` build workflow
50+
- Real `.rpm` build workflow
51+
- Real Arch package build workflow
52+
- Release checksums for Arch source package
53+
- SourceOS image integration

0 commit comments

Comments
 (0)