DeepWorkPlan Vim

DeepWorkPlan Vim è l’editor da terminale di Deep Work Plan: una configurazione Neovim per le persone, e per gli agenti di programmazione, che lavorano in un terminale. I Suoi piani, la documentazione e un indice di tutti i comandi sono a un tasto di distanza.

È un prodotto separato, offerto come addon facoltativo vim di Deep Work Plan v7 (v7.0.0). Deep Work Plan funziona con qualsiasi editor o con nessuno, e l’editor non richiede Deep Work Plan: lo si aggiunge a una macchina da solo e funziona come editor che esista o meno un piano. Questa pagina descrive la release v0.5.0.

Perché un editor da terminale per Deep Work Plan

Un Deep Work Plan è una cartella di Markdown in .dwp/plans/: un obiettivo, task atomici, validation gate e un registro continuo. Le persone lo rivedono, gli agenti lo eseguono, e gli uni e gli altri lo fanno spesso da un terminale. Un editor pensato per questo lavoro tiene vicine tre cose: il piano stesso, la documentazione che lo circonda e i tasti che permettono di passare dall’uno all’altra.

DeepWorkPlan Vim è quell’editor. È una configurazione Neovim curata — language server, completamento, linting, formattazione, ricerca fuzzy, un albero dei file e temi di colore selezionati, caricati in modo differito — più le poche superfici che ne fanno l’editor per Deep Work Plan.

Il tour: un indice dei comandi che non può invecchiare

Prema SPC h h (Spazio è il tasto leader), oppure esegua :DwpCommands, e l’editor elenca ogni mappatura che possiede con una descrizione di una riga. L’elenco è generato dalle mappature attive, quindi una mappatura definita ovunque compare nell’indice senza essere registrata, e l’indice non può diventare obsoleto.

Questo è l’intero tour: avvii nvim, poi prema Spazio, h, h.

Che cosa si ottiene

Cinque funzioni, ciascuna a un tasto di distanza.

I piani senza lasciare l’editor

SPC P, :DwpPlans o un clic sul segmento della riga di stato apre la barra laterale dei piani. Copre ogni cartella .dwp/plans/ della directory corrente e della directory di configurazione di Neovim e ordina i piani partendo da quelli che richiedono più attenzione. Nell’editor le etichette sono Working, Needs attention, Ready, Not started e Done. Ogni piano mostra una barra di avanzamento.

Prema Invio su un piano per aprire il lettore: l’obiettivo in una frase, lo stato e l’avanzamento, l’elenco dei task con quella corrente evidenziata e collegamenti in linguaggio semplice ai file del piano stesso. La riga di stato mostra il piano attivo in tempo reale e la schermata iniziale elenca i primi tre. Queste superfici spiegano i piani; non scrivono mai in .dwp/.

Per leggere sul posto i file Markdown di un piano, SPC m p mostra l’anteprima del buffer corrente nel browser e SPC m r lo renderizza nel buffer. Entrambi funzionano solo nei buffer Markdown.

Installazione

L’installazione è composta da tre comandi: scarichi lo script, lo verifichi con lo SHA-256 del file servito da questo sito, poi lo esegua. L’installer fissa la propria release, quindi installa esattamente v0.5.0, la release descritta in questa pagina, a meno che non scelga un’altra versione.

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
echo "4890c140528d6b8d19b6bbc4102051e0b9dce2e26f43a693bdeab2e1cd8e196b  install.sh" | shasum -a 256 -c && \
bash install.sh

In ordine, l’installer:

1. Controlla il sistema operativo e il gestore di pacchetti e installa git, curl e un interprete Lua se ne manca qualcuno (nessuno con --skip-packages).
2. Risolve la versione: la propria release, oppure quella richiesta da --version.
3. Con --nvim X.Y.Z, installa quella release di Neovim in ~/.local/opt, verificata con lo SHA-256 pubblicato da Neovim.
4. Chiede prima di toccare una configurazione Neovim esistente. Senza terminale, si ferma e non cambia nulla, a meno che --yes non gli indichi di spostare da parte quella configurazione.
5. Clona il repository in ~/.config/nvim oppure lo aggiorna se è già presente.
6. Esegue il lua install.lua del repository.
7. Installa i plugin in modalità headless e li verifica, quindi non serve chiudere e riaprire. Con --strict, un’installazione dei plugin non riuscita o incompleta è un errore.

Lo script servito qui è una copia identica byte per byte di install.sh al tag v0.5.0. Il suo checksum è servito accanto, all’indirizzo https://deepworkplan.com/vim/install.sh.sha256, quindi può verificare il download con shasum -a 256 -c install.sh.sha256 (su Linux, sha256sum -c install.sh.sha256). Per una verifica da una seconda origine, lo confronti con la riga di install.sh in SHA256SUMS nella release su GitHub. Esegua bash install.sh --help per elencare tutte le opzioni.

Scegliere una versione

Per impostazione predefinita l’installer installa la propria release, v0.5.0. Per sceglierne un’altra, imposti DWP_VIM_VERSION o passi --version: fanno la stessa cosa, quindi usi quello che si legge meglio; un’opzione prevale sull’ambiente. Ciascuno accetta:

Dopo il download e la verifica del checksum descritti sopra:

# exact version
DWP_VIM_VERSION=0.5.0 bash install.sh
bash install.sh --version 0.5.0

# minimum floor: the newest stable release at or above 0.4.2
DWP_VIM_VERSION='>=0.4.2' bash install.sh

# latest stable release
bash install.sh --version latest

Metta il minimo tra virgolette, così che la shell non interpreti > come un reindirizzamento. Le versioni si risolvono solo in tag di release stabili. Per un ramo o un commit, imposti invece DWP_VIM_REF (DWP_VIM_REF=main segue main); una versione e un riferimento in disaccordo sono un errore.

