Skip to content

r6 big release #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
danimesq wants to merge 7 commits into
base: main
Choose a base branch
from
Open

r6 big release #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
4bcc76f
Add portable platform support
danimesq Aug 15, 2026
b42e432
Add changelog for portable support
danimesq Aug 15, 2026
2a0a8cb
Add dependency checks and environment stamp
danimesq Aug 15, 2026
a2a4bbe
Keep r6 and add VCS fallbacks
danimesq Aug 15, 2026
724480c
Keep r6 and add interactive installers
danimesq Aug 15, 2026
8c063ca
Store stamps under meta directory
danimesq Aug 15, 2026
bce9140
Use CID terminology and add CIDv0 fallback
danimesq Aug 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 86 additions & 0 deletions .meta/folderstamp/.folderstamp.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
This folder: /workspace/folderstamp
Platform: Linux
Storage Device: vda 64G disk 0x1af4
folderstamp version: r6
Method: Non-recursive
Dependency check:
Dependency OK: stat (/usr/bin/stat)
Dependency OK: git (/usr/bin/git)
Gitoxide/gix not found; Gitoxide is the default optional VCS accelerator.
You can install classic Git with your package manager, or install Gitoxide from GitHub Releases:
https://github.com/GitoxideLabs/gitoxide/releases/latest
Gitoxide usually provides the `gix` command; choose the asset for your OS/CPU architecture.
Optional dependency missing: pijul
Suggested install: sudo apt-get update && sudo apt-get install -y pijul
Dependency missing: ipfs
Dependency notice: ipfs is not installed.
Kubo is the reference IPFS implementation; you can download it from GitHub Releases:
https://github.com/ipfs/kubo/releases/latest
Choose the release asset that matches your OS and CPU architecture, then run the install script shipped in the archive.
Linux example after downloading the correct tarball:
tar -xzf kubo_*.tar.gz
cd kubo && sudo ./install.sh
Termux users should install into $PREFIX/bin instead of relying on sudo.
Current Git Branch: work
First Git Remote: none

File: ./CHANGELOG.md
Size: 3716 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752568 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:34:00.897075331 +0000
Modify: 2026-08-15 21:41:58.517830670 +0000
Change: 2026-08-15 21:41:58.517830670 +0000
Birth: 2026-08-15 21:23:22.977075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./GPTConversation.txt
Size: 0 Blocks: 0 IO Block: 4096 regular empty file
Device: 254,0 Inode: 2752564 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:18:15.113075331 +0000
Modify: 2026-08-15 21:18:15.113075331 +0000
Change: 2026-08-15 21:18:15.113075331 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./SKILL.md
Size: 3410 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752596 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:41:46.329075331 +0000
Modify: 2026-08-15 21:41:46.337075331 +0000
Change: 2026-08-15 21:41:46.337075331 +0000
Birth: 2026-08-15 21:41:46.329075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./folderstamp
Size: 13384 Blocks: 32 IO Block: 4096 regular file
Device: 254,0 Inode: 304776 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:42:13.537075331 +0000
Modify: 2026-08-15 21:42:13.526483206 +0000
Change: 2026-08-15 21:42:13.526483206 +0000
Birth: 2026-08-15 21:19:38.081075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./install.sh
Size: 1770 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 304777 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:41:29.169075331 +0000
Modify: 2026-08-15 21:41:29.160516908 +0000
Change: 2026-08-15 21:41:29.160516908 +0000
Birth: 2026-08-15 21:19:38.101075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./to-do.md
Size: 3189 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752565 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:34:00.897075331 +0000
Modify: 2026-08-15 21:41:58.517988779 +0000
Change: 2026-08-15 21:41:58.517988779 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
86 changes: 86 additions & 0 deletions .meta/folderstamp/.folderstamp.2
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
This folder: /workspace/folderstamp
Platform: Linux
Storage Device: vda 64G disk 0x1af4
folderstamp version: r6
Method: Non-recursive
Dependency check:
Dependency OK: stat (/usr/bin/stat)
Dependency OK: git (/usr/bin/git)
Gitoxide/gix not found; Gitoxide is the default optional VCS accelerator.
You can install classic Git with your package manager, or install Gitoxide from GitHub Releases:
https://github.com/GitoxideLabs/gitoxide/releases/latest
Gitoxide usually provides the `gix` command; choose the asset for your OS/CPU architecture.
Optional dependency missing: pijul
Suggested install: sudo apt-get update && sudo apt-get install -y pijul
Dependency missing: ipfs
Dependency notice: ipfs is not installed.
Kubo is the reference IPFS implementation; you can download it from GitHub Releases:
https://github.com/ipfs/kubo/releases/latest
Choose the release asset that matches your OS and CPU architecture, then run the install script shipped in the archive.
Linux example after downloading the correct tarball:
tar -xzf kubo_*.tar.gz
cd kubo && sudo ./install.sh
Termux users should install into $PREFIX/bin instead of relying on sudo.
Current Git Branch: work
First Git Remote: none

File: ./CHANGELOG.md
Size: 4072 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752568 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:42:16.265075331 +0000
Modify: 2026-08-15 21:48:43.143856235 +0000
Change: 2026-08-15 21:48:43.143856235 +0000
Birth: 2026-08-15 21:23:22.977075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./GPTConversation.txt
Size: 0 Blocks: 0 IO Block: 4096 regular empty file
Device: 254,0 Inode: 2752564 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:18:15.113075331 +0000
Modify: 2026-08-15 21:18:15.113075331 +0000
Change: 2026-08-15 21:18:15.113075331 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./SKILL.md
Size: 3661 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752596 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:42:22.281075331 +0000
Modify: 2026-08-15 21:48:43.144023860 +0000
Change: 2026-08-15 21:48:43.144023860 +0000
Birth: 2026-08-15 21:41:46.329075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./folderstamp
Size: 14760 Blocks: 32 IO Block: 4096 regular file
Device: 254,0 Inode: 304776 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:48:27.765075331 +0000
Modify: 2026-08-15 21:48:27.754685338 +0000
Change: 2026-08-15 21:48:27.754685338 +0000
Birth: 2026-08-15 21:19:38.081075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./install.sh
Size: 1770 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 304777 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:41:29.169075331 +0000
Modify: 2026-08-15 21:41:29.160516908 +0000
Change: 2026-08-15 21:41:29.160516908 +0000
Birth: 2026-08-15 21:19:38.101075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
File: ./to-do.md
Size: 3307 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752565 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:42:16.265075331 +0000
Modify: 2026-08-15 21:48:43.143501723 +0000
Change: 2026-08-15 21:48:43.143501723 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash: unavailable (ipfs command not found)
------------------------------
86 changes: 86 additions & 0 deletions .meta/folderstamp/.folderstamp.3
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
This folder: /workspace/folderstamp
Platform: Linux
Storage Device: vda 64G disk 0x1af4
folderstamp version: r6
Method: Non-recursive
Dependency check:
Dependency OK: stat (/usr/bin/stat)
Dependency OK: git (/usr/bin/git)
Gitoxide/gix not found; Gitoxide is the default optional VCS accelerator.
You can install classic Git with your package manager, or install Gitoxide from GitHub Releases:
https://github.com/GitoxideLabs/gitoxide/releases/latest
Gitoxide usually provides the `gix` command; choose the asset for your OS/CPU architecture.
Optional dependency missing: pijul
Suggested install: sudo apt-get update && sudo apt-get install -y pijul
Dependency missing: ipfs
Dependency notice: ipfs is not installed.
Kubo is the reference IPFS implementation; you can download it from GitHub Releases:
https://github.com/ipfs/kubo/releases/latest
Choose the release asset that matches your OS and CPU architecture, then run the install script shipped in the archive.
Linux example after downloading the correct tarball:
tar -xzf kubo_*.tar.gz
cd kubo && sudo ./install.sh
Termux users should install into $PREFIX/bin instead of relying on sudo.
Current Git Branch: work
First Git Remote: none

File: ./CHANGELOG.md
Size: 4343 Blocks: 16 IO Block: 4096 regular file
Device: 254,0 Inode: 2752568 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:48:54.393075331 +0000
Modify: 2026-08-15 22:05:03.102721184 +0000
Change: 2026-08-15 22:05:03.102721184 +0000
Birth: 2026-08-15 21:23:22.977075331 +0000
CID hash (CIDv0 basic): Qmd4hqT99WhMYmTpPLws5SRLBCMD2egZsbBDieFD1i73r3
------------------------------
File: ./GPTConversation.txt
Size: 0 Blocks: 0 IO Block: 4096 regular empty file
Device: 254,0 Inode: 2752564 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:18:15.113075331 +0000
Modify: 2026-08-15 21:18:15.113075331 +0000
Change: 2026-08-15 21:18:15.113075331 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash (CIDv0 basic): QmaRwA91m9Rdfaq9u3FH1fdMVxw1wFPjKL38czkWMxh3KB
------------------------------
File: ./SKILL.md
Size: 3885 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752596 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:48:54.393075331 +0000
Modify: 2026-08-15 22:05:03.103067684 +0000
Change: 2026-08-15 22:05:03.103067684 +0000
Birth: 2026-08-15 21:41:46.329075331 +0000
CID hash (CIDv0 basic): QmTnorbPrC2d3gyWESggEMcRyPNAK57qEJnvs7w7YGzGZ6
------------------------------
File: ./folderstamp
Size: 16316 Blocks: 32 IO Block: 4096 regular file
Device: 254,0 Inode: 304776 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 22:04:42.101075331 +0000
Modify: 2026-08-15 22:04:42.086841849 +0000
Change: 2026-08-15 22:04:42.086841849 +0000
Birth: 2026-08-15 21:19:38.081075331 +0000
CID hash (CIDv0 basic): QmdGuAqejCYyUPzCWnqhqNbhnbeo2CqrqoKy2przgJYgxy
------------------------------
File: ./install.sh
Size: 1770 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 304777 Links: 1
Access: (0755/-rwxr-xr-x) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:41:29.169075331 +0000
Modify: 2026-08-15 21:41:29.160516908 +0000
Change: 2026-08-15 21:41:29.160516908 +0000
Birth: 2026-08-15 21:19:38.101075331 +0000
CID hash (CIDv0 basic): QmR67K2SMN9TDdz9yMtqRX3UjQRkGSn4Y9K9g5i8rpf7SJ
------------------------------
File: ./to-do.md
Size: 3402 Blocks: 8 IO Block: 4096 regular file
Device: 254,0 Inode: 2752565 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 0/ root) Gid: ( 0/ root)
Access: 2026-08-15 21:48:54.393075331 +0000
Modify: 2026-08-15 22:05:03.102904574 +0000
Change: 2026-08-15 22:05:03.102904574 +0000
Birth: 2026-08-15 21:18:15.113075331 +0000
CID hash (CIDv0 basic): QmXVfjpdwc7pf3h2ETeqedRmmjdvykzVvtFzHV5t6qHSLf
------------------------------
58 changes: 58 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Changelog

Todas as mudanças relevantes deste projeto serão documentadas aqui.

O formato segue a ideia do [Keep a Changelog](https://keepachangelog.com/), com versões em ordem cronológica reversa.

## [r6] - 2026-08-15

### Added
- Adicionado relatório de dependências no `folderstamp`, detectando `stat`, `git`/Gitoxide, `pijul` e `ipfs`.
- Renomeado o rótulo de saída de `IPFS hash:` para `CID hash:` para cobrir IPFS, Iroh e outros ecossistemas que usam CID sem acoplar marca.
- Iniciada implementação básica de geração de CIDv0 sem Kubo/IPFS usando Python 3 para arquivos single-block UnixFS/DAG-PB.
- Alterado `save` para armazenar novos stamps em `.meta/folderstamp/` em vez de criar `.folderstamp` na raiz.
- Adicionada migração automática de `.folderstamp` legado para `.meta/folderstamp/.folderstamp.1`, criando o próximo número disponível para novos stamps.
- Adicionada tarefa para avaliar Iroh como alternativa Rust para gerar CIDv0 e CIDv1.
- Adicionado instalador interativo para Kubo/IPFS e Gitoxide via GitHub Releases quando o usuário confirma no prompt.
- Adicionado Gitoxide como opção padrão sugerida mesmo quando Git clássico já existe, sem exigir passos manuais em sessão interativa.
- Adicionado suporte de portabilidade para BSD, macOS e Zircon/Fuchsia.
- Criado `SKILL.md` com práticas de Bash portátil, diagnósticos, dependências e documentação usadas nesta sequência de patches.
- Adicionada opção orientada para instalar Git pelo package manager ou Gitoxide via GitHub Releases quando nenhum dos dois está instalado.
- Adicionado suporte a repositórios Pijul ao lado do Git, exibindo canal atual quando `.pijul` existe.
- Adicionada oferta de instalação do Kubo/IPFS via GitHub Releases quando `ipfs` não está instalado.
- Adicionadas sugestões de instalação por package manager para dependências ausentes em Termux, Cygwin, RedoxOS e Linux comum.
- Adicionado `.folderstamp` versionado com o stamp do ambiente atual.
- Criado `to-do.md` organizado a partir do antigo `Tasks.txt`, com novas ideias de portabilidade, documentação e UX.
- Adicionado suporte explícito à detecção de plataforma para Termux, Cygwin e RedoxOS, mantendo compatibilidade com Linux padrão.
- Adicionada saída `Platform:` ao comando `folderstamp display`, facilitando debug em ambientes diferentes.
- Adicionado fallback para detalhes de armazenamento: usa `lsblk` quando disponível e recorre a `df -hP` quando `lsblk` não existe.
- Adicionado fallback para IPFS ausente, exibindo uma mensagem clara quando o comando `ipfs` não está instalado.
- Adicionada seleção automática de diretório de instalação no `install.sh`:
- Termux: `${PREFIX}/bin` ou `/data/data/com.termux/files/usr/bin`.
- Cygwin: `/usr/local/bin`.
- RedoxOS: `${HOME}/bin`.
- Linux padrão: `/usr/bin`.

### Changed
- Renomeado `Tasks.txt` para `to-do.md`, com checkboxes e seções temáticas.
- Mantida a versão interna do `folderstamp` em `r6`.
- Centralizada a lógica de carimbo de arquivos na função `stamp_path`, reduzindo duplicação entre os modos recursivo e não-recursivo.
- Centralizada a leitura de dados Git na função `print_git_details`, com tratamento para repositórios sem remote configurado.
- O instalador deixou de depender obrigatoriamente de `sudo`; agora usa `sudo` apenas quando o diretório de destino exige permissão elevada e o comando está disponível.
- `folderstamp` e `install.sh` passaram a ser instaláveis/executáveis diretamente, com permissão de execução versionada no Git.

### Fixed
- Evitada falha em ambientes sem `lsblk`, comuns em Termux e outros sistemas minimalistas.
- Evitada falha em ambientes sem `ipfs`, substituindo o erro por uma mensagem informativa.
- Evitada falha ao exibir informações Git quando o repositório não possui remote configurado.
- Evitada dependência rígida de `/usr/bin`, que não é o destino correto em Termux, Cygwin ou RedoxOS.

## [r5] - Antes de 2026-08-15

### Existing
- Exibição do diretório atual.
- Exibição de informações de armazenamento via `lsblk` em Linux.
- Exibição da branch Git atual e primeiro remote quando `.git` existe.
- Suporte aos comandos `display` e `save`.
- Suporte ao modo recursivo com `--recursive` ou `-r`.
- Geração de hash IPFS usando `ipfs add -q --only-hash`.
Loading