diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e09e7e9..4df2522 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -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 diff --git a/DISTRIBUTING.md b/DISTRIBUTING.md index 587bf34..0e57079 100644 --- a/DISTRIBUTING.md +++ b/DISTRIBUTING.md @@ -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 | @@ -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 | @@ -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 (`` 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. diff --git a/TODO.md b/TODO.md index 15de91b..3f1162c 100644 --- a/TODO.md +++ b/TODO.md @@ -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. @@ -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.