Container e CI

In un’immagine o in un job di CI, dove non c’è un terminale e spesso nemmeno l’accesso root, scarichi e verifichi lo script, poi lo esegua in un solo passaggio con opzioni che rendono il risultato riproducibile:

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
sha256sum -c install.sh.sha256 && \
bash install.sh --version 0.5.0 --nvim 0.12.5 --skip-packages --strict

• --version 0.5.0 fissa la release dell’editor.
• --nvim 0.12.5 installa quella release di Neovim in ~/.local/opt/nvim-v0.12.5, collegata come ~/.local/bin/nvim e verificata con lo SHA-256 pubblicato da Neovim (Linux e macOS).
• --skip-packages non installa alcun pacchetto di sistema: l’immagine deve già fornire git, curl e Lua.
• --strict termina con un codice diverso da zero quando l’installazione headless dei plugin non riesce o lascia plugin mancanti.

Ogni opzione ha una variabile d’ambiente equivalente (DWP_VIM_VERSION, DWP_VIM_NVIM, DWP_VIM_SKIP_PACKAGES=1, DWP_VIM_STRICT=1). Aggiunga --yes solo quando l’immagine può già contenere una configurazione Neovim da spostare da parte.

Requisiti e piattaforme

• Neovim 0.12 o successivo. Lo installi da sé, oppure lasci che l’installer aggiunga una release verificata con --nvim X.Y.Z (Linux e macOS).
• Lua: lua, lua5.4 o luajit. L’installer ne aggiunge uno se manca.
• macOS, Linux e WSL eseguono l’installer. Windows ha un percorso manuale documentato nel README del repository: installare Neovim con winget, clonare il tag v0.5.0 in %LOCALAPPDATA%\nvim ed eseguire lua install.lua da Git Bash.
• Licenza GPL-3.0: libero da usare, studiare e modificare.

Aggiornare, fissare la versione e disinstallare

Per aggiornare, esegua l’installer di una release più recente, oppure esegua bash install.sh --version latest. Rieseguirlo sposta un checkout esistente di DeepWorkPlan Vim alla release scelta, conserva i suoi rami e non azzera mai le modifiche locali: quando andrebbero perse modifiche o commit locali, si ferma e non cambia nulla.

Per fissare una release, usi --version (si veda Scegliere una versione); per un ramo o un commit, imposti DWP_VIM_REF. Preferisca una release: le release precedenti a v0.4.0 non includono i gesti, il browser dei piani, il visualizzatore Markdown né questo installer.

# pin a specific release, here the previous one
curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
shasum -a 256 -c install.sh.sha256 && \
bash install.sh --version 0.4.2

Per disinstallare, esegua lua delete.lua dalla directory di configurazione. Rimuove la configurazione, i plugin, i dati di Mason, la cache e lo stato e la copia del font fatta dall’installer, e lascia intatti il binario di Neovim e i pacchetti di sistema.

cd ~/.config/nvim && lua delete.lua

Domande

Sovrascriverà la mia configurazione di Neovim?

No, non senza la Sua approvazione. Quando trova una configurazione che non è DeepWorkPlan Vim, un’esecuzione interattiva chiede prima di spostarla in ~/.config/previous-deepworkplan-vim. Senza terminale si ferma e non cambia nulla, a meno che non passi --yes per spostarla da parte senza intervento. Se quel percorso di backup esiste già, si ferma sempre e non cambia nulla.

Funziona su Windows?

L’installer non funziona su Windows. Usi il percorso manuale del README del repository, oppure esegua l’installer dentro WSL.

Mi serve Deep Work Plan per usarlo?

No. È prima di tutto un editor. Non installa né richiede la skill di Deep Work Plan; il browser dei piani semplicemente non ha nulla da elencare finché non esiste una cartella .dwp/plans/.

Come lo usa l’addon vim della v7?

Deep Work Plan v7 offre l’editor come addon facoltativo vim durante l’onboarding. L’addon rileva un’installazione esistente in sola lettura, tramite il file addon/surface.json dell’editor, e offre l’installazione fissata e verificata tramite checksum solo con il Suo consenso. Non sovrascrive mai una configurazione Neovim esistente senza un’approvazione esplicita, e non è mai obbligatorio.

Come lo usano gli agenti di programmazione?

È pensato per le persone e per gli agenti di programmazione che vivono in un terminale. Le sue combinazioni di tasti sono fissate da test di contratto, quindi la memoria muscolare, e ciò che un agente si aspetta, sopravvivono agli aggiornamenti.

Quale versione ottengo?

L’installer installa la release a cui appartiene — oggi v0.5.0 — a meno che non ne scelga un’altra con --version o DWP_VIM_VERSION: una versione esatta, un minimo >= o latest. DWP_VIM_REF accetta un ramo o un commit; DWP_VIM_REF=main segue main. Questa pagina descrive la release v0.5.0, che include tutte le funzioni elencate qui.

Con quale licenza è distribuito e da dove deriva?

GPL-3.0. Deriva da mu-vim di Andrés M Prieto e il riconoscimento resta nel repository.

Codice sorgente e licenza

Il codice sorgente è nel repository di DeepWorkPlan Vim. È pubblico e con licenza GPL-3.0, derivato da mu-vim.

Voci correlate del kit

• Devcontainer — ambiente di sviluppo riproducibile (primo addon)
• Dailybot — report del ciclo di vita del piano visibili al team (secondo addon)
• AI Diff Reviewer — revisione locale durante le Final Review del piano (quinto addon)
• Herdr — delegare un task a un agente peer in un pannello Herdr (v7)
• Agentkit — un solo comando per ogni agente di programmazione da terminale, e delega headless (v7)