Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ flatpak install --user flathub org.gnome.Platform//51 # once
make start-flatpak
```

New to developing inside the GNOME SDK? Justin's [Building GNOME Apps with Rust, Part 1: Getting Started](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) walks through the setup; the toolchain differs, the runtime workflow is the same.
New to developing inside the GNOME SDK? Justin's series [Building GNOME Apps with Rust](https://fromthearchitect.dev/series/building-gnome-apps-with-rust/) walks through it, starting from the setup in [Part 1: Getting Started](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) and then GObject, Blueprint, state and signals; the toolchain differs, the runtime workflow is the same.

## Ground rules

Expand Down
13 changes: 10 additions & 3 deletions DISTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -310,7 +310,7 @@ Il percorso seguente "ripercorre i passi" dei progetti studiati nell'ordine in c
| OpenAlternative | directory | 14 ott 2026 | **non inviata**: servono 250★ per repo con meno di 6 mesi (50★ dal 7 gen 2027) e un sito su dominio proprio; le schede gratuite escono una al giorno lavorativo | riprovare con `gknowledge.io` attivo |
| EveryDev.ai | directory di AI dev tools (c'è OpenKnowledge) | 14 ott 2026 | login GitHub fatto; serve completare l'onboarding del profilo prima di `/create/tool` | completare onboarding, poi compilare con `directories.md` |
| ClaudeKit (claudekit.io) | sito coreano curato a mano di strumenti per Claude Code (c'è nashsu) | 14 ott 2026 | **non raggiungibile**: nessun form, repo o contatto | nessuno |
| dev.to | articolo | 13 ott 2026 | [pubblicato](https://dev.to/francescobianco/i-turned-karpathys-llm-wiki-into-a-native-gnome-app-and-it-works-offline-130c). 17 ott: [commento di Justin (@fromthearchitect)](https://dev.to/fromthearchitect/comment/3i4d5), data/AI architect su Fedora che sta scrivendo un'app foto GNOME in Rust. Ha messo la stella; il `.deb` e `install.sh` non gli servono e chiede il Flatpak (non ha visto il remote su Pages: badge e tabella del README dicevano ancora "Flatpak planned"). Consiglia di sviluppare nel runtime GNOME e osserva che le pagine invecchiano per drift delle sorgenti, non per allucinazioni. Da qui nascono il controllo "stale sources" e `make start-flatpak` (PR #42, mergiato il 19 ott; il PR #43 corregge il click nella sidebar) | **risposto il 19 ott** dall'utente, dopo il rilascio della 0.3.0 con il Flatpak; ringraziato anche nell'[annuncio della 0.3](https://github.com/orgs/openapi/discussions/72). **Lui ha risposto la sera del 19 ott** ([commento](https://dev.to/fromthearchitect/comment/3ia9i)): apprezza `stale_sources` via MCP e il fix WAL/document portal, autorizza il link alla [Parte 1](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) della sua serie (aggiunto in CONTRIBUTING il 20 ott), proverà il Flatpak su Fedora 44 in settimana e aprirà issue (GitHub `justinf555`): smistarle per prime. Facoltativo: un breve "thanks, linked!" su dev.to. Più avanti: cross-promozione tra app GNOME e, se il rapporto cresce, co-maintainer per il packaging (§6). Ripubblicare su Medium con canonical a dev.to |
| dev.to | articolo | 13 ott 2026 | [pubblicato](https://dev.to/francescobianco/i-turned-karpathys-llm-wiki-into-a-native-gnome-app-and-it-works-offline-130c). 17 ott: [commento di Justin (@fromthearchitect)](https://dev.to/fromthearchitect/comment/3i4d5), data/AI architect su Fedora che sta scrivendo un'app foto GNOME in Rust. Ha messo la stella; il `.deb` e `install.sh` non gli servono e chiede il Flatpak (non ha visto il remote su Pages: badge e tabella del README dicevano ancora "Flatpak planned"). Consiglia di sviluppare nel runtime GNOME e osserva che le pagine invecchiano per drift delle sorgenti, non per allucinazioni. Da qui nascono il controllo "stale sources" e `make start-flatpak` (PR #42, mergiato il 19 ott; il PR #43 corregge il click nella sidebar) | **risposto il 19 ott** dall'utente, dopo il rilascio della 0.3.0 con il Flatpak; ringraziato anche nell'[annuncio della 0.3](https://github.com/orgs/openapi/discussions/72). **Lui ha risposto la sera del 19 ott** ([commento](https://dev.to/fromthearchitect/comment/3ia9i)): apprezza `stale_sources` via MCP e il fix WAL/document portal, autorizza il link alla [Parte 1](https://fromthearchitect.dev/posts/gnome-rust-part-1-getting-started/) della sua serie (aggiunto in CONTRIBUTING il 20 ott), proverà il Flatpak su Fedora 44 in settimana e aprirà issue (GitHub `justinf555`): smistarle per prime. **27 ott** ([commento](https://dev.to/fromthearchitect/comment/3iek7)): il Flatpak su Fedora 44 funziona, nessun problema; ringrazia per il link e segnala che la serie continua (è alla Parte 6 più un bonus). CONTRIBUTING ora linka la [pagina della serie](https://fromthearchitect.dev/series/building-gnome-apps-with-rust/). Risposta preparata per l'utente: grazie, link aggiornato, proposta di usare la sua serie come base di conoscenza demo di gknowledge (con link a ogni post, risultato mostrato a lui prima di pubblicare). Commentare con contenuto tecnico i suoi articoli recenti sulle liste GTK4 (0–1 reazioni), senza chiedere stelle. Più avanti: cross-promozione tra app GNOME e, se il rapporto cresce, co-maintainer per il packaging (§6). Ripubblicare su Medium con canonical a dev.to |
| Theo James (Medium, editor di *Better Workflow*) | classifica "8 Apps… Karpathy-Style LLM Knowledge Base" | 14 ott 2026 | testo pronto in `outreach.md` (risposta all'articolo o pitch alla pubblicazione); nessun contatto esterno | inviare da account Medium |
| Prahlad G. Menon (themenonlab.blog) | blog che ha coperto Tolaria e OKF | 14 ott 2026 | email pronta in `outreach.md` (prahlad.menon@quant.md) | inviare |
| awesome-gnome (1.622★, c'è Newelle) | lista awesome | — | **saltata**: richiede release stabili mature | proporre dopo Flathub |
Expand All @@ -320,8 +320,8 @@ Il percorso seguente "ripercorre i passi" dei progetti studiati nell'ordine in c
| [awesome-for-beginners #2143](https://github.com/MunGell/awesome-for-beginners/pull/2143) | lista per principianti (90k★, pubblico forte in India e Africa) | 14 ott 2026 | PR aperta (`data.json`, Python, `good first issue`) | attendere merge |
| [awesome-hacktoberfest-2026 #22](https://github.com/Piyushhbhutoria/awesome-hacktoberfest-2026/pull/22) | lista Hacktoberfest (62★), sezione Coding for Beginners | 15 ott 2026 | PR aperta; ultimo merge del maintainer a nov 2025 | attendere merge |
| [ollama/ollama #19001](https://github.com/ollama/ollama/pull/19001) | README Community Integrations (183k★), sezione RAG & Knowledge Bases | 14 ott 2026 | PR aperta; 80+ PR README in coda, merge rari | attendere |
| [awesome-context-engineering #88](https://github.com/yzfly/awesome-context-engineering/pull/88) | lista awesome (211★, molto attiva, merge quasi quotidiani), sezione Memory & Compression accanto a LWC e Dory | 16 ott 2026 | PR aperta (EN + CN). La #69 per openapi-llm-wiki era stata chiusa come "vendor-specific catalog": il maintainer vuole metodi o strumenti riutilizzabili, descritti per meccanismo; ringraziato sulla #69 con link alla #88 | attendere merge |
| [PyPI `gknowledge-mcp`](https://pypi.org/project/gknowledge-mcp/) + [registro MCP ufficiale](https://registry.modelcontextprotocol.io/v0/servers?search=gknowledge) | pacchetto e registro MCP (`io.github.openapi/gknowledge`) | 16 ott 2026 | **pubblicati** 0.2.2 dal workflow `mcp.yml` (trusted publishing + OIDC); `uvx gknowledge-mcp --init` verificato. awesome-mcp-servers: [#16623](https://github.com/punkpeye/awesome-mcp-servers/pull/16623) chiusa il 16 ott (chiesto un server per PR), divisa il 19 ott in [#16968](https://github.com/punkpeye/awesome-mcp-servers/pull/16968) (mcp-server) e [#16969](https://github.com/punkpeye/awesome-mcp-servers/pull/16969) (gknowledge) | seguire le due PR; controllare Glama e PulseMCP |
| [awesome-context-engineering #88](https://github.com/yzfly/awesome-context-engineering/pull/88) | lista awesome (211★, molto attiva, merge quasi quotidiani), sezione Memory & Compression accanto a LWC e Dory | 16 ott 2026 | **mergiata il 24 ott** da yzfly (EN + CN). La #69 per openapi-llm-wiki era stata chiusa come "vendor-specific catalog": il maintainer vuole metodi o strumenti riutilizzabili, descritti per meccanismo; ringraziato sulla #69 con link alla #88. Il 27 ott ringraziato sulla #88 con invito a guardare e seguire l'org | — |
| [PyPI `gknowledge-mcp`](https://pypi.org/project/gknowledge-mcp/) + [registro MCP ufficiale](https://registry.modelcontextprotocol.io/v0/servers?search=gknowledge) | pacchetto e registro MCP (`io.github.openapi/gknowledge`) | 16 ott 2026 | **pubblicati** 0.2.2 dal workflow `mcp.yml` (trusted publishing + OIDC); `uvx gknowledge-mcp --init` verificato. awesome-mcp-servers: [#16623](https://github.com/punkpeye/awesome-mcp-servers/pull/16623) chiusa il 16 ott (chiesto un server per PR), divisa il 19 ott in [#16968](https://github.com/punkpeye/awesome-mcp-servers/pull/16968) (mcp-server) e [#16969](https://github.com/punkpeye/awesome-mcp-servers/pull/16969) (gknowledge). 27 ott: mcp-server rivendicato su Glama, voto B, punkpeye ringraziato sulla #16968; gknowledge inviato a Glama: email di rifiuto ("descrive un'app GNOME, non un server MCP"), ma la scheda `openapi/gknowledge` è comparsa comunque con voto A (il reinvio come `gknowledge-mcp` è stato rifiutato come doppione). Badge aggiunto nella #16969, punkpeye ringraziato | attendere il merge delle due PR. Controllare PulseMCP |
| [awesome-gtk](https://github.com/valpackett/awesome-gtk/pull/465) | lista awesome GTK (Office → Note-taking) | 19 ott 2026 | il maintainer (GerryT11) chiede di aspettare: progetto troppo giovane (prima release 13 ott). Ringraziato e PR chiusa | riproporre (riaprire #465 o nuova PR, menzionando GerryT11) dopo la release su Flathub e qualche mese di release |
| PyCoder's Weekly | newsletter Python (form Google) | 14 ott 2026 | modulo compilato, **invio bloccato** dal classificatore auto mode | inviare a mano con i testi di `emerging.md` |
| TabNews, r/developersIndia, Hashnode, Viblo, Techpoint Africa, organizzatori Hack Day | comunità e stampa in Africa e paesi emergenti | 14 ott 2026 | testi pronti in `emerging.md` | pubblicare dal proprio account; r/developersIndia solo nel thread Showcase dell'8 nov |
Expand Down Expand Up @@ -530,6 +530,13 @@ Obiettivo originale: 30+ stelle nelle 24 ore dello Show HN, per entrare nel tren
- Link incrociati (azione 10): una riga in openapi-skills e openapi-python-sdk (sezione "Related projects"), in mcp-server ("Useful Resources") e nel README del profilo dell'org. Le PR vanno aperte dall'utente: il classificatore di auto mode blocca le scritture su altri repository.
- Glama: scheda ancora assente (404 su `glama.ai/mcp/servers/openapi/gknowledge`); serve il login dell'utente.

**Stato al 27 ottobre 2026.**

- **Glama.** `openapi/mcp-server` risulta rivendicato dall'account dell'utente e ha voto B: il badge già presente nella riga della #16968 si risolve, punkpeye ringraziato. `openapi/gknowledge` inviato con nome e descrizione da app ed è stato **rifiutato**: per il revisore descriveva un'app GNOME e non un server MCP, e cita la descrizione del repo ("native GNOME knowledge workstation"). Reinviato come `gknowledge-mcp`, con descrizione che parte da "Stdio MCP server" ed elenca i tool: rifiutato perché "MCP server already exists for this repository". Infatti la scheda `openapi/gknowledge` esiste e ha voto A, nonostante l'email di rifiuto del primo invio. Badge aggiunto nella riga della #16969, punkpeye ringraziato. Le email di Glama non vanno prese alla lettera: verificare il badge (`<title>` dell'SVG).
- **Lezione per le directory MCP**: presentare gknowledge come `gknowledge-mcp` con i tool in prima riga, non come app; la descrizione del repo su GitHub pesa nella revisione.
- **awesome-context-engineering #88**: mergiata il 24 ott; ringraziato yzfly con invito a seguire l'org.
- **Justin**: Flatpak verificato su Fedora 44 (primo test esterno fuori da Ubuntu); CONTRIBUTING linka tutta la sua serie. Risposta su dev.to all'utente.

### 10.4 Il post su Hacker News del 19 ottobre

Il 19 ottobre alle 14:36 UTC l'utente ha pubblicato su HN [*The Second Brain Gnome Users Deserve. Go Ahead, HN. Flag This OpenSourceProject*](https://news.ycombinator.com/item?id=50153030), con link all'annuncio [#72](https://github.com/orgs/openapi/discussions/72) e non al repo, senza prefisso "Show HN". Alla pubblicazione: primo su /newest, visibile anche senza login, 1 punto, 0 commenti.
Expand Down
4 changes: 2 additions & 2 deletions TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Flatpak (the `.deb` and `install.sh` do nothing for Fedora, Arch or openSUSE use
- [x] `flatpak install --user https://openapi.github.io/gknowledge/io.gknowledge.Gknowledge.flatpakref` works on Ubuntu (2026-10-19): pulls GNOME 51 from Flathub, installs 0.2.2, the app launches.
- [x] Inside the Flatpak, New Project failed with "disk I/O error" (SQLite WAL needs shared memory the document portal does not provide); the store no longer uses WAL and converts old databases. Project creation, PDF/Markdown import, ingest, query and drift check verified on a portal path (2026-10-19).
- [x] Inside the Flatpak, by hand: create a project, import through the file chooser, ingest, reopen after a restart (2026-10-19).
- [ ] Verify on a non-Ubuntu distro: Justin will install the Flatpak on Fedora 44 the week of 2026-10-20 and open issues for anything that breaks (GitHub `justinf555`); triage them first.
- [x] Verify on a non-Ubuntu distro: Justin installed the Flatpak on Fedora 44 and reported it works, no issues ([comment of 2026-10-27](https://dev.to/fromthearchitect/comment/3iek7)). Still triage first anything he opens as `justinf555`.
- [x] README: badge and comparison table no longer say "Flatpak planned" (install section left as is).
- [x] Vendor `pypdf` 6.19.0 in the manifest (the 0.2.2 bundle has `No module named 'pypdf'`, so PDF import fails). Builds green on PR #42.
- [x] Release 0.3.0, tagged 2026-10-19: `.deb` and `.flatpak` on the release, `gknowledge-mcp` 0.3.0 on PyPI. A fresh install from the Pages flatpakref works, and the old ID's ref carries the end-of-life-rebase to the new one.
Expand All @@ -21,7 +21,7 @@ Flatpak (the `.deb` and `install.sh` do nothing for Fedora, Arch or openSUSE use
Develop against the runtime users get
- [x] `make start-flatpak`: the `make start` loop run inside `org.gnome.Platform` (version read from the manifest), so host GTK/libadwaita differences show up before release.
- [x] CONTRIBUTING documents `make start-flatpak`.
- [x] With Justin's permission ([reply of 2026-10-19](https://dev.to/fromthearchitect/comment/3ia9i)), CONTRIBUTING links his GNOME SDK setup write-up (Part 1 of his GNOME + Rust series).
- [x] With Justin's permission ([reply of 2026-10-19](https://dev.to/fromthearchitect/comment/3ia9i)), CONTRIBUTING links his GNOME SDK setup write-up (Part 1 of his GNOME + Rust series); since 2026-10-27 it links the whole series page, now at Part 6.

Drift, not hallucination
- [x] `core/lint.py`: `ChangeDetector` flags ingested sources whose original file no longer matches the ingested hash, with the pages that cite them.
Expand Down
Loading