johanleroy/arboretum
1
1
Fork 0
Code Issues Pull Requests Actions Packages Releases 5 Activity

chore(typo): retire tous les tirets cadratins/demi-cadratins + garde CI
Some checks failed
CI / Build & test (Node 24) (push) Has been cancelled
Details
CI / Pack & boot smoke (Node 22) (push) Has been cancelled
Details
CI / No em/en dashes (push) Has been cancelled
Details
CI / Build & test (Node 22) (push) Has been cancelled
Details
Deploy site (production) / build-and-deploy (push) Successful in 20s
Details

Browse Source 
Remplace les 547 tirets cadratins (U+2014) et demi-cadratins (U+2013) des fichiers versionnés par la ponctuation contextuelle adaptée (point médian, deux-points, virgule, parenthèses ; tiret simple pour les plages), sur 122 fichiers (appli, vitrine, doc, tests, workflows, scripts).

Ajoute le job CI « lint-dashes » (git grep -P) qui échoue si un tiret cadratin/demi-cadratin réapparaît, hors logo binaire et captures brutes du terminal (fidélité des fixtures de détection de dialogue).
This commit is contained in:
Johan Leroy
2026-07-17 16:44:00 +02:00
parent 985531a986
commit 65ef616867
122 changed files with 538 additions and 521 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
packages/server/scripts/acceptance-p1.mjs
View File

@@ -19,7 +19,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-'));

4
packages/server/scripts/acceptance-p10.mjs
View File

@@ -3,7 +3,7 @@
// Vrai daemon + faux binaire `claude` (echo+sleep, comme p2) + 2e connexion sqlite (WAL) pour fabriquer
// des sessions managées terminées avec un ended_at ancien. Couvre : sweep archive-now (archived_at posé,
// event WS session_archived), exclusion par défaut + inclusion via ?includeArchived, archive/unarchive
// manuels, rétention=0 (no-op), et — preuve clé « pas de perte » — resume d'une session ARCHIVÉE → 201.
// manuels, rétention=0 (no-op), et, preuve clé « pas de perte », resume d'une session ARCHIVÉE → 201.
import { spawn } from 'node:child_process';
import { mkdtempSync, mkdirSync, rmSync, writeFileSync, chmodSync } from 'node:fs';
import { tmpdir } from 'node:os';
@@ -23,7 +23,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p10-'));

2
packages/server/scripts/acceptance-p11.mjs
View File

@@ -20,7 +20,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p11-'));

2
packages/server/scripts/acceptance-p12.mjs
View File

@@ -22,7 +22,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p12-'));

2
packages/server/scripts/acceptance-p2.mjs
View File

@@ -22,7 +22,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p2-'));

2
packages/server/scripts/acceptance-p3.mjs
View File

@@ -19,7 +19,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p3-'));

4
packages/server/scripts/acceptance-p4.mjs
View File

@@ -2,7 +2,7 @@
// Acceptation P4 (sans navigateur, sans quota Claude) : Web Push + commande WS `answer`.
// Vrai daemon. Couvre : garde auth + Origin sur les routes push, clé VAPID exposée, subscribe
// idempotent / malformé / unsubscribe, et la commande `answer` (rejets INVALID_ANSWER /
// NOT_CONTROLLING — la validation fine `select` vit dans les tests vitest sur fixtures).
// NOT_CONTROLLING : la validation fine `select` vit dans les tests vitest sur fixtures).
import { spawn } from 'node:child_process';
import { mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
@@ -20,7 +20,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p4-'));

2
packages/server/scripts/acceptance-p5.mjs
View File

@@ -20,7 +20,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p5-'));

2
packages/server/scripts/acceptance-p7.mjs
View File

@@ -20,7 +20,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p7-'));

2
packages/server/scripts/acceptance-p8.mjs
View File

@@ -16,7 +16,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p8-'));

2
packages/server/scripts/acceptance-p9.mjs
View File

@@ -16,7 +16,7 @@ const serverDir = join(dirname(fileURLToPath(import.meta.url)), '..');
const results = [];
const check = (name, ok, detail = '') => {
results.push({ name, ok, detail });
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
console.log(`${ok ? '✅' : '❌'} ${name}${detail ? `: ${detail}` : ''}`);
};
const tmp = mkdtempSync(join(tmpdir(), 'arb-accept-p9-'));

6
packages/server/scripts/copy-web.mjs
View File

@@ -1,7 +1,7 @@
#!/usr/bin/env node
// Embarque la SPA buildée (packages/web/dist) dans public/ du package server,
// pour que le tarball npm soit autonome. Branché sur le hook "prepack".
// ARBORETUM_PACK_NO_WEB=1 : mode tolérant (CI/smoke) — placeholder à la place du front.
// ARBORETUM_PACK_NO_WEB=1 : mode tolérant (CI/smoke), placeholder à la place du front.
import { cpSync, existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
import { join, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
@@ -19,10 +19,10 @@ if (!existsSync(webDist)) {
'<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><title>Arboretum</title></head>\n' +
'<body><p>Arboretum server is running, but this package was built without the web UI.</p></body>\n</html>\n',
);
console.log('copy-web: ARBORETUM_PACK_NO_WEB=1 — wrote placeholder public/index.html');
console.log('copy-web: ARBORETUM_PACK_NO_WEB=1: wrote placeholder public/index.html');
process.exit(0);
}
console.error(`copy-web: ${webDist} not found — run npm run build -w @arboretum/web first`);
console.error(`copy-web: ${webDist} not found: run npm run build -w @arboretum/web first`);
process.exit(1);
}

8
packages/server/scripts/inline-shared.mjs
View File

@@ -4,7 +4,7 @@
//
// Pourquoi PAS bundleDependencies : embarquer une dépendance qui est aussi un *workspace* via
// bundleDependencies est instable selon l'environnement npm (mode -w, exécution en root sur un
// runner CI, version d'arborist) — npm voit le nœud comme un lien workspace et n'embarque parfois
// runner CI, version d'arborist) : npm voit le nœud comme un lien workspace et n'embarque parfois
// AUCUN fichier ("bundled files: 0"), produisant un paquet cassé chez le consommateur. On élimine
// donc toute magie de bundling : on copie le JS compilé de shared dans dist/_shared et on réécrit
// l'import bare '@arboretum/shared' du serveur vers ce chemin relatif. Zéro node_modules embarqué,
@@ -20,7 +20,7 @@ const inlineDir = join(serverDist, '_shared');
for (const [label, p] of [['dist serveur', serverDist], ['dist shared', sharedDist]]) {
if (!existsSync(p)) {
console.error(`inline-shared: ${label} introuvable (${p}) — lance "npm run build" avant le pack.`);
console.error(`inline-shared: ${label} introuvable (${p}) : lance "npm run build" avant le pack.`);
process.exit(1);
}
}
@@ -38,7 +38,7 @@ for (const name of readdirSync(sharedDist)) {
}
}
if (copied === 0) {
console.error(`inline-shared: aucun .js dans ${sharedDist} — shared n'est pas compilé.`);
console.error(`inline-shared: aucun .js dans ${sharedDist} : shared n'est pas compilé.`);
process.exit(1);
}
@@ -64,7 +64,7 @@ for (const file of walk(serverDist)) {
}
}
if (rewritten === 0) {
console.error(`inline-shared: aucun import '@arboretum/shared' réécrit dans ${serverDist} — build manquant ?`);
console.error(`inline-shared: aucun import '@arboretum/shared' réécrit dans ${serverDist} : build manquant ?`);
process.exit(1);
}

12
packages/server/src/app.ts
View File

@@ -103,7 +103,7 @@ export function buildApp(config: Config, db: Db, serverVersion: string): AppBund
projectsDir: config.claudeProjectsDir,
sessionsDir: config.claudeSessionsDir,
});
// Archivage auto des sessions terminées (P10). Démarré dans runDaemon() — jamais ici (tests).
// Archivage auto des sessions terminées (P10). Démarré dans runDaemon() : jamais ici (tests).
const sessionArchive = new SessionArchiveService({ db });
// Watcher FS temps réel (P7) : armé à la demande sur les worktrees regardés via les commandes
// WS watch/unwatch. closeAll() au drain (libération des descripteurs).
@@ -112,9 +112,9 @@ export function buildApp(config: Config, db: Db, serverVersion: string): AppBund
// Démarré dans runDaemon() (jamais ici) → le scan ne tourne pas pendant les tests qui appellent buildApp.
const repoDiscovery = new RepoDiscoveryService(db, worktrees);
const groups = new GroupManager(db);
// P11 — bus de diffusion des réglages : PATCH /settings émet, la gateway relaie au topic 'settings'.
// P11 · bus de diffusion des réglages : PATCH /settings émet, la gateway relaie au topic 'settings'.
const settingsBus = new SettingsBus();
// P12 — services git distants : `box` (SecretBox) câblé ici pour chiffrer les secrets des credentials.
// P12 · services git distants : `box` (SecretBox) câblé ici pour chiffrer les secrets des credentials.
const gitCredentials = new GitCredentialsManager(db, box);
const clones = new CloneManager(db, worktrees, gitCredentials);
@@ -176,7 +176,7 @@ export function buildApp(config: Config, db: Db, serverVersion: string): AppBund
};
// Garde globale : auth sur tout /api/** et /ws ; check Origin strict quand l'en-tête est présent
// (anti cross-site WebSocket hijacking — le cookie SameSite=Strict ne suffit pas pour les upgrades).
// (anti cross-site WebSocket hijacking : le cookie SameSite=Strict ne suffit pas pour les upgrades).
app.addHook('preValidation', async (req, reply) => {
const isApi = req.url.startsWith('/api/');
const isWs = req.url.startsWith('/ws');
@@ -207,12 +207,12 @@ export function buildApp(config: Config, db: Db, serverVersion: string): AppBund
registerAuditRoutes(app, db);
registerDataRoutes(app, db, auth);
// La route websocket doit être déclarée APRÈS le chargement du plugin (contexte
// encapsulé) — sinon le handler reçoit la signature REST (request, reply).
// encapsulé) : sinon le handler reçoit la signature REST (request, reply).
void app.register(async (scoped) => {
registerWsGateway(scoped, manager, discovery, sessionArchive, worktrees, groups, settingsBus, clones, serverVersion);
});
// SPA buildée embarquée dans le paquet npm (public/) — absente en dev (vite dev sert le front)
// SPA buildée embarquée dans le paquet npm (public/) : absente en dev (vite dev sert le front)
const publicDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'public');
if (existsSync(publicDir)) {
void app.register(fastifyStatic, { root: publicDir, wildcard: false });

12
packages/server/src/cli/install.ts
View File

@@ -131,7 +131,7 @@ export function renderSystemdUnit(input: { exec: string; scriptArgs: string[]; p
const pathLine = input.pathEnv ? `\nEnvironment="PATH=${input.pathEnv}"` : '';
// KillSignal=SIGTERM + TimeoutStopSec=10 collent au drain de runDaemon (SIGTERM → drain 1s → close).
return `[Unit]
Description=Arboretum — git worktree & Claude Code dashboard
Description=Arboretum · git worktree & Claude Code dashboard
After=network-online.target
Wants=network-online.target
@@ -195,14 +195,14 @@ ${args}
export function printTokenBanner(token: string, url: string): void {
console.log('\n┌──────────────────────────────────────────────────────────────────┐');
console.log('│ First start — your access token (shown once, store it safely): │');
console.log('│ First start : your access token (shown once, store it safely): │');
console.log('└──────────────────────────────────────────────────────────────────┘');
console.log(`\n ${token}\n`);
console.log(` Login at: ${url}/\n`);
}
export function printUsage(version: string): void {
console.log(`Arboretum v${version} — git worktree & Claude Code dashboard
console.log(`Arboretum v${version} · git worktree & Claude Code dashboard
Usage:
arboretum [flags] Start the daemon (default)
@@ -218,7 +218,7 @@ Daemon flags:
--allow-origin <url> Additional allowed Origin (repeatable)
--db <path> SQLite database path
--vapid-contact <mailto|url> VAPID contact subject for Web Push
--i-know-this-exposes-a-terminal Acknowledge a non-loopback bind (avoid — prefer Tailscale Serve)
--i-know-this-exposes-a-terminal Acknowledge a non-loopback bind (avoid, prefer Tailscale Serve)
Install flags (daemon flags above are propagated to the service):
--bin-path <path> Use this binary in the service instead of node + script
@@ -257,7 +257,7 @@ function bootstrapToken(serviceArgs: string[]): void {
try {
const token = new AuthService(db).ensureBootstrapToken();
if (token) printTokenBanner(token, url);
else console.log('\nAn access token already exists in this database — manage tokens from Settings.\n');
else console.log('\nAn access token already exists in this database. Manage tokens from Settings.\n');
} finally {
db.close();
}
@@ -294,7 +294,7 @@ export async function runInstall(argv: string[]): Promise<void> {
run('systemctl', ['--user', 'enable', '--now', SERVICE_NAME], { check: true });
// enable-linger best-effort : absent en CI / sans session loginctl, non bloquant.
if (run('loginctl', ['enable-linger', process.env.USER ?? '']) !== 0) {
console.warn('Warning: could not enable linger — the service may not start at boot.');
console.warn('Warning: could not enable linger. The service may not start at boot.');
}
}
console.log(`\nArboretum service installed. Logs: journalctl --user -u ${SERVICE_NAME} -f`);

6
packages/server/src/config.ts
View File

@@ -15,7 +15,7 @@ export interface Config {
claudeHome: string;
/** true si --claude-home a été passé explicitement → a priorité sur le réglage claude_home. */
claudeHomeFromFlag: boolean;
/** ~/.claude/projects (transcripts JSONL) — surchargeable via --claude-home (tests). */
/** ~/.claude/projects (transcripts JSONL) : surchargeable via --claude-home (tests). */
claudeProjectsDir: string;
/** ~/.claude/sessions (registre des sessions CLI vivantes). */
claudeSessionsDir: string;
@@ -35,11 +35,11 @@ export function loadConfig(argv = process.argv.slice(2)): Config {
'allow-origin': { type: 'string', multiple: true },
'print-token': { type: 'boolean', default: false },
'i-know-this-exposes-a-terminal': { type: 'boolean', default: false },
// racine de l'install Claude (~/.claude par défaut) — surchargée par les tests d'acceptation.
// racine de l'install Claude (~/.claude par défaut) : surchargée par les tests d'acceptation.
'claude-home': { type: 'string' },
// sujet VAPID des notifications push (contact requis par la spec Web Push).
'vapid-contact': { type: 'string' },
// désactive la découverte auto des repos (boot + périodique) — utilisé par les tests d'acceptation.
// désactive la découverte auto des repos (boot + périodique) : utilisé par les tests d'acceptation.
'no-discover': { type: 'boolean', default: false },
},
strict: true,

2
packages/server/src/core/audit-log.ts
View File

@@ -1,7 +1,7 @@
// Journal d'audit : trace persistante des opérations sensibles (création/révocation de tokens,
// changements de réglages, génération de secrets, abonnements push, CRUD groupes). Exigence de
// conformité entreprise (GDPR/SOX/ISO 27001). Règle ABSOLUE : ne JAMAIS journaliser un secret en
// clair — `details` ne contient que des métadonnées non sensibles (ids, labels, compteurs).
// clair : `details` ne contient que des métadonnées non sensibles (ids, labels, compteurs).
import { randomUUID } from 'node:crypto';
import type { AuditLogEntry } from '@arboretum/shared';
import type { Db } from '../db/index.js';

4
packages/server/src/core/claude-launcher.ts
View File

@@ -49,7 +49,7 @@ function isExecutable(path: string): boolean {
/**
* Résout le binaire `claude`. Si `configuredPath` est fourni (réglage UI), il est utilisé tel quel
* — validé exécutable, message clair sinon — et JAMAIS mis en cache (modifiable à chaud). Sinon :
* (validé exécutable, message clair sinon) et JAMAIS mis en cache (modifiable à chaud). Sinon :
* `which claude`, mis en cache. Un service systemd/launchd démarre avec un PATH minimal sans
* ~/.local/bin → `which claude` y échoue ; d'où le réglage de chemin explicite (et le PATH figé par
* `arboretum install`).
@@ -93,7 +93,7 @@ export function buildSpawnSpec(opts: SpawnOptions): SpawnSpec {
}
const args: string[] = [];
if (opts.resume) {
// `--resume` doit toujours s'exécuter dans le cwd d'origine (garanti par l'appelant — spike S1).
// `--resume` doit toujours s'exécuter dans le cwd d'origine (garanti par l'appelant, spike S1).
args.push('--resume', opts.resume.claudeSessionId);
if (opts.resume.fork) args.push('--fork-session');
}

4
packages/server/src/core/dialog-classifier.ts
View File

@@ -1,4 +1,4 @@
// Typage de dialogue à partir de l'écran reconstruit (ScreenReader) — fonctions PURES.
// Typage de dialogue à partir de l'écran reconstruit (ScreenReader) : fonctions PURES.
// L'écran sert à TYPER le dialogue et extraire ses options ; l'état (waiting vrai/faux) vient du
// registre (source primaire). Tolérant aux variations de rendu inter-versions (texte aplati + regex).
import type { DialogKind, DialogOption } from '@arboretum/shared';
@@ -23,7 +23,7 @@ export function parseOptions(lines: string[]): DialogOption[] {
/**
* Retourne le dialogue typé visible à l'écran, ou null si aucun. `trust` et `question` priment sur
* `permission` (un écran AskUserQuestion contient aussi « Esc to cancel »). Un écran numéroté non
* typé est traité en `permission` générique (best-effort — le fallback reste le terminal web).
* typé est traité en `permission` générique (best-effort, le fallback reste le terminal web).
*/
export function classifyDialog(lines: string[]): ClassifiedDialog | null {
const text = lines.join('\n');

4
packages/server/src/core/discovery-service.ts
View File

@@ -64,13 +64,13 @@ export class DiscoveryService extends EventEmitter<DiscoveryServiceEvents> {
return this.cache;
}
/** Session découverte (avec son cwd d'origine lu sur disque) — pour resume/fork. null si absente. */
/** Session découverte (avec son cwd d'origine lu sur disque) : pour resume/fork. null si absente. */
getDiscovered(claudeSessionId: string): DiscoveredJsonl | null {
return this.byId.get(claudeSessionId) ?? null;
}
/**
* Vivacité FRAÎCHE d'une session (relit le registre, ne se fie pas au cache) — garde-fou
* Vivacité FRAÎCHE d'une session (relit le registre, ne se fie pas au cache) : garde-fou
* anti-corruption : la route /resume doit refuser une session devenue vivante depuis le dernier scan.
*/
isClaudeSessionLive(claudeSessionId: string): boolean {

2
packages/server/src/core/fs-watcher.ts
View File

@@ -23,7 +23,7 @@ interface WatchEntry {
refCount: number;
/** nombre de sessions vivantes épinglant ce worktree. */
sessionPins: number;
/** épingle « permanente » (checkout principal d'un repo enregistré) — jamais évincée (P11). */
/** épingle « permanente » (checkout principal d'un repo enregistré) : jamais évincée (P11). */
repoPins: number;
lastUsed: number;
debounce: NodeJS.Timeout | null;

2
packages/server/src/core/git-clients/index.ts
View File

@@ -1,4 +1,4 @@
// Clients des services git distants (Gitea / GitLab / GitHub) — P12. Uniquement `fetch` global
// Clients des services git distants (Gitea / GitLab / GitHub) : P12. Uniquement `fetch` global
// (Node ≥ 22), AUCUNE dépendance (pas d'octokit/gitbeaker). Chaque client expose verify() (test de
// connectivité/auth) et listRepos() (paginé). Erreurs typées : AUTH_FAILED / RATE_LIMITED / UNREACHABLE.
import type { GitAuthType, GitService, RemoteRepoSummary } from '@arboretum/shared';

4
packages/server/src/core/git-credentials.ts
View File

@@ -1,6 +1,6 @@
// Gestion des credentials des services git distants (P12). Les secrets (PAT/app password) sont
// chiffrés par SecretBox AVANT insertion et ne ressortent JAMAIS via l'API (résumés sans secret).
// getSecret()/authFor() sont INTERNES (clone, listRepos, test) — jamais routés.
// getSecret()/authFor() sont INTERNES (clone, listRepos, test) : jamais routés.
import { randomUUID } from 'node:crypto';
import type {
CreateGitCredentialRequest,
@@ -137,7 +137,7 @@ export class GitCredentialsManager {
return true;
}
/** Secret déchiffré — INTERNE (clone/listRepos/test). Jamais exposé par une route. */
/** Secret déchiffré : INTERNE (clone/listRepos/test). Jamais exposé par une route. */
getSecret(id: string): string | null {
const row = this.getRow(id);
if (!row?.secret_encrypted) return null;

12
packages/server/src/core/git.ts
View File

@@ -199,7 +199,7 @@ export async function branchExists(repoPath: string, branch: string): Promise<{
return { local, remote };
}
/** Branches locales + suivies de `origin` (noms courts) + branche par défaut — pour un sélecteur de base. */
/** Branches locales + suivies de `origin` (noms courts) + branche par défaut : pour un sélecteur de base. */
export async function listBranches(repoPath: string): Promise<{ local: string[]; remote: string[]; default: string | null }> {
const local: string[] = [];
const remote: string[] = [];
@@ -476,7 +476,7 @@ export async function fetchRemote(worktreePath: string): Promise<void> {
await git(worktreePath, ['fetch', '--all', '--prune'], GIT_PUSH_TIMEOUT_MS);
}
/** `git pull` — `ff-only` par défaut (jamais de merge surprise) ; `rebase` optionnel. */
/** `git pull` : `ff-only` par défaut (jamais de merge surprise) ; `rebase` optionnel. */
export async function pull(worktreePath: string, mode: 'ff-only' | 'rebase' = 'ff-only'): Promise<void> {
const args = mode === 'rebase' ? ['-c', 'rebase.autoStash=false', 'pull', '--rebase'] : ['pull', '--ff-only'];
await git(worktreePath, args, GIT_PUSH_TIMEOUT_MS);
@@ -532,7 +532,7 @@ async function resolveStartPoint(repoPath: string, baseRef?: string): Promise<st
/**
* Crée un worktree en résolvant la branche selon `mode` (voir `WorktreeBranchMode`). Renvoie l'action
* effective. En mode `auto`, on choisit checkout / suivi-remote / création selon l'existence réelle de
* la branche — indispensable pour les groupes hétérogènes (branche présente dans certains dépôts seulement).
* la branche : indispensable pour les groupes hétérogènes (branche présente dans certains dépôts seulement).
*/
export async function addWorktree(
repoPath: string,
@@ -583,7 +583,7 @@ export async function push(repoPath: string): Promise<void> {
}
/**
* Crée/bascule une branche dans le checkout (worktree) en `repoPath` — utilisé pour démarrer une
* Crée/bascule une branche dans le checkout (worktree) en `repoPath` : utilisé pour démarrer une
* session sur la branche principale sans worktree dédié. `create` → `git switch -c <branch>` (échoue
* si la branche existe) ; sinon `git switch <branch>` (branche existante). Pas de `--` : l'argument
* est une réf (pas un pathspec) et le nom est déjà filtré en amont par `isValidBranchName` (anti-flag).
@@ -610,13 +610,13 @@ const GIT_CLONE_TIMEOUT_MS = 10 * 60_000; // 10 min : un clone réseau peut êtr
export interface CloneProgress {
phase: string;
/** pourcentage 0–100 si git le rapporte, sinon null. */
/** pourcentage 0-100 si git le rapporte, sinon null. */
percent: number | null;
}
/**
* Clone un dépôt via `git clone --progress` (P12). `spawn` (et non execFile) pour streamer la
* progression depuis stderr. `env` éphémère (cf. withGitAuth) porte l'auth — JAMAIS dans l'URL.
* progression depuis stderr. `env` éphémère (cf. withGitAuth) porte l'auth : JAMAIS dans l'URL.
* `--` sépare l'URL/dest des options. L'appelant valide `dest` (sous scanRoots, non existant).
*/
export function cloneRepo(opts: {

2
packages/server/src/core/group-manager.ts
View File

@@ -1,5 +1,5 @@
// Gestion des groupes de travail (P5) : un groupe = collection nommée de repos (many-to-many).
// Membership légère et persistée ; les worktrees/sessions du groupe ne sont PAS stockés ici —
// Membership légère et persistée ; les worktrees/sessions du groupe ne sont PAS stockés ici :
// ils restent servis par WorktreeManager/PtyManager et filtrés côté client par repoId.
// Tout est synchrone : aucune I/O git/fs, node:sqlite est synchrone.
import { EventEmitter } from 'node:events';

2
packages/server/src/core/group-session.ts
View File

@@ -2,7 +2,7 @@ import { parse, resolve, sep } from 'node:path';
/**
* Plus long ancêtre commun d'un ensemble de chemins absolus (par segments, jamais par préfixe
* de chaîne — `/a/bc` n'est PAS un ancêtre de `/a/bcd`). Pour un seul chemin, renvoie ce chemin.
* de chaîne : `/a/bc` n'est PAS un ancêtre de `/a/bcd`). Pour un seul chemin, renvoie ce chemin.
*/
export function commonAncestorDir(paths: string[]): string {
const first = paths[0];

4
packages/server/src/core/jsonl-discovery.ts
View File

@@ -10,7 +10,7 @@ const HEAD_BYTES = 256 * 1024;
const TAIL_BYTES = 64 * 1024;
const TITLE_MAX = 120;
/** Reproduit le nom de dossier ~/.claude/projects à partir d'un cwd (validé 100 % — spike S4). */
/** Reproduit le nom de dossier ~/.claude/projects à partir d'un cwd (validé 100 %, spike S4). */
export function munge(cwd: string): string {
return cwd.replace(/[^A-Za-z0-9]/g, '-');
}
@@ -82,7 +82,7 @@ function extractMeta(objs: Array<Record<string, unknown>>, meta: Meta): void {
setOnce('cwd', o.cwd);
setOnce('gitBranch', o.gitBranch);
setOnce('version', o.version);
// Titre : on retient la dernière valeur vue (la plus récente) — head puis tail → la queue gagne.
// Titre : on retient la dernière valeur vue (la plus récente) : head puis tail → la queue gagne.
const ai = asString(o.aiTitle);
if (ai) meta.aiTitle = ai;
const sum = asString(o.summary);

4
packages/server/src/core/project.ts
View File

@@ -1,11 +1,11 @@
// Création d'un nouveau projet : un dossier `<root>/<name>` créé sous une racine existante, dans
// lequel on lance ensuite une session. Couche PURE (testable sans fs) — la création réelle du
// lequel on lance ensuite une session. Couche PURE (testable sans fs) : la création réelle du
// dossier, le `git init` et le spawn vivent dans `routes/projects.ts`.
import { join } from 'node:path';
import { isSafeAbsolutePath } from './git.js';
/**
* Valide un nom de projet : UN SEUL segment de dossier. Anti-traversal de base — refuse les noms
* Valide un nom de projet : UN SEUL segment de dossier. Anti-traversal de base : refuse les noms
* vides, trop longs, `.`/`..`, et tout caractère de séparation (`/`, `\`) ou NUL. La résolution du
* chemin complet (et sa re-validation) est faite par {@link resolveProjectDir}.
*/

16
packages/server/src/core/pty-manager.ts
View File

@@ -129,7 +129,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
throw Object.assign(new Error(`Not a directory: ${dir}`), { statusCode: 400 });
}
}
// Un resume/fork est toujours une session claude (le cwd d'origine est garanti par l'appelant — S1).
// Un resume/fork est toujours une session claude (le cwd d'origine est garanti par l'appelant, S1).
const command = opts.resume ? 'claude' : (opts.command ?? 'claude');
// Override de chemin du binaire claude (réglage UI) lu à chaque spawn → effet sans redémarrage.
const claudeBinPath = command === 'claude' ? readClaudeBinPath(this.db) : null;
@@ -197,7 +197,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
return summary;
}
/** Résout le claudeSessionId du CLI en pollant le registre par pid, puis le persiste (waitReady — S1). */
/** Résout le claudeSessionId du CLI en pollant le registre par pid, puis le persiste (waitReady, S1). */
private captureClaudeSessionId(s: ManagedSession): void {
const deadline = Date.now() + CLAUDE_ID_TIMEOUT_MS;
const tick = (): void => {
@@ -307,7 +307,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
}
/**
* Ré-émet un `session_update` pour une session historique (P10) — utilisé au dés-archivage pour
* Ré-émet un `session_update` pour une session historique (P10) : utilisé au dés-archivage pour
* que tous les clients rafraîchissent le row (le champ `archived` repasse à false). No-op si la
* session est vivante (déjà couverte par le flux live) ou inconnue.
*/
@@ -345,7 +345,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
return true;
}
/** Arrêt du daemon : SIGTERM à toutes les sessions (le CLI nettoie son registre sur SIGTERM — spike S1). */
/** Arrêt du daemon : SIGTERM à toutes les sessions (le CLI nettoie son registre sur SIGTERM, spike S1). */
shutdown(): void {
for (const id of this.live.keys()) this.kill(id);
}
@@ -396,7 +396,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
/**
* Répond à un dialogue Claude sans clavier (P4-A) : traduit une intention de haut
* niveau en keystrokes PTY, validée contre l'état fin du tracker (P3-B).
* - 'select' N : positionne le curseur sur l'option N puis confirme (`"N\r"`) — protocole acté spike S3.
* - 'select' N : positionne le curseur sur l'option N puis confirme (`"N\r"`) : protocole acté spike S3.
* - 'confirm' : valide l'option pré-sélectionnée (`"\r"`).
* - 'deny' : refus universel (Esc).
* Réutilise le chemin write (mono-utilisateur : tout interactif peut répondre, observers non).
@@ -417,7 +417,7 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
s.proc.write(`${optionN}\r`);
return 'ok';
}
// confirm/deny n'exigent qu'un état d'attente (le dialogue Trust précède le registre — S1).
// confirm/deny n'exigent qu'un état d'attente (le dialogue Trust précède le registre, S1).
if (act?.activity !== 'waiting') return 'invalid';
s.proc.write(action === 'deny' ? '\x1b' : '\r');
return 'ok';
@@ -446,10 +446,10 @@ export class PtyManager extends EventEmitter<PtyManagerEvents> {
// ---- interne ----
/**
* Push P4-B : notifie sur le FRONT MONTANT vers un état qui requiert l'attention — `waiting`
* Push P4-B : notifie sur le FRONT MONTANT vers un état qui requiert l'attention : `waiting`
* (un dialogue bloque) ou `idle` atteint depuis `busy` (Claude a terminé sa réponse, la session
* redevient disponible). Le tracker réémet souvent le même état → on ne réagit qu'au changement.
* Debounce annulable : un état ultra-bref (Claude repart tout seul) ne déclenche pas de notif —
* Debounce annulable : un état ultra-bref (Claude repart tout seul) ne déclenche pas de notif :
* à l'échéance on revérifie l'état réel. Cible tous les abonnements (un seul utilisateur).
*/
private maybeNotify(s: ManagedSession, next: SessionActivity | null): void {

6
packages/server/src/core/push-service.ts
View File

@@ -8,7 +8,7 @@ import type { SecretBox } from './secret-box.js';
import { recordAudit } from './audit-log.js';
// web-push est publié en CommonJS : on le charge via require (verbatimModuleSyntax + NodeNext),
// typé par l'import type — même pattern que @xterm/headless dans screen-reader.ts.
// typé par l'import type, même pattern que @xterm/headless dans screen-reader.ts.
const require = createRequire(import.meta.url);
const webpush = require('web-push') as typeof import('web-push');
@@ -33,7 +33,7 @@ interface SubRow {
auth: string;
}
/** Envoi d'une notif à un abonnement — injectable pour les tests ; défaut = web-push réel. */
/** Envoi d'une notif à un abonnement : injectable pour les tests ; défaut = web-push réel. */
export type PushSender = (
subscription: { endpoint: string; keys: { p256dh: string; auth: string } },
payload: string,
@@ -70,7 +70,7 @@ export class PushService {
this.vapidPrivate = priv;
}
/** Clé publique VAPID — sûre à exposer (applicationServerKey côté navigateur). */
/** Clé publique VAPID : sûre à exposer (applicationServerKey côté navigateur). */
publicKey(): string {
return this.vapidPublic;
}

2
packages/server/src/core/repo-discovery.ts
View File

@@ -1,5 +1,5 @@
// Planificateur de la découverte auto des repos : scan au démarrage + re-scan périodique.
// Calqué sur DiscoveryService (sessions) — start()/stop() avec timer .unref(). Démarré depuis
// Calqué sur DiscoveryService (sessions) : start()/stop() avec timer .unref(). Démarré depuis
// runDaemon() UNIQUEMENT (jamais buildApp), ce qui isole naturellement les tests vitest du scan.
// Lui-même sans état : il lit les racines/l'intervalle dans `settings` et délègue à WorktreeManager.
import type { Db } from '../db/index.js';

4
packages/server/src/core/repo-scanner.ts
View File

@@ -1,5 +1,5 @@
// Découverte auto des dépôts git : marche bornée du système de fichiers à la recherche de `.git`.
// Fonction PURE et tolérante (ne lève jamais) — testable isolément comme parseWorktreePorcelain.
// Fonction PURE et tolérante (ne lève jamais) : testable isolément comme parseWorktreePorcelain.
// N'appelle JAMAIS git (détection par présence de `.git`) : la validation réelle (isRepo) et la
// résolution de default_branch se font paresseusement à l'enregistrement, pas par dépôt scanné.
import { readdir } from 'node:fs/promises';
@@ -39,7 +39,7 @@ interface Frame {
* - un dossier contenant `.git` (fichier OU dossier → couvre les worktrees liés) est un repo :
* on l'enregistre ; en profondeur on NE descend PAS dedans (sous-modules/worktrees imbriqués
* ignorés). EXCEPTION : une racine fournie (depth 0) qui est elle-même un repo est aussi un
* conteneur — on l'enregistre ET on continue de descendre pour trouver les repos internes ;
* conteneur : on l'enregistre ET on continue de descendre pour trouver les repos internes ;
* - on n'empile que les vrais sous-dossiers (`d.isDirectory()`), donc les symlinks ne sont PAS
* suivis (anti-cycle + anti-sortie de racine), et on saute dotdirs + excludeDirs ;
* - bornes : `maxDepth`, `maxRepos`, et un éventuel `signal` (timeout global) ;

2
packages/server/src/core/scan-settings.ts
View File

@@ -50,7 +50,7 @@ export function normalizeScanRoots(raw: unknown): string[] | null {
return out;
}
/** Valide un intervalle (entier 0–MAX_SCAN_INTERVAL_MIN). Retourne null si invalide. */
/** Valide un intervalle (entier 0-MAX_SCAN_INTERVAL_MIN). Retourne null si invalide. */
export function normalizeScanIntervalMin(raw: unknown): number | null {
if (typeof raw !== 'number' || !Number.isInteger(raw)) return null;
if (raw < 0 || raw > MAX_SCAN_INTERVAL_MIN) return null;

2
packages/server/src/core/screen-reader.ts
View File

@@ -1,6 +1,6 @@
// Reconstruction d'écran via @xterm/headless : terminal headless PERSISTANT par session, alimenté
// incrémentalement par le flux PTY. Remplace le strip ANSI naïf (qui « mange les espaces » et casse
// la détection des dialogues — verdict S1/S3). Aucune dépendance DOM (usage Node).
// la détection des dialogues, verdict S1/S3). Aucune dépendance DOM (usage Node).
import { createRequire } from 'node:module';
import type { Terminal as XtermTerminal } from '@xterm/headless';

2
packages/server/src/core/session-archive.ts
View File

@@ -68,7 +68,7 @@ export class SessionArchiveService extends EventEmitter<SessionArchiveEvents> {
}
}
/** Diffuse l'archivage d'une session (déjà archivée + auditée par l'appelant — ex. route manuelle). */
/** Diffuse l'archivage d'une session (déjà archivée + auditée par l'appelant, ex. route manuelle). */
emitArchived(id: string, archivedAt: string): void {
this.emit('session_archived', { id, archivedAt });
}

34
packages/server/src/core/worktree-manager.ts
View File

@@ -78,7 +78,7 @@ export interface WorktreeManagerEvents {
repo_removed: [string];
worktree_update: [{ repoId: string; worktree: WorktreeSummary }];
worktree_removed: [{ repoId: string; path: string }];
/** P7 — le détail (liste des changements/diff) d'un worktree regardé a changé ; relayé en push
/** P7 : le détail (liste des changements/diff) d'un worktree regardé a changé ; relayé en push
* ciblé `worktree_changes` aux seules connexions ayant `watch`é cette clé. */
worktree_changes: [{ repoId: string; path: string }];
}
@@ -136,7 +136,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
private readonly fsWatcher?: FsWatcherService,
) {
super();
// P7 — un changement FS sur un worktree regardé invalide le cache, rediffuse le status frais
// P7 : un changement FS sur un worktree regardé invalide le cache, rediffuse le status frais
// (worktree_update : compteurs légers pour tout le dashboard) et signale aux clients qui le
// regardent de re-fetcher le détail (worktree_changes ciblé). On résout repoId → row à la volée.
this.fsWatcher?.on('worktree_fs_change', ({ repoId, path }) => {
@@ -207,7 +207,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
}
/**
* P11 — arme un watcher PERMANENT sur le checkout principal de chaque repo visible : un
* P11 : arme un watcher PERMANENT sur le checkout principal de chaque repo visible : un
* `git checkout`/`switch` en CLI sur le principal est ainsi rediffusé en temps réel sans qu'un
* client ne l'ait « regardé ». Appelé depuis runDaemon (jamais buildApp → pas d'effet en tests purs).
*/
@@ -252,7 +252,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
/**
* Découvre les repos git sous `roots` et auto-enregistre les NOUVEAUX (path absent de la DB).
* Idempotent et anti-résurrection : un path déjà présent — visible OU masqué — n'est jamais
* Idempotent et anti-résurrection : un path déjà présent (visible OU masqué) n'est jamais
* réécrit (INSERT ... ON CONFLICT DO NOTHING). Les scans concurrents sont coalescés. Tolérant :
* ne lève pas (le scanner avale les erreurs FS). N'appelle aucun git pendant le scan
* (default_branch=NULL, résolu paresseusement par rowToSummary à l'affichage).
@@ -302,7 +302,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
/**
* Sessions (managées + découvertes) dont le cwd correspond à ce chemin de worktree.
* Les sessions explicitement masquées (`hidden`) sont exclues — cohérent avec `/api/v1/sessions`
* Les sessions explicitement masquées (`hidden`) sont exclues, cohérent avec `/api/v1/sessions`
* (sans quoi le masquage était ignoré dans les fiches worktree). Le tri managées/externes est laissé
* au client (interrupteur « afficher les externes »), qui dispose du champ `source`. La garde de
* suppression réclame en revanche TOUTES les sessions vivantes (`includeHidden`) pour rester sûre.
@@ -351,7 +351,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
// quand l'utilisateur active « afficher les masqués ».
const rows = this.db.prepare('SELECT id FROM repos WHERE hidden = 0 ORDER BY created_at ASC').all() as Array<{ id: string }>;
// Tolérance par repo : avec la découverte auto, un repo douteux (git en échec, chemin disparu,
// permission) ne doit JAMAIS faire planter tout l'endpoint — il ne contribue alors aucun worktree.
// permission) ne doit JAMAIS faire planter tout l'endpoint, il ne contribue alors aucun worktree.
const lists = await Promise.all(rows.map((r) => this.listRepoWorktrees(r.id).catch(() => [])));
return lists.flat();
}
@@ -420,7 +420,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
});
}
/** Branches locales/remote + branche par défaut d'un repo — alimente le sélecteur de base côté UI. */
/** Branches locales/remote + branche par défaut d'un repo : alimente le sélecteur de base côté UI. */
async listRepoBranches(repoId: string): Promise<{ local: string[]; remote: string[]; default: string | null }> {
const row = this.getRepoRow(repoId);
if (!row) throw httpError(404, 'NOT_FOUND', 'No repo with this id');
@@ -444,16 +444,16 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
const mode = opts.mode ?? 'all';
return this.withLock(repoId, async () => {
if (opts.amend && !(await isUnpushed(w.path))) {
throw httpError(409, 'ALREADY_PUSHED', 'Last commit is already pushed — amend would rewrite shared history');
throw httpError(409, 'ALREADY_PUSHED', 'Last commit is already pushed: amend would rewrite shared history');
}
const st = await worktreeStatus(w.path);
// Garde-fou « rien à committer » (sauf amend, qui peut ne changer que le message).
if (!opts.amend) {
if (mode === 'all' && st.dirtyCount === 0) {
throw httpError(409, 'NOTHING_TO_COMMIT', 'Nothing to commit — working tree is clean');
throw httpError(409, 'NOTHING_TO_COMMIT', 'Nothing to commit: working tree is clean');
}
if (mode === 'staged' && (st.stagedCount ?? 0) === 0) {
throw httpError(409, 'NOTHING_STAGED', 'Nothing staged — stage files first');
throw httpError(409, 'NOTHING_STAGED', 'Nothing staged: stage files first');
}
}
try {
@@ -646,17 +646,17 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
return this.withLock(repoId, async () => {
if (!force) {
if ((await worktreeStatus(w.path)).dirtyCount > 0) {
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes — commit or pass force');
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes: commit or pass force');
}
if ((await worktreeStatus(row.path)).dirtyCount > 0) {
throw httpError(409, 'DIRTY_TREE', 'Main checkout has uncommitted changes — commit/stash or pass force');
throw httpError(409, 'DIRTY_TREE', 'Main checkout has uncommitted changes: commit/stash or pass force');
}
}
try {
await removeWorktree(row.path, w.path, force);
} catch (err) {
if (!force && isDirtyWorktreeError(err)) {
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes — pass force to promote anyway');
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes: pass force to promote anyway');
}
throw httpError(500, 'WORKTREE_REMOVE_FAILED', (err as Error).message);
}
@@ -672,7 +672,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
}
/**
* Lance UNE session dans le checkout principal du repo (`repo.path`) — pour « bosser sur la branche
* Lance UNE session dans le checkout principal du repo (`repo.path`) : pour « bosser sur la branche
* principale » sans créer de worktree. Si `branch` est fourni, crée/bascule d'abord cette branche
* dans ce checkout (`git switch[-c]`), refusé si l'arbre est sale (on n'écrase pas un HEAD modifié).
* Volontairement SANS hooks ni pré-trust (contraste avec createWorktree) : le checkout principal
@@ -691,7 +691,7 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
if (branch !== undefined) {
// garde-fou : ne pas basculer le HEAD du checkout principal s'il a des changements non sauvegardés.
if ((await worktreeStatus(row.path)).dirtyCount > 0) {
throw httpError(409, 'DIRTY_TREE', 'Main checkout has uncommitted changes — commit or stash before switching branch');
throw httpError(409, 'DIRTY_TREE', 'Main checkout has uncommitted changes: commit or stash before switching branch');
}
try {
await switchBranch(row.path, { branch, create: req.newBranch ?? true });
@@ -731,14 +731,14 @@ export class WorktreeManager extends EventEmitter<WorktreeManagerEvents> {
if (resolve(w.path) === resolve(row.path)) throw httpError(400, 'IS_MAIN_WORKTREE', 'Cannot remove the main worktree');
// garde-fou : une session vivante tourne dans ce worktree → exiger une confirmation explicite.
if (!force && this.sessionsForCwd(w.path, { includeHidden: true }).some((s) => s.live)) {
throw httpError(409, 'SESSION_LIVE_IN_WORKTREE', 'A live session runs in this worktree — pass force to delete anyway');
throw httpError(409, 'SESSION_LIVE_IN_WORKTREE', 'A live session runs in this worktree: pass force to delete anyway');
}
return this.withLock(repoId, async () => {
try {
await removeWorktree(row.path, w.path, force);
} catch (err) {
if (!force && isDirtyWorktreeError(err)) {
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes — pass force to delete anyway');
throw httpError(409, 'WORKTREE_DIRTY', 'Worktree has uncommitted changes: pass force to delete anyway');
}
throw httpError(500, 'WORKTREE_REMOVE_FAILED', (err as Error).message);
}

22
packages/server/src/db/index.ts
View File

@@ -29,7 +29,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P2 — découverte & reprise : corrélation avec les sessions Claude sur disque.
// P2 : découverte & reprise : corrélation avec les sessions Claude sur disque.
id: 2,
sql: `
ALTER TABLE sessions ADD COLUMN claude_session_id TEXT;
@@ -38,7 +38,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P3 — repos enregistrés. Les worktrees sont dérivés à la volée de git (non persistés).
// P3 : repos enregistrés. Les worktrees sont dérivés à la volée de git (non persistés).
id: 3,
sql: `
CREATE TABLE repos (
@@ -53,7 +53,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P4 — abonnements Web Push. Liés au token d'auth (token_id) ; clés VAPID en settings.
// P4 : abonnements Web Push. Liés au token d'auth (token_id) ; clés VAPID en settings.
id: 4,
sql: `
CREATE TABLE push_subscriptions (
@@ -70,7 +70,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P5 — groupes de travail. Un groupe = collection de repos (many-to-many).
// P5 : groupes de travail. Un groupe = collection de repos (many-to-many).
// Worktrees/sessions NON persistés ici : servis par WorktreeManager/PtyManager
// et filtrés côté client par repoId. CASCADE s'appuie sur PRAGMA foreign_keys = ON (cf. openDb).
id: 5,
@@ -103,7 +103,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
{
// Journal d'audit (conformité entreprise : GDPR/SOX/ISO 27001). Trace les mutations
// sensibles (tokens, réglages, secrets, abonnements push, groupes). Ne contient JAMAIS
// de secret en clair — `details` est un JSON de métadonnées non sensibles.
// de secret en clair, `details` est un JSON de métadonnées non sensibles.
id: 7,
sql: `
CREATE TABLE audit_logs (
@@ -119,7 +119,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P6 — session de groupe multi-repo. Une session peut couvrir plusieurs répertoires (--add-dir)
// P6 : session de groupe multi-repo. Une session peut couvrir plusieurs répertoires (--add-dir)
// et appartenir à un groupe. `added_dirs` : JSON array de chemins absolus (NULL si mono-repo).
// `group_id` : pas de FK (ALTER ADD COLUMN sqlite n'en pose pas) ; nettoyé à la suppression du groupe.
id: 8,
@@ -143,7 +143,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P10 — archivage automatique des sessions terminées (rétention configurable, défaut 30 j).
// P10 : archivage automatique des sessions terminées (rétention configurable, défaut 30 j).
// `archived_at` NULL = active. Soft-archive : JAMAIS de DELETE (resume/fork restent intacts).
// Sémantique distincte de hidden_sessions (#9) : `hidden` est manuel et indexé par
// claude_session_id ; `archived` est automatique par ancienneté, indexé par `id`, et ne
@@ -155,7 +155,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P12 — connexions aux services git distants (Gitea/GitLab/GitHub). Les SECRETS (PAT, app
// P12 : connexions aux services git distants (Gitea/GitLab/GitHub). Les SECRETS (PAT, app
// password, tokens OAuth) sont chiffrés par SecretBox AVANT insertion (colonnes *_encrypted) :
// la base ne contient jamais de secret en clair. `ssh_key_path`/`oauth_*` sont posés dès
// maintenant (schéma stable) mais exploités en P12b/P12c. `test_result` = dernier diagnostic.
@@ -181,7 +181,7 @@ const MIGRATIONS: Array<{ id: number; sql: string }> = [
`,
},
{
// P12 — un repo enregistré peut provenir d'un clone : on retient sa source (remote_url),
// P12 : un repo enregistré peut provenir d'un clone : on retient sa source (remote_url),
// le service détecté et le credential utilisé. PAS de FK sur credential_id (cohérent avec
// sessions.group_id #8) : la suppression d'un credential nullifie ce champ côté manager.
id: 12,
@@ -205,7 +205,7 @@ export function openDb(path: string): Db {
}
/**
* Restreint la base (et ses fichiers WAL/SHM) à 0o600 — proprio uniquement. La base contient des
* Restreint la base (et ses fichiers WAL/SHM) à 0o600, proprio uniquement. La base contient des
* secrets (server_secret, clé privée VAPID, hashs de tokens) : elle ne doit jamais être lisible par
* d'autres utilisateurs du système. Best-effort : ignoré sur les FS sans permissions POSIX.
*/
@@ -268,7 +268,7 @@ export function unhideSession(db: Db, claudeSessionId: string): void {
db.prepare('DELETE FROM hidden_sessions WHERE claude_session_id = ?').run(claudeSessionId);
}
// ---- Archivage des sessions terminées (par id, soft-archive — P10) ----
// ---- Archivage des sessions terminées (par id, soft-archive, P10) ----
/** Archive une session managée (idempotent : ne touche pas une session déjà archivée). */
export function archiveSession(db: Db, id: string, archivedAt: string): void {

4
packages/server/src/index.ts
View File

@@ -40,7 +40,7 @@ export async function runDaemon(config: Config): Promise<void> {
if (config.autoDiscover) repoDiscovery.start(); // découverte auto des repos : scan au boot + re-scan périodique
const url = `http://${config.bind === '0.0.0.0' ? '127.0.0.1' : config.bind}:${config.port}`;
app.log.info(`Arboretum v${pkg.version} — ${url}`);
app.log.info(`Arboretum v${pkg.version} : ${url}`);
if (bootstrapToken) {
// Affiché une seule fois : le hash seul est stocké.
printTokenBanner(bootstrapToken, url);
@@ -52,7 +52,7 @@ export async function runDaemon(config: Config): Promise<void> {
const shutdown = (signal: string): void => {
if (shuttingDown) return;
shuttingDown = true;
app.log.info(`${signal} received — draining sessions then exiting`);
app.log.info(`${signal} received: draining sessions then exiting`);
discovery.stop();
sessionArchive.stop();
repoDiscovery.stop();

2
packages/server/src/routes/auth.ts
View File

@@ -80,7 +80,7 @@ export function registerAuthRoutes(
const body = req.body as Partial<CreateTokenRequest> | null;
const label = typeof body?.label === 'string' ? body.label.trim() : '';
if (label.length < 1 || label.length > 64) {
return reply.status(400).send({ error: { code: 'BAD_REQUEST', message: 'label must be 1–64 characters' } });
return reply.status(400).send({ error: { code: 'BAD_REQUEST', message: 'label must be 1-64 characters' } });
}
const { id, token } = auth.createTokenRecord(label);
recordAudit(db, { actor: req.authContext?.tokenId ?? 'unknown', action: 'token.create', resourceId: id, details: { label } });

2
packages/server/src/routes/groups.ts
View File

@@ -101,7 +101,7 @@ export function registerGroupRoutes(
});
// Session de groupe (P6) : UNE session Claude couvrant tous les repos du groupe (--add-dir).
// Les répertoires sont résolus côté serveur depuis les propres worktrees du groupe — le client
// Les répertoires sont résolus côté serveur depuis les propres worktrees du groupe : le client
// ne passe jamais de chemin brut. `branch` présent → worktree de cette branche par repo ;
// absent → le worktree principal de chaque repo.
app.post('/api/v1/groups/:id/session', async (req, reply) => {

4
packages/server/src/routes/sessions.ts
View File

@@ -63,7 +63,7 @@ export function registerSessionRoutes(
const claudeSessionId = managed ? managed.claudeSessionId : id;
// Garde-fou anti-corruption : jamais de resume direct d'une session vivante (vérif FRAÎCHE).
if (discovery.isClaudeSessionLive(claudeSessionId) || manager.findLiveByClaudeSessionId(claudeSessionId)) {
return reply.status(409).send({ error: { code: 'SESSION_LIVE', message: 'Session is live — fork it instead' } });
return reply.status(409).send({ error: { code: 'SESSION_LIVE', message: 'Session is live, fork it instead' } });
}
try {
// Session de groupe (P6) : re-relie les mêmes répertoires (--add-dir) et son groupe au resume.
@@ -104,7 +104,7 @@ export function registerSessionRoutes(
});
// Masque une session découverte (ou managée morte) : exclue de la liste sauf ?includeHidden=true.
// Reste reprenable/forkable — c'est un filtre d'affichage, pas une suppression.
// Reste reprenable/forkable : c'est un filtre d'affichage, pas une suppression.
app.post('/api/v1/sessions/:id/hide', async (req, reply) => {
const { id } = req.params as { id: string };
const sid = resolveClaudeSid(id);

4
packages/server/src/routes/settings.ts
View File

@@ -1,6 +1,6 @@
// Réglages exposés à l'UI (onglet Réglages). Frontière de sécurité CENTRALE : la table `settings`
// contient aussi des SECRETS (server_secret, vapid_private). Ces routes n'exposent QUE des champs
// non sensibles et n'écrivent QUE des clés explicitement allow-listées — jamais les secrets.
// non sensibles et n'écrivent QUE des clés explicitement allow-listées : jamais les secrets.
import type { FastifyInstance } from 'fastify';
import type { ServerInfo, SettingsResponse, UpdateSettingsRequest } from '@arboretum/shared';
import type { Config } from '../config.js';
@@ -119,7 +119,7 @@ export function registerSettingsRoutes(
details: { keys: Object.keys(body) },
});
const snap = snapshot();
// P11 — diffuse le nouvel état non sensible à tous les clients abonnés au topic 'settings'.
// P11 · diffuse le nouvel état non sensible à tous les clients abonnés au topic 'settings'.
settingsBus.emit('settings_update', snap.settings);
return reply.send(snap);
});

2
packages/server/src/routes/worktrees.ts
View File

@@ -60,7 +60,7 @@ export function registerWorktreeRoutes(app: FastifyInstance, wt: WorktreeManager
}
});
// Branches du repo (locales + suivies de origin + défaut) — alimente le sélecteur de base côté UI.
// Branches du repo (locales + suivies de origin + défaut) : alimente le sélecteur de base côté UI.
app.get('/api/v1/repos/:id/branches', async (req, reply) => {
const { id } = req.params as { id: string };
try {

8
packages/server/src/ws/gateway.ts
View File

@@ -67,7 +67,7 @@ export function registerWsGateway(
const onSessionExit = (e: { sessionId: string; exitCode: number | null; signal: number | null }): void => {
if (subscribedSessions) send({ type: 'session_exit', ...e });
};
// P10 — une session managée vient d'être archivée (auto par ancienneté ou manuellement).
// P10 · une session managée vient d'être archivée (auto par ancienneté ou manuellement).
const onSessionArchived = (e: { id: string; archivedAt: string }): void => {
if (subscribedSessions) send({ type: 'session_archived', sessionId: e.id });
};
@@ -93,15 +93,15 @@ export function registerWsGateway(
const onGroupRemoved = (groupId: string): void => {
if (subscribedGroups) send({ type: 'group_removed', groupId });
};
// P11 — un réglage a changé : relayé aux connexions abonnées au topic 'settings'.
// P11 · un réglage a changé : relayé aux connexions abonnées au topic 'settings'.
const onSettingsUpdate = (settings: SettingsBroadcast): void => {
if (subscribedSettings) send({ type: 'settings_update', settings });
};
// P12 — progression d'un clone : relayée aux abonnés du topic 'clones'.
// P12 · progression d'un clone : relayée aux abonnés du topic 'clones'.
const onCloneUpdate = (operation: CloneOperation): void => {
if (subscribedClones) send({ type: 'clone_update', operation });
};
// P7 — détail d'un worktree modifié : poussé UNIQUEMENT si cette connexion le regarde.
// P7 · détail d'un worktree modifié : poussé UNIQUEMENT si cette connexion le regarde.
const onWorktreeChanges = (e: { repoId: string; path: string }): void => {
if (watched.has(watchKey(e.repoId, e.path))) send({ type: 'worktree_changes', ...e });
};

8
packages/server/test/app.e2e.test.ts
View File

@@ -77,7 +77,7 @@ afterAll(async () => {
rmSync(dir, { recursive: true, force: true });
});
describe('app e2e — auth, origin et sessions', () => {
describe('app e2e · auth, origin et sessions', () => {
let t: TestApp;
let cookieValue: string;
@@ -277,7 +277,7 @@ describe('app e2e — auth, origin et sessions', () => {
});
});
describe('app e2e — rate limit du login', () => {
describe('app e2e · rate limit du login', () => {
it('mauvais token et bodies invalides → 401, puis 429 dès le 4e essai (backoff après 3 échecs consécutifs)', async () => {
const t = makeApp('ratelimit-failures');
const bad = await t.bundle.app.inject({ method: 'POST', url: '/api/v1/auth/login', payload: { token: 'arb_badbadbadbad' } });
@@ -309,7 +309,7 @@ describe('app e2e — rate limit du login', () => {
});
});
describe('app e2e — découverte, resume & fork (P2)', () => {
describe('app e2e · découverte, resume & fork (P2)', () => {
let t: TestApp;
let projectsDir: string;
let sessionsDir: string;
@@ -370,7 +370,7 @@ describe('app e2e — découverte, resume & fork (P2)', () => {
});
});
describe('app e2e — découverte auto des repos & masquage', () => {
describe('app e2e · découverte auto des repos & masquage', () => {
let t: TestApp;
let scanRoot: string;
const bearer = (): Record<string, string> => ({ authorization: `Bearer ${t.token}` });

2
packages/server/test/audit-data-routes.test.ts
View File

@@ -1,4 +1,4 @@
// Lot 5 — sécurité enterprise : en-têtes de sécurité, journal d'audit, RGPD (export/suppression),
// Lot 5 · sécurité enterprise : en-têtes de sécurité, journal d'audit, RGPD (export/suppression),
// garde Content-Type. Vérifie le câblage de bout en bout via buildApp + token bootstrap.
import { mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';

4
packages/server/test/claude-launcher.test.ts
View File

@@ -4,7 +4,7 @@ import { buildSpawnSpec, diagnoseClaudeBin, resolveClaudeBin } from '../src/core
// resolveClaudeBin() fait `which claude` : on le stub pour ne pas dépendre d'un claude réel en PATH.
vi.mock('node:child_process', () => ({ execFileSync: () => '/usr/bin/claude\n' }));
describe('buildSpawnSpec — session de groupe multi-repo (P6)', () => {
describe('buildSpawnSpec · session de groupe multi-repo (P6)', () => {
it('émet un --add-dir par répertoire supplémentaire (claude)', () => {
const spec = buildSpawnSpec({ command: 'claude', addDirs: ['/a', '/b', '/c'] });
expect(spec.file).toBe('/usr/bin/claude');
@@ -28,7 +28,7 @@ describe('buildSpawnSpec — session de groupe multi-repo (P6)', () => {
});
});
describe('resolveClaudeBin / diagnoseClaudeBin — override de chemin (réglage UI)', () => {
describe('resolveClaudeBin / diagnoseClaudeBin · override de chemin (réglage UI)', () => {
// process.execPath (node) est un fichier exécutable réel garanti sur la machine de test.
const realBin = process.execPath;

16
packages/server/test/cli-install.test.ts
View File

@@ -14,7 +14,7 @@ import {
launchAgentPlistPath,
} from '../src/cli/install.js';
describe('cli install — detectPlatform', () => {
describe('cli install · detectPlatform', () => {
it('accepte linux et darwin', () => {
expect(detectPlatform('linux')).toBe('linux');
expect(detectPlatform('darwin')).toBe('darwin');
@@ -26,7 +26,7 @@ describe('cli install — detectPlatform', () => {
});
});
describe('cli install — buildServiceArgs', () => {
describe('cli install · buildServiceArgs', () => {
it('aucun flag → aucun argument (le service garde les défauts loopback)', () => {
expect(buildServiceArgs(parseInstallArgs([]))).toEqual([]);
});
@@ -47,7 +47,7 @@ describe('cli install — buildServiceArgs', () => {
});
});
describe('cli install — resolveBin', () => {
describe('cli install · resolveBin', () => {
it('par défaut : node (process.execPath) + dist/index.js', () => {
const { exec, args } = resolveBin({});
expect(exec).toBe(process.execPath);
@@ -64,7 +64,7 @@ describe('cli install — resolveBin', () => {
});
});
describe('cli install — renderSystemdUnit', () => {
describe('cli install · renderSystemdUnit', () => {
it('contient le ExecStart calculé et les directives clés', () => {
const unit = renderSystemdUnit({ exec: '/usr/bin/node', scriptArgs: ['/opt/arboretum/index.js', '--port', '7317'] });
expect(unit).toContain('ExecStart=/usr/bin/node /opt/arboretum/index.js --port 7317');
@@ -101,7 +101,7 @@ describe('cli install — renderSystemdUnit', () => {
});
expect(unit).toMatchInlineSnapshot(`
"[Unit]
Description=Arboretum — git worktree & Claude Code dashboard
Description=Arboretum · git worktree & Claude Code dashboard
After=network-online.target
Wants=network-online.target
@@ -120,7 +120,7 @@ describe('cli install — renderSystemdUnit', () => {
});
});
describe('cli install — renderLaunchAgentPlist', () => {
describe('cli install · renderLaunchAgentPlist', () => {
const base = {
label: 'fr.lidge.arboretum',
programArguments: ['/usr/bin/node', '/opt/index.js', '--port', '7317'],
@@ -163,13 +163,13 @@ describe('cli install — renderLaunchAgentPlist', () => {
});
});
describe('cli install — xmlEscape', () => {
describe('cli install · xmlEscape', () => {
it('échappe &, < et >', () => {
expect(xmlEscape('a & b < c > d')).toBe('a &amp; b &lt; c &gt; d');
});
});
describe('cli install — chemins', () => {
describe('cli install · chemins', () => {
const savedXdg = process.env.XDG_CONFIG_HOME;
afterEach(() => {
if (savedXdg === undefined) delete process.env.XDG_CONFIG_HOME;

8
packages/server/test/dialog-detection.test.ts
View File

@@ -24,7 +24,7 @@ async function replay(fixture: string): Promise<Array<{ dialog: ClassifiedDialog
return seen;
}
describe('ScreenReader (@xterm/headless) — anti strip-ANSI naïf', () => {
describe('ScreenReader (@xterm/headless) · anti strip-ANSI naïf', () => {
it('préserve les espaces du dialogue (« Do you want to create », pas « Doyouwant »)', async () => {
const seen = await replay('perm-write2.raw');
expect(seen.length).toBeGreaterThan(0);
@@ -32,7 +32,7 @@ describe('ScreenReader (@xterm/headless) — anti strip-ANSI naïf', () => {
});
});
describe('classifyDialog — unitaire (lignes synthétiques)', () => {
describe('classifyDialog · unitaire (lignes synthétiques)', () => {
it('trust', () => {
const d = classifyDialog(['Do you trust the files in this folder?', '❯ 1. Yes, I trust this folder', '2. No, exit']);
expect(d?.kind).toBe('trust');
@@ -81,7 +81,7 @@ describe('détection sur fixtures réelles S3 (replay headless)', () => {
// Campagne de fiabilité P4-C : chaque type de dialogue ciblé par la supervision mobile doit être
// classifié de façon fiable (cf. « reste à faire P4 » du verdict S3 : couvrir le refus Esc et le plan).
describe('campagne de fiabilité P4-C — tous les types de dialogue', () => {
describe('campagne de fiabilité P4-C · tous les types de dialogue', () => {
const realCaptures: Array<{ fixture: string; kind: DialogKind }> = [
{ fixture: 'trust.raw', kind: 'trust' },
{ fixture: 'perm-write2.raw', kind: 'permission' },
@@ -101,7 +101,7 @@ describe('campagne de fiabilité P4-C — tous les types de dialogue', () => {
expect(seen.length).toBeGreaterThan(0);
});
it('plan (synthétique — pas de capture réelle) : « Would you like to proceed? »', () => {
it('plan (synthétique, pas de capture réelle) : « Would you like to proceed? »', () => {
const d = classifyDialog([
'Here is my implementation plan:',
' - step one',

4
packages/server/test/git.test.ts
View File

@@ -184,7 +184,7 @@ describe('branche : existence, liste, courante, commit', () => {
});
});
describe('P7 — parseurs purs (status v2 / numstat)', () => {
describe('P7 · parseurs purs (status v2 / numstat)', () => {
it('parsePorcelainV2 : modifié, untracked, renommé', () => {
const z =
'1 .M N... 100644 100644 100644 h1 h2 file.txt\x00' +
@@ -217,7 +217,7 @@ describe('P7 — parseurs purs (status v2 / numstat)', () => {
});
});
describe('P7 — changes / diff / staging / commit sélectif (repo tmp)', () => {
describe('P7 · changes / diff / staging / commit sélectif (repo tmp)', () => {
it('listChanges : untracked + modifié non indexé + indexé', async () => {
const repo = makeTmpRepo();
writeFileSync(join(repo, 'untracked.txt'), 'x\n');

4
packages/server/test/pty-manager.test.ts
View File

@@ -463,7 +463,7 @@ describe('PtyManager (pty mocké)', () => {
manager.attach(summary.id, b, 80, 24);
const chunk = 'x'.repeat(200 * 1024); // 200 Kio ASCII
pty.emitData(chunk); // a=200K, b=200K — sous HIGH (384K)
pty.emitData(chunk); // a=200K, b=200K : sous HIGH (384K)
expect(pty.pause).not.toHaveBeenCalled();
manager.ack(summary.id, b, 200 * 1024); // b rattrape tout
@@ -516,7 +516,7 @@ describe('PtyManager (pty mocké)', () => {
const chunks = ['A', 'B', 'C', 'D'].map((c) => c.repeat(mib));
pty.emitData(chunks[0]!); // outstanding 1 Mio
pty.emitData(chunks[1]!); // outstanding 2 Mio — pas strictement > LAGGING_BYTES
pty.emitData(chunks[1]!); // outstanding 2 Mio : pas strictement > LAGGING_BYTES
expect(a.lagging).toBe(false);
expect(a.sendOutput).toHaveBeenCalledTimes(2);

12
packages/server/test/ring-buffer.test.ts
View File

@@ -39,7 +39,7 @@ function mulberry32(seed: number): () => number {
const buf = (s: string): Buffer => Buffer.from(s, 'ascii');
describe('RingBuffer — écriture simple', () => {
describe('RingBuffer · écriture simple', () => {
it('écrit puis relit sans wrap', () => {
const ring = new RingBuffer(16);
ring.write(buf('hello'));
@@ -76,7 +76,7 @@ describe('RingBuffer — écriture simple', () => {
});
});
describe('RingBuffer — wrap-around', () => {
describe('RingBuffer · wrap-around', () => {
it('wrap simple : le chunk chevauche la frontière du buffer', () => {
const ring = new RingBuffer(8);
ring.write(buf('01234')); // pos 0..5
@@ -120,7 +120,7 @@ describe('RingBuffer — wrap-around', () => {
});
});
describe('RingBuffer — chunk >= capacité', () => {
describe('RingBuffer · chunk >= capacité', () => {
it('chunk == capacité sur un ring vierge', () => {
const ring = new RingBuffer(8);
ring.write(buf('abcdefgh'));
@@ -156,7 +156,7 @@ describe('RingBuffer — chunk >= capacité', () => {
});
});
describe('RingBuffer — readFrom', () => {
describe('RingBuffer · readFrom', () => {
function filled(): RingBuffer {
// total = 10, capacité 8 → fenêtre = offsets [2, 10)
const ring = new RingBuffer(8);
@@ -192,7 +192,7 @@ describe('RingBuffer — readFrom', () => {
});
});
describe('RingBuffer — totalOffset monotone', () => {
describe('RingBuffer · totalOffset monotone', () => {
it('croît exactement de la taille de chaque chunk, jamais ne décroît', () => {
const ring = new RingBuffer(8);
const rand = mulberry32(0x5eed);
@@ -207,7 +207,7 @@ describe('RingBuffer — totalOffset monotone', () => {
});
});
describe('RingBuffer — équivalence avec le modèle de référence (property test)', () => {
describe('RingBuffer · équivalence avec le modèle de référence (property test)', () => {
it('tail et readFrom identiques au modèle pour 500 écritures aléatoires (chunks < capacité)', () => {
const capacity = 64;
const ring = new RingBuffer(capacity);

8
packages/server/test/settings-routes.test.ts
View File

@@ -101,7 +101,7 @@ describe('GET /api/v1/settings', () => {
});
});
describe('PATCH /api/v1/settings — sécurité', () => {
describe('PATCH /api/v1/settings · sécurité', () => {
it('ignore toute clé hors allow-list (ne touche pas aux secrets)', async () => {
const before = getSetting(db, 'server_secret');
await bundle.app.inject({ method: 'PATCH', url: '/api/v1/settings', headers: auth(), payload: { server_secret: 'pwned', vapid_private: 'pwned' } });
@@ -115,7 +115,7 @@ describe('PATCH /api/v1/settings — sécurité', () => {
});
});
describe('PATCH /api/v1/settings — découverte des dépôts', () => {
describe('PATCH /api/v1/settings · découverte des dépôts', () => {
it('enregistre des scanRoots et un intervalle valides et les renvoie', async () => {
const res = await bundle.app.inject({
method: 'PATCH',
@@ -148,7 +148,7 @@ describe('PATCH /api/v1/settings — découverte des dépôts', () => {
});
});
describe('PATCH /api/v1/settings — Claude CLI', () => {
describe('PATCH /api/v1/settings · Claude CLI', () => {
// process.execPath (node) est un fichier exécutable réel garanti sur la machine de test.
const realBin = process.execPath;
@@ -191,7 +191,7 @@ describe('PATCH /api/v1/settings — Claude CLI', () => {
});
});
describe('PATCH /api/v1/settings — rétention des sessions (P10)', () => {
describe('PATCH /api/v1/settings · rétention des sessions (P10)', () => {
it('enregistre une rétention valide et l’expose', async () => {
const res = await bundle.app.inject({ method: 'PATCH', url: '/api/v1/settings', headers: auth(), payload: { retentionDays: 7 } });
expect(res.statusCode).toBe(200);

70
packages/shared/src/api.ts
View File

@@ -14,7 +14,7 @@ export interface LoginResponse {
}
export interface MeResponse {
ok: true;
/** id du token de la session courante — sert à marquer « courant » dans la liste des tokens. */
/** id du token de la session courante : sert à marquer « courant » dans la liste des tokens. */
tokenId: string;
tokenLabel: string;
serverVersion: string;
@@ -38,18 +38,18 @@ export interface CreateTokenRequest {
export interface CreateTokenResponse {
id: string;
label: string;
/** valeur en clair — affichée une seule fois, jamais re-récupérable. */
/** valeur en clair : affichée une seule fois, jamais re-récupérable. */
token: string;
}
export interface CreateSessionRequest {
cwd: string;
/** binaire à lancer — défaut "claude" ; "bash" sert aux tests d'acceptation sans quota */
/** binaire à lancer : défaut "claude" ; "bash" sert aux tests d'acceptation sans quota */
command?: 'claude' | 'bash';
}
/**
* POST /api/v1/projects — crée un NOUVEAU dossier de projet `<root>/<name>` (le serveur ne crée
* POST /api/v1/projects : crée un NOUVEAU dossier de projet `<root>/<name>` (le serveur ne crée
* jamais de dossier ailleurs) puis y lance une session. Le `git init` est optionnel (case à cocher).
* Réponse : `CreateProjectResponse`.
*/
@@ -60,7 +60,7 @@ export interface CreateProjectRequest {
name: string;
/** true → `git init` dans le nouveau dossier avant la session (défaut false). */
gitInit?: boolean;
/** binaire à lancer — défaut "claude" ; "bash" sert aux tests sans quota. */
/** binaire à lancer : défaut "claude" ; "bash" sert aux tests sans quota. */
command?: 'claude' | 'bash';
}
export interface CreateProjectResponse {
@@ -76,13 +76,13 @@ export interface SessionsListResponse {
export interface SessionResponse {
session: SessionSummary;
}
/** POST /sessions/hide-discovered — masque tout l'historique de sessions externes visible. */
/** POST /sessions/hide-discovered : masque tout l'historique de sessions externes visible. */
export interface HideDiscoveredResponse {
/** nombre de sessions effectivement masquées. */
hidden: number;
}
// POST /sessions/:id/resume et /sessions/:id/fork (P2) : aucun corps — cwd et command
// POST /sessions/:id/resume et /sessions/:id/fork (P2) : aucun corps, cwd et command
// sont TOUJOURS dérivés du :id (lu sur disque), jamais fournis par le client (cf. spike S1).
export type ResumeSessionRequest = Record<string, never>;
export type ForkSessionRequest = Record<string, never>;
@@ -134,7 +134,7 @@ export interface HookRunResult {
}
/**
* Stratégie de résolution de la branche d'un nouveau worktree :
* - `auto` (défaut) : détecte l'existence de la branche — checkout si elle existe en local, suivi de
* - `auto` (défaut) : détecte l'existence de la branche, checkout si elle existe en local, suivi de
* `origin/<branch>` si elle n'existe que sur le remote, sinon création (`-b`). Robuste pour les
* groupes hétérogènes où la branche peut déjà exister dans certains dépôts mais pas d'autres.
* - `create` : force la création (`-b`), échoue si la branche existe déjà.
@@ -167,7 +167,7 @@ export interface CreateWorktreeResponse {
action: WorktreeBranchAction;
}
/** GET /api/v1/repos/:id/branches — branches locales/remote pour alimenter un sélecteur de base. */
/** GET /api/v1/repos/:id/branches : branches locales/remote pour alimenter un sélecteur de base. */
export interface RepoBranchesResponse {
local: string[];
remote: string[];
@@ -175,12 +175,12 @@ export interface RepoBranchesResponse {
default: string | null;
}
/** POST /api/v1/repos/:id/worktrees/commit — `git add -A` puis commit dans le worktree visé. */
/** POST /api/v1/repos/:id/worktrees/commit : `git add -A` puis commit dans le worktree visé. */
export interface CommitWorktreeRequest {
path: string;
message: string;
/**
* P7 — `all` (défaut, rétrocompat) : `git add -A` + commit (tout l'arbre) ; `staged` : commit
* P7 : `all` (défaut, rétrocompat) : `git add -A` + commit (tout l'arbre) ; `staged` : commit
* de l'index uniquement (staging sélectif préalable via /stage). `amend` réécrit le dernier
* commit (refusé s'il est déjà poussé).
*/
@@ -214,7 +214,7 @@ export interface FileChange {
/** ancien chemin pour un renommage/copie, sinon absent. */
renamedFrom?: string;
}
/** GET /api/v1/repos/:id/worktrees/changes?path= — liste des fichiers modifiés d'un worktree. */
/** GET /api/v1/repos/:id/worktrees/changes?path= : liste des fichiers modifiés d'un worktree. */
export interface WorktreeChangesResponse {
repoId: string;
path: string;
@@ -222,7 +222,7 @@ export interface WorktreeChangesResponse {
/** true si la liste a été bornée (trop de changements). */
truncated: boolean;
}
/** GET /api/v1/repos/:id/worktrees/diff?path=&file=&staged= — diff unifié d'un fichier. */
/** GET /api/v1/repos/:id/worktrees/diff?path=&file=&staged= : diff unifié d'un fichier. */
export interface FileDiffResponse {
path: string;
file: string;
@@ -233,19 +233,19 @@ export interface FileDiffResponse {
/** texte du diff unifié git (vide si binaire ou tooLarge). */
diff: string;
}
/** GET /api/v1/repos/:id/files/content?wt=&path= — contenu d'un fichier (pour l'éditeur Monaco). */
/** GET /api/v1/repos/:id/files/content?wt=&path= : contenu d'un fichier (pour l'éditeur Monaco). */
export interface FileContentResponse {
/** chemin relatif au worktree (POSIX). */
path: string;
content: string;
encoding: 'utf-8';
size: number;
/** mtime du fichier en ms (st.mtimeMs) — base du garde-fou de conflit d'édition (P8). */
/** mtime du fichier en ms (st.mtimeMs) : base du garde-fou de conflit d'édition (P8). */
mtime: number;
/** langage déduit de l'extension (pour Monaco), si reconnu. */
language?: string;
}
/** PUT /api/v1/repos/:id/files/content — écriture d'un fichier (borné au worktree). */
/** PUT /api/v1/repos/:id/files/content : écriture d'un fichier (borné au worktree). */
export interface WriteFileRequest {
/** chemin absolu du worktree. */
wt: string;
@@ -258,10 +258,10 @@ export interface WriteFileRequest {
export interface WriteFileResponse {
ok: true;
size: number;
/** mtime (ms) du fichier après écriture — le client le réutilise comme nouvelle base. */
/** mtime (ms) du fichier après écriture : le client le réutilise comme nouvelle base. */
mtime: number;
}
/** P7 — corps commun des mutations de staging/discard. */
/** P7 : corps commun des mutations de staging/discard. */
export interface WorktreeFilesRequest {
path: string;
/** chemins relatifs au worktree. */
@@ -271,21 +271,21 @@ export interface WorktreeFilesRequest {
export interface DiscardFilesRequest extends WorktreeFilesRequest {
includeUntracked?: boolean;
}
/** POST /api/v1/repos/:id/worktrees/fetch — `git fetch --all --prune`. */
/** POST /api/v1/repos/:id/worktrees/fetch : `git fetch --all --prune`. */
export interface FetchWorktreeRequest {
path: string;
}
/** POST /api/v1/repos/:id/worktrees/pull — `git pull` (ff-only par défaut). */
/** POST /api/v1/repos/:id/worktrees/pull : `git pull` (ff-only par défaut). */
export interface PullWorktreeRequest {
path: string;
mode?: 'ff-only' | 'rebase';
}
/** POST /api/v1/repos/:id/worktrees/push — pousse la branche du worktree (upstream auto si absent). */
/** POST /api/v1/repos/:id/worktrees/push : pousse la branche du worktree (upstream auto si absent). */
export interface PushWorktreeRequest {
path: string;
}
/**
* POST /api/v1/repos/:id/worktrees/promote — « passer en principal » : la branche du worktree devient
* POST /api/v1/repos/:id/worktrees/promote : « passer en principal » : la branche du worktree devient
* le checkout principal du dépôt (le worktree est supprimé, l'ancienne branche principale est conservée).
*/
export interface PromoteWorktreeRequest {
@@ -300,12 +300,12 @@ export interface AdoptWorktreeRequest {
}
/**
* POST /api/v1/repos/:id/session — lance UNE session dans le checkout principal du repo
* POST /api/v1/repos/:id/session : lance UNE session dans le checkout principal du repo
* (`repo.path`) pour « bosser sur la branche principale » sans créer de worktree.
* Réponse : `SessionResponse`.
*/
export interface StartRepoSessionRequest {
/** binaire à lancer — défaut "claude" ; "bash" sert aux tests sans quota. */
/** binaire à lancer : défaut "claude" ; "bash" sert aux tests sans quota. */
command?: 'claude' | 'bash';
/** si fourni : crée/bascule cette branche dans le checkout principal avant la session. */
branch?: string;
@@ -360,15 +360,15 @@ export interface FsEntry {
path: string;
/** présent (true) uniquement en mode markRepos quand le dossier est un dépôt git */
isRepo?: boolean;
/** P7 — présent (true) en mode includeFiles quand l'entrée est un fichier (pas un dossier) */
/** P7 : présent (true) en mode includeFiles quand l'entrée est un fichier (pas un dossier) */
isFile?: boolean;
}
export interface FsListResponse {
/** chemin absolu listé (normalisé) */
path: string;
/** parent (null à la racine `/`) — pour le bouton « remonter » */
/** parent (null à la racine `/`) : pour le bouton « remonter » */
parent: string | null;
/** home de l'utilisateur côté serveur — point de départ par défaut */
/** home de l'utilisateur côté serveur : point de départ par défaut */
home: string;
/** sous-dossiers uniquement, triés sans tenir compte de la casse */
entries: FsEntry[];
@@ -388,7 +388,7 @@ export interface PushUnsubscribeRequest {
}
// ---- Réglages & info serveur (onglet Réglages) ----
/** Config runtime non sensible du daemon — lecture seule (changée via flags CLI + redémarrage). */
/** Config runtime non sensible du daemon : lecture seule (changée via flags CLI + redémarrage). */
export interface ServerInfo {
version: string;
port: number;
@@ -413,22 +413,22 @@ export interface ClaudeBinDiagnostic {
ok: boolean;
}
export interface SettingsResponse {
/** réglages modifiables à chaud (allow-list serveur — jamais les secrets). Cf. SettingsBroadcast. */
/** réglages modifiables à chaud (allow-list serveur, jamais les secrets). Cf. SettingsBroadcast. */
settings: SettingsBroadcast;
server: ServerInfo;
}
export interface UpdateSettingsRequest {
/** racines absolues à scanner (chemins normalisés, ≤ 16) ; remplace la liste. */
scanRoots?: string[];
/** intervalle du re-scan périodique en minutes (0–1440 ; 0 désactive). */
/** intervalle du re-scan périodique en minutes (0-1440 ; 0 désactive). */
scanIntervalMin?: number;
/** chemin absolu du binaire `claude` (fichier exécutable) ; '' pour réinitialiser à l'auto-détection. */
claudeBinPath?: string;
/** override de la racine ~/.claude (répertoire existant) ; '' pour réinitialiser au défaut. */
claudeHome?: string;
/** auto-archivage des sessions terminées après N jours (0 = jamais ; sinon 1–3650). */
/** auto-archivage des sessions terminées après N jours (0 = jamais ; sinon 1-3650). */
retentionDays?: number;
/** purge définitive après N jours (0 = désactivée ; sinon 1–3650). */
/** purge définitive après N jours (0 = désactivée ; sinon 1-3650). */
purgeDays?: number;
}
@@ -505,7 +505,7 @@ export interface CreateGitCredentialRequest {
/** instance self-hosted (Gitea/GitLab) ; absent = service public (github.com / gitlab.com). */
baseUrl?: string;
username?: string;
/** PAT ou app password — chiffré côté serveur (SecretBox), jamais relu. */
/** PAT ou app password : chiffré côté serveur (SecretBox), jamais relu. */
secret?: string;
}
export interface UpdateGitCredentialRequest {
@@ -546,13 +546,13 @@ export interface CloneRequest {
credentialId: string;
/** URL HTTPS du dépôt à cloner. */
remoteUrl: string;
/** dossier de destination (sous une racine de scan) — créé par le clone, refus si existant. */
/** dossier de destination (sous une racine de scan) : créé par le clone, refus si existant. */
dest: string;
}
export interface CloneStartResponse {
operationId: string;
}
/** État d'un clone (GET /repos/clone/:id) — même forme que le push WS clone_update. */
/** État d'un clone (GET /repos/clone/:id) : même forme que le push WS clone_update. */
export interface CloneStatusResponse {
operation: CloneOperation;
}

20
packages/shared/src/protocol.ts
View File

@@ -1,4 +1,4 @@
// Protocole WebSocket Arboretum — une connexion multiplexée par client.
// Protocole WebSocket Arboretum : une connexion multiplexée par client.
// Messages de contrôle : frames TEXTE JSON. Sortie terminal : frames BINAIRES
// (un chunk PTY peut couper un caractère UTF-8 en frontière de frame ; le
// décodage incombe à xterm.write(Uint8Array) côté client, jamais au transport).
@@ -11,7 +11,7 @@ export const BINARY_FRAME = {
HEADER_BYTES: 5,
/** serveur → client : sortie terminal */
OUTPUT: 0x01,
/** serveur → client : resync — le client doit reset son terminal avant d'écrire le payload */
/** serveur → client : resync, le client doit reset son terminal avant d'écrire le payload */
RESYNC: 0x02,
} as const;
@@ -53,7 +53,7 @@ export const FLOW = {
/**
* Replay à l'attach : reset terminal + queue du ring (l'écran TUI se repeint en continu).
* 1 Mo (≈ 10–15k lignes) pour permettre de remonter une vraie conversation Claude dans le terminal ;
* 1 Mo (≈ 10-15k lignes) pour permettre de remonter une vraie conversation Claude dans le terminal ;
* reste < LAGGING_BYTES (pas de faux lagging) et bien dans RING_CAPACITY.
*/
export const REPLAY_TAIL_BYTES = 1024 * 1024;
@@ -160,7 +160,7 @@ export interface WorktreeGitStatus {
behind: number;
dirtyCount: number;
upstream: string | null;
// ---- Champs additifs P7 (optionnels, rétrocompat) — compteurs bon marché calculés dans le
// ---- Champs additifs P7 (optionnels, rétrocompat) : compteurs bon marché calculés dans le
// même passage `status --porcelain=v2` que dirtyCount. La liste détaillée des changements
// (FileChange[]) n'est JAMAIS diffusée ici : elle est servie à la demande (REST) et poussée
// uniquement aux clients qui « regardent » le worktree (voir `worktree_changes`).
@@ -231,7 +231,7 @@ export type CloneState = 'pending' | 'running' | 'done' | 'error';
export interface CloneOperation {
id: string;
state: CloneState;
/** progression 0–100 si git la communique, sinon null. */
/** progression 0-100 si git la communique, sinon null. */
progress: number | null;
/** phase courante rapportée par git (« Receiving objects », « Resolving deltas »…). */
phase: string | null;
@@ -255,7 +255,7 @@ export type ClientMessage =
| { type: 'resize'; channel: number; cols: number; rows: number }
| { type: 'ack'; channel: number; bytes: number }
| { type: 'sub'; topics: Array<'sessions' | 'worktrees' | 'groups' | 'settings' | 'clones'> }
// P7 — abonnement ciblé au détail d'un worktree (diff/statut fin) : on ne pousse le détail
// P7 : abonnement ciblé au détail d'un worktree (diff/statut fin) : on ne pousse le détail
// qu'aux connexions qui « regardent » ce worktree (clé = repoId + path), indépendamment du
// topic global 'worktrees' (qui ne transporte que les compteurs légers).
| { type: 'watch'; repoId: string; path: string }
@@ -270,20 +270,20 @@ export type ServerMessage =
| { type: 'control_changed'; channel: number; controlling: boolean }
| { type: 'session_update'; session: SessionSummary }
| { type: 'session_exit'; sessionId: string; exitCode: number | null; signal: number | null }
// P10 — une session managée vient d'être archivée (auto par ancienneté ou manuellement). Signal
// P10 : une session managée vient d'être archivée (auto par ancienneté ou manuellement). Signal
// léger : le client met à jour son row (badge archived) et le retire si « Show archived » est off.
| { type: 'session_archived'; sessionId: string }
// P11 — un réglage a changé (PATCH /settings) : on diffuse le snapshot non sensible aux abonnés
// P11 : un réglage a changé (PATCH /settings) : on diffuse le snapshot non sensible aux abonnés
// du topic 'settings' pour que tous les clients (et onglets) se synchronisent sans polling.
| { type: 'settings_update'; settings: SettingsBroadcast }
// P12 — progression/fin/erreur d'un clone, poussé aux abonnés du topic 'clones'. L'état complet
// P12 : progression/fin/erreur d'un clone, poussé aux abonnés du topic 'clones'. L'état complet
// (state) discrimine progress/done/error en un seul message.
| { type: 'clone_update'; operation: CloneOperation }
| { type: 'repo_update'; repo: RepoSummary }
| { type: 'repo_removed'; repoId: string }
| { type: 'worktree_update'; repoId: string; worktree: WorktreeSummary }
| { type: 'worktree_removed'; repoId: string; path: string }
// P7 — signal léger « le détail (diff/fichiers modifiés) de ce worktree a changé, refais un
// P7 : signal léger « le détail (diff/fichiers modifiés) de ce worktree a changé, refais un
// GET /changes ou /diff ». Envoyé UNIQUEMENT aux connexions ayant `watch`é cette clé. On ne
// pousse pas le diff complet dans la frame (taille/flow control) : le client re-fetch en REST.
| { type: 'worktree_changes'; repoId: string; path: string }

6
packages/shared/test/protocol.test.ts
View File

@@ -69,7 +69,7 @@ function assertInvariants(msg: ClientMessage): void {
}
}
describe('parseClientMessage — cas valides', () => {
describe('parseClientMessage · cas valides', () => {
it('hello', () => {
expect(parseClientMessage('{"type":"hello","protocol":1}')).toEqual({ type: 'hello', protocol: 1 });
});
@@ -144,7 +144,7 @@ describe('parseClientMessage — cas valides', () => {
});
});
describe('parseClientMessage — cas malformés', () => {
describe('parseClientMessage · cas malformés', () => {
it('JSON invalide ou non-objet', () => {
for (const raw of ['', 'not json', '{', '42', '"str"', 'null', 'true', '[]', '[1,2]']) {
expect(parseClientMessage(raw)).toBeNull();
@@ -218,7 +218,7 @@ describe('parseClientMessage — cas malformés', () => {
});
});
describe('parseClientMessage — fuzz rapide', () => {
describe('parseClientMessage · fuzz rapide', () => {
it('ne lève jamais et tout message accepté respecte les invariants', () => {
const rand = mulberry32(0xa5b0e7);
const types = ['hello', 'attach', 'detach', 'stdin', 'answer', 'resize', 'ack', 'sub', 'ping', 'unknown', '', 'HELLO', 42, null];

16
packages/site/index.html
View File

@@ -6,31 +6,31 @@
<meta name="color-scheme" content="dark" />
<meta name="theme-color" content="#09090b" />
<title>Arboretum — Mission control for your AI coding agents</title>
<title>Arboretum · Mission control for your AI coding agents</title>
<meta
name="description"
content="Arboretum is a local-first daemon you launch with npx that serves a web IDE to run and supervise many Claude Code sessions across git worktrees — edit files, diff, stage and commit, connect git services, all from any device, even your phone."
content="Arboretum is a local-first daemon you launch with npx that serves a web IDE to run and supervise many Claude Code sessions across git worktrees: edit files, diff, stage and commit, connect git services, all from any device, even your phone."
/>
<link rel="canonical" href="https://git-arboretum.com/" />
<!-- Open Graph / Twitter -->
<meta property="og:type" content="website" />
<meta property="og:url" content="https://git-arboretum.com/" />
<meta property="og:title" content="Arboretum — Mission control for your AI coding agents" />
<meta property="og:title" content="Arboretum · Mission control for your AI coding agents" />
<meta
property="og:description"
content="Run and supervise many Claude Code sessions across every git worktree — a browser IDE to edit, diff, commit and clone, from any device, even your phone."
content="Run and supervise many Claude Code sessions across every git worktree: a browser IDE to edit, diff, commit and clone, from any device, even your phone."
/>
<meta property="og:site_name" content="Arboretum" />
<meta property="og:image" content="https://git-arboretum.com/assets/og-cover.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="Arboretum — mission control for your AI coding agents" />
<meta property="og:image:alt" content="Arboretum · mission control for your AI coding agents" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Arboretum — Mission control for your AI coding agents" />
<meta name="twitter:title" content="Arboretum · Mission control for your AI coding agents" />
<meta
name="twitter:description"
content="Run and supervise many Claude Code sessions across every git worktree — a browser IDE to edit, diff, commit and clone, from any device, even your phone."
content="Run and supervise many Claude Code sessions across every git worktree: a browser IDE to edit, diff, commit and clone, from any device, even your phone."
/>
<meta name="twitter:image" content="https://git-arboretum.com/assets/og-cover.png" />
@@ -44,7 +44,7 @@
<div id="app"></div>
<noscript>
<div style="padding: 24px; font-family: system-ui, sans-serif; color: #f4f4f5; text-align: center">
Arboretum — mission control for your AI coding agents.
Arboretum · mission control for your AI coding agents.
<a href="https://git.lidge.fr/johanleroy/arboretum" style="color: #34d399">View on Gitea</a>.
</div>
</noscript>

2
packages/site/public/.htaccess
View File

@@ -1,4 +1,4 @@
# git-arboretum.com — site vitrine statique (Vue 3 / Vite).
# git-arboretum.com : site vitrine statique (Vue 3 / Vite).
#
# Google PageSpeed (mod_pagespeed) renvoie un corps HTML VIDE sur ce domaine Plesk
# (la home répond 200 mais 0 octet → page blanche), alors que les assets statiques

2
packages/site/src/App.vue
View File

@@ -26,7 +26,7 @@ watch(
{ immediate: true },
);
// Grain de fond + halo emerald (décoratifs) — portés tels quels du design.
// Grain de fond + halo emerald (décoratifs) : portés tels quels du design.
const grainStyle = {
position: 'fixed',
inset: '0',

2
packages/site/src/components/AppFooter.vue
View File

@@ -21,7 +21,7 @@ const { t } = useI18n();
style="filter: grayscale(1) brightness(1.5); opacity: 0.4"
/>
<span class="font-mono text-sm text-zinc-300">git-arboretum.com</span>
<span class="ml-1 text-[13px] text-zinc-600">— {{ t('footTag') }}</span>
<span class="ml-1 text-[13px] text-zinc-600">· {{ t('footTag') }}</span>
</div>
<div class="flex items-center gap-[22px] text-sm">
<a :href="REPO" target="_blank" rel="noopener" class="inline-flex items-center gap-1.5 text-zinc-400 no-underline transition-colors hover:text-emerald-400">

2
packages/site/src/components/FeaturesSection.vue
View File

@@ -34,7 +34,7 @@ const { t } = useI18n();
</template>
<span class="text-sky-300">{{ t('busy') }}</span> ·
<span class="text-amber-300">{{ t('waiting') }}</span> ·
<span class="text-emerald-400">{{ t('idle') }}</span> — {{ t('feat3Desc') }}
<span class="text-emerald-400">{{ t('idle') }}</span> · {{ t('feat3Desc') }}
</FeatureCard>
<FeatureCard :title="t('feat4Title')">

2
packages/site/src/components/HeroMockup.vue
View File

@@ -35,7 +35,7 @@ const termLines = computed(() =>
anim.value.lines.map((l) => ({ text: l.text, color: LINE_COLORS[l.k] ?? '#d4d4d8' })),
);
// Options du dialogue de permission — reproduit DialogPrompt (boutons numérotés + Deny).
// Options du dialogue de permission : reproduit DialogPrompt (boutons numérotés + Deny).
const dlgOptions = computed(() =>
DLG_OPTS[locale.value as AppLocale].map((txt, i) => ({
num: anim.value.ans === i ? '✓' : String(i + 1),

18
packages/site/src/i18n/content.ts
View File

@@ -1,4 +1,4 @@
// Listes structurées (FAQ, options de dialogue) — gardées hors des messages
// Listes structurées (FAQ, options de dialogue) : gardées hors des messages
// vue-i18n et indexées par locale, pour rester du texte pur typé (pas d'innerHTML).
import type { AppLocale } from './index';
@@ -11,7 +11,7 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
en: [
{
q: 'How is this different from running Claude Code in a terminal?',
a: 'It runs the very same interactive claude CLI — Arboretum just wraps it in a managed terminal you reach from a browser. What you gain on top: a worktree-first dashboard across all your repos, live busy / waiting / available states, a multi-terminal grid, push notifications, and the ability to answer a prompt from your phone. It supervises your sessions; it does not change how Claude Code works.',
a: 'It runs the very same interactive claude CLI. Arboretum just wraps it in a managed terminal you reach from a browser. What you gain on top: a worktree-first dashboard across all your repos, live busy / waiting / available states, a multi-terminal grid, push notifications, and the ability to answer a prompt from your phone. It supervises your sessions; it does not change how Claude Code works.',
},
{
q: 'Does it need the cloud?',
@@ -19,7 +19,7 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
},
{
q: 'How do I access it remotely?',
a: 'Through Tailscale Serve. Expose the dashboard to your tailnet and reach it securely from any device — no port forwarding, no public endpoint.',
a: 'Through Tailscale Serve. Expose the dashboard to your tailnet and reach it securely from any device: no port forwarding, no public endpoint.',
},
{
q: 'Does it work on mobile?',
@@ -31,11 +31,11 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
},
{
q: 'Can I edit files directly?',
a: 'Yes. The /workspace view is a real IDE: a file tree, a full Monaco editor with inline diffs, and the correlated session terminal. Stage changes file by file, write a commit message, amend, then push — all from the browser, on any device.',
a: 'Yes. The /workspace view is a real IDE: a file tree, a full Monaco editor with inline diffs, and the correlated session terminal. Stage changes file by file, write a commit message, amend, then push, all from the browser, on any device.',
},
{
q: 'Can I connect GitHub, GitLab or Gitea and clone?',
a: 'Yes. Add a connection with a personal access token or app password — credentials are encrypted at rest (AES-256-GCM) and never returned in clear by the API. Then browse remote repos and clone over HTTPS with live progress.',
a: 'Yes. Add a connection with a personal access token or app password. Credentials are encrypted at rest (AES-256-GCM) and never returned in clear by the API. Then browse remote repos and clone over HTTPS with live progress.',
},
{
q: 'What happens to old sessions?',
@@ -45,7 +45,7 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
fr: [
{
q: 'En quoi est-ce différent de lancer Claude Code dans un terminal ?',
a: "C'est exactement le même CLI claude interactif — Arboretum l'enveloppe simplement dans un terminal managé accessible depuis un navigateur. Ce que vous gagnez en plus : un dashboard worktree-first sur tous vos repos, les états occupée / en attente / disponible en direct, une grille multi-terminaux, des notifications push, et la possibilité de répondre à une question depuis votre téléphone. Il supervise vos sessions ; il ne change rien au fonctionnement de Claude Code.",
a: "C'est exactement le même CLI claude interactif. Arboretum l'enveloppe simplement dans un terminal managé accessible depuis un navigateur. Ce que vous gagnez en plus : un dashboard worktree-first sur tous vos repos, les états occupée / en attente / disponible en direct, une grille multi-terminaux, des notifications push, et la possibilité de répondre à une question depuis votre téléphone. Il supervise vos sessions ; il ne change rien au fonctionnement de Claude Code.",
},
{
q: 'A-t-il besoin du cloud ?',
@@ -53,7 +53,7 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
},
{
q: 'Comment y accéder à distance ?',
a: "Via Tailscale Serve. Exposez le dashboard à votre tailnet et accédez-y en sécurité depuis n'importe quel appareil — sans redirection de port ni endpoint public.",
a: "Via Tailscale Serve. Exposez le dashboard à votre tailnet et accédez-y en sécurité depuis n'importe quel appareil : sans redirection de port ni endpoint public.",
},
{
q: 'Fonctionne-t-il sur mobile ?',
@@ -65,11 +65,11 @@ export const FAQS: Record<AppLocale, FaqItem[]> = {
},
{
q: 'Puis-je éditer les fichiers directement ?',
a: "Oui. La vue /workspace est un vrai IDE : un arbre de fichiers, un éditeur Monaco complet avec les diffs inline, et le terminal de la session corrélée. Indexez les changements fichier par fichier, rédigez un message de commit, amendez, puis poussez — le tout depuis le navigateur, sur n'importe quel appareil.",
a: "Oui. La vue /workspace est un vrai IDE : un arbre de fichiers, un éditeur Monaco complet avec les diffs inline, et le terminal de la session corrélée. Indexez les changements fichier par fichier, rédigez un message de commit, amendez, puis poussez, le tout depuis le navigateur, sur n'importe quel appareil.",
},
{
q: 'Puis-je connecter GitHub, GitLab ou Gitea et cloner ?',
a: "Oui. Ajoutez une connexion avec un token d'accès personnel ou un app password — les identifiants sont chiffrés au repos (AES-256-GCM) et jamais renvoyés en clair par l'API. Parcourez ensuite les repos distants et clonez en HTTPS avec progression en direct.",
a: "Oui. Ajoutez une connexion avec un token d'accès personnel ou un app password. Les identifiants sont chiffrés au repos (AES-256-GCM) et jamais renvoyés en clair par l'API. Parcourez ensuite les repos distants et clonez en HTTPS avec progression en direct.",
},
{
q: "Qu'advient-il des anciennes sessions ?",

30
packages/site/src/i18n/en.ts
View File

@@ -1,4 +1,4 @@
// Messages EN — copie fidèle du dict() du design Arboretum.dc.html.
// Messages EN : copie fidèle du dict() du design Arboretum.dc.html.
export default {
navFeatures: 'Features',
navWorkspace: 'Workspace',
@@ -9,16 +9,16 @@ export default {
heroBadge: 'Mission control for AI coding agents',
heroTitle: 'Mission control for your AI coding agents',
heroSub:
'Run many Claude Code sessions across every git worktree — and supervise them from any device, even your phone.',
'Run many Claude Code sessions across every git worktree, and supervise them from any device, even your phone.',
getStarted: 'Get started',
probKicker: 'The problem',
probTitle: "Many agents across worktrees is chaos — and you're chained to one terminal.",
probTitle: "Many agents across worktrees is chaos, and you're chained to one terminal.",
probBody:
'Sessions scattered across tabs. No idea which agent is waiting on you. Step away from the desk and everything stalls. Arboretum is the single pane of glass.',
featKicker: 'Everything in one view',
featTitle: 'Built to supervise agents working in parallel',
feat1Title: 'Worktree-first',
feat1Desc: 'Work on your main branch or spin up an isolated worktree — then commit, push or promote a branch to main, without opening a terminal. Branches, not chaos.',
feat1Desc: 'Work on your main branch or spin up an isolated worktree, then commit, push or promote a branch to main, without opening a terminal. Branches, not chaos.',
feat2Title: 'Many sessions, one view',
feat2Desc: 'Run parallel Claude Code agents side by side in a single live grid.',
feat3Title: 'Fine-grained states',
@@ -38,22 +38,22 @@ export default {
feat10Title: 'New project in one click',
feat10Desc: 'Create a project folder anywhere (optional git init) and start a Claude session in it, from any device.',
scAKicker: 'Worktree-first dashboard',
scATitle: 'See what needs you — before anything stalls',
scATitle: 'See what needs you, before anything stalls',
scABody:
'A live list of every worktree and its session state. The Needs attention rail floats the agents waiting on a decision to the top, so nothing sits blocked while you are heads-down elsewhere. Commit, push or promote a branch to main straight from the card, and hide the noisy history left by past terminal sessions so the list stays actionable.',
scBKicker: 'Multi-terminal grid',
scBTitle: "Every agent's output, streaming live",
scBBody:
'Watch all your sessions at once — real terminal output, color-coded by state, updating in real time. Click any pane to take over in a fullscreen terminal — prompt pinned to the bottom, full scrollback above — answer a prompt, or stop a run.',
'Watch all your sessions at once: real terminal output, color-coded by state, updating in real time. Click any pane to take over in a fullscreen terminal (prompt pinned to the bottom, full scrollback above), answer a prompt, or stop a run.',
scCKicker: 'On your phone',
scCTitle: 'Unblock an agent from the kitchen',
scCBody:
'Install the PWA and get a Web Push the second a session needs you. Tap the notification, read the prompt, answer the dialog — your agent keeps moving while you are away.',
'Install the PWA and get a Web Push the second a session needs you. Tap the notification, read the prompt, answer the dialog. Your agent keeps moving while you are away.',
grpHub: '1 session',
grpKicker: 'Work groups · cross-repo',
grpTitle: 'Drive every repo from one Claude session',
grpBody:
'Group the repos that move together — a service, its client, its docs. Launch a single Claude session that spans all of them at once: one conversation, one shared context working across every repo — instead of juggling one agent per repo.',
'Group the repos that move together: a service, its client, its docs. Launch a single Claude session that spans all of them at once: one conversation, one shared context working across every repo, instead of juggling one agent per repo.',
howKicker: 'How it works',
howTitle: 'Zero install. Three steps.',
step1Title: 'Launch the daemon',
@@ -64,7 +64,7 @@ export default {
step3Desc: 'Start Claude Code sessions on your main branch or any worktree, and watch them from anywhere.',
secKicker: 'Security',
secTitle: 'A web terminal you can actually trust',
secIntro: 'Built local-first. Nothing is exposed unless you choose to — and even then, on your terms.',
secIntro: 'Built local-first. Nothing is exposed unless you choose to, and even then, on your terms.',
sec1Title: 'Localhost by default',
sec1Desc: 'Binds to 127.0.0.1. Nothing leaves your machine unless you say so.',
sec2Title: 'Hashed tokens',
@@ -72,7 +72,7 @@ export default {
sec3Title: 'Strict origin checks',
sec3Desc: 'Every request is origin-validated. No cross-site surprises.',
sec4Title: 'Remote via Tailscale',
sec4Desc: 'Reach it over Tailscale Serve — no public port, no port forwarding.',
sec4Desc: 'Reach it over Tailscale Serve: no public port, no port forwarding.',
faqTitle: 'Questions, answered',
ctaTitle: 'Take command of your agents',
ctaBody: 'One command to launch. Supervise everything from one place.',
@@ -110,21 +110,21 @@ export default {
// New feature cards (P7→P12: IDE worktree)
feat11Title: 'A real IDE for every worktree',
feat11Desc: 'Browse the file tree, edit in a full Monaco editor, and read changes as inline diffs — all in the /workspace view.',
feat11Desc: 'Browse the file tree, edit in a full Monaco editor, and read changes as inline diffs, all in the /workspace view.',
feat12Title: 'Diff & selective staging',
feat12Desc: 'Stage, unstage or discard file by file, then commit (all or staged), amend, fetch and pull — without leaving the dashboard.',
feat12Desc: 'Stage, unstage or discard file by file, then commit (all or staged), amend, fetch and pull, without leaving the dashboard.',
feat13Title: 'Remote git services',
feat13Desc: 'Connect GitHub, GitLab or Gitea with a PAT or app password — credentials encrypted at rest — and clone over HTTPS with live progress.',
feat13Desc: 'Connect GitHub, GitLab or Gitea with a PAT or app password (credentials encrypted at rest) and clone over HTTPS with live progress.',
feat14Title: 'Auto-archive sessions',
feat14Desc: 'Finished sessions are archived automatically after a configurable retention window (30 days by default), keeping the list clean.',
feat15Title: 'Real-time file sync',
feat15Desc: 'A filesystem watcher streams changes the moment a file moves on disk — diffs and status update live, no refresh needed.',
feat15Desc: 'A filesystem watcher streams changes the moment a file moves on disk: diffs and status update live, no refresh needed.',
// Workspace IDE showcase
wsKicker: 'The worktree IDE',
wsTitle: 'A full IDE for every worktree, in the browser',
wsBody:
'Open any worktree in /workspace: a file tree on the left, a Monaco editor and inline diff in the center, and the correlated session terminal on the right. Stage changes file by file, write a commit message, push — all without leaving the page, on any device.',
'Open any worktree in /workspace: a file tree on the left, a Monaco editor and inline diff in the center, and the correlated session terminal on the right. Stage changes file by file, write a commit message, push, all without leaving the page, on any device.',
wsEditor: 'Editor',
wsDiff: 'Diff',
wsFiles: 'Files',

30
packages/site/src/i18n/fr.ts
View File

@@ -1,4 +1,4 @@
// Messages FR — copie fidèle du dict() du design Arboretum.dc.html.
// Messages FR : copie fidèle du dict() du design Arboretum.dc.html.
export default {
navFeatures: 'Fonctionnalités',
navWorkspace: 'Workspace',
@@ -9,16 +9,16 @@ export default {
heroBadge: 'Poste de commandement pour agents de code IA',
heroTitle: 'Le poste de commandement de vos agents de code IA',
heroSub:
"Lancez plusieurs sessions Claude Code à travers chaque worktree git — et supervisez-les depuis n'importe quel appareil, même votre téléphone.",
"Lancez plusieurs sessions Claude Code à travers chaque worktree git, et supervisez-les depuis n'importe quel appareil, même votre téléphone.",
getStarted: 'Commencer',
probKicker: 'Le problème',
probTitle: "Plein d'agents à travers les worktrees, c'est le chaos — et vous êtes cloué à un seul terminal.",
probTitle: "Plein d'agents à travers les worktrees, c'est le chaos, et vous êtes cloué à un seul terminal.",
probBody:
"Des sessions éparpillées dans des onglets. Aucune idée de quel agent vous attend. Vous quittez le bureau et tout se fige. Arboretum, c'est la vitre unique.",
featKicker: 'Tout dans une seule vue',
featTitle: 'Conçu pour superviser des agents qui travaillent en parallèle',
feat1Title: "Worktree d'abord",
feat1Desc: 'Travaillez sur votre branche principale ou créez un worktree isolé — puis commitez, poussez ou passez une branche en principal, sans ouvrir de terminal. Des branches, pas du chaos.',
feat1Desc: 'Travaillez sur votre branche principale ou créez un worktree isolé, puis commitez, poussez ou passez une branche en principal, sans ouvrir de terminal. Des branches, pas du chaos.',
feat2Title: 'Plusieurs sessions, une vue',
feat2Desc: 'Lancez des agents Claude Code en parallèle, côte à côte dans une seule grille en direct.',
feat3Title: 'États fins',
@@ -38,22 +38,22 @@ export default {
feat10Title: 'Nouveau projet en un clic',
feat10Desc: "Créez un dossier de projet où vous voulez (git init optionnel) et lancez-y une session Claude, depuis n'importe quel appareil.",
scAKicker: 'Dashboard worktree-first',
scATitle: 'Voyez ce qui vous attend — avant que ça ne bloque',
scATitle: 'Voyez ce qui vous attend, avant que ça ne bloque',
scABody:
"Une liste en direct de chaque worktree et de l'état de sa session. Le bandeau À traiter fait remonter les agents en attente d'une décision, pour que rien ne reste bloqué pendant que vous êtes concentré ailleurs. Commitez, poussez ou passez une branche en principal directement depuis la carte, et masquez l'historique encombrant laissé par vos anciennes sessions terminal pour garder la liste actionnable.",
scBKicker: 'Grille multi-terminaux',
scBTitle: 'La sortie de chaque agent, en direct',
scBBody:
"Surveillez toutes vos sessions en même temps — vraie sortie terminal, couleur selon l'état, mise à jour en temps réel. Cliquez sur un panneau pour reprendre la main dans un terminal plein écran — invite ancrée en bas, historique défilable au-dessus — répondre, ou arrêter une exécution.",
"Surveillez toutes vos sessions en même temps : vraie sortie terminal, couleur selon l'état, mise à jour en temps réel. Cliquez sur un panneau pour reprendre la main dans un terminal plein écran (invite ancrée en bas, historique défilable au-dessus), répondre, ou arrêter une exécution.",
scCKicker: 'Sur votre téléphone',
scCTitle: 'Débloquez un agent depuis la cuisine',
scCBody:
"Installez la PWA et recevez un Web Push dès qu'une session a besoin de vous. Touchez la notification, lisez la question, répondez au dialogue — votre agent continue pendant que vous êtes loin du bureau.",
"Installez la PWA et recevez un Web Push dès qu'une session a besoin de vous. Touchez la notification, lisez la question, répondez au dialogue. Votre agent continue pendant que vous êtes loin du bureau.",
grpHub: '1 session',
grpKicker: 'Work groups · cross-repo',
grpTitle: 'Pilotez tous vos repos depuis une seule session Claude',
grpBody:
'Regroupez les repos qui avancent ensemble — un service, son client, sa doc. Lancez une seule session Claude qui les couvre tous à la fois : une conversation, un contexte partagé travaillant à travers chaque repo — au lieu de jongler avec un agent par repo.',
'Regroupez les repos qui avancent ensemble : un service, son client, sa doc. Lancez une seule session Claude qui les couvre tous à la fois : une conversation, un contexte partagé travaillant à travers chaque repo, au lieu de jongler avec un agent par repo.',
howKicker: 'Comment ça marche',
howTitle: 'Zéro install. Trois étapes.',
step1Title: 'Lancez le daemon',
@@ -64,7 +64,7 @@ export default {
step3Desc: "Démarrez des sessions Claude Code sur votre branche principale ou n'importe quel worktree, et surveillez-les de partout.",
secKicker: 'Sécurité',
secTitle: 'Un terminal web en qui vous pouvez avoir confiance',
secIntro: "Conçu local-first. Rien n'est exposé sauf si vous le décidez — et toujours selon vos règles.",
secIntro: "Conçu local-first. Rien n'est exposé sauf si vous le décidez, et toujours selon vos règles.",
sec1Title: 'Localhost par défaut',
sec1Desc: 'Se lie à 127.0.0.1. Rien ne quitte votre machine sans votre accord.',
sec2Title: 'Tokens hashés',
@@ -72,7 +72,7 @@ export default {
sec3Title: "Vérification d'origine stricte",
sec3Desc: 'Chaque requête est validée par origine. Pas de surprise cross-site.',
sec4Title: 'Distant via Tailscale',
sec4Desc: 'Accédez-y via Tailscale Serve — aucun port public, aucune redirection de port.',
sec4Desc: 'Accédez-y via Tailscale Serve : aucun port public, aucune redirection de port.',
faqTitle: 'Vos questions, les réponses',
ctaTitle: 'Prenez le commandement de vos agents',
ctaBody: 'Une commande pour lancer. Tout superviser depuis un seul endroit.',
@@ -110,21 +110,21 @@ export default {
// Nouvelles cartes de fonctionnalités (P7→P12 : IDE worktree)
feat11Title: 'Un vrai IDE pour chaque worktree',
feat11Desc: "Parcourez l'arbre de fichiers, éditez dans un éditeur Monaco complet, et lisez les changements en diff inline — le tout dans la vue /workspace.",
feat11Desc: "Parcourez l'arbre de fichiers, éditez dans un éditeur Monaco complet, et lisez les changements en diff inline, le tout dans la vue /workspace.",
feat12Title: 'Diff & staging sélectif',
feat12Desc: 'Indexez, désindexez ou annulez fichier par fichier, puis commitez (tout ou indexé), amendez, fetchez et pullez — sans quitter le dashboard.',
feat12Desc: 'Indexez, désindexez ou annulez fichier par fichier, puis commitez (tout ou indexé), amendez, fetchez et pullez, sans quitter le dashboard.',
feat13Title: 'Services git distants',
feat13Desc: 'Connectez GitHub, GitLab ou Gitea avec un PAT ou un app password — identifiants chiffrés au repos — et clonez en HTTPS avec progression en direct.',
feat13Desc: 'Connectez GitHub, GitLab ou Gitea avec un PAT ou un app password (identifiants chiffrés au repos) et clonez en HTTPS avec progression en direct.',
feat14Title: 'Archivage auto des sessions',
feat14Desc: 'Les sessions terminées sont archivées automatiquement après une rétention configurable (30 jours par défaut), pour garder la liste propre.',
feat15Title: 'Synchro fichiers temps réel',
feat15Desc: "Un watcher du système de fichiers pousse les changements dès qu'un fichier bouge sur le disque — diffs et statut se mettent à jour en direct, sans rafraîchir.",
feat15Desc: "Un watcher du système de fichiers pousse les changements dès qu'un fichier bouge sur le disque : diffs et statut se mettent à jour en direct, sans rafraîchir.",
// Showcase IDE workspace
wsKicker: "L'IDE worktree",
wsTitle: 'Un IDE complet pour chaque worktree, dans le navigateur',
wsBody:
"Ouvrez n'importe quel worktree dans /workspace : un arbre de fichiers à gauche, un éditeur Monaco et le diff inline au centre, et le terminal de la session corrélée à droite. Indexez les changements fichier par fichier, rédigez un message de commit, poussez — sans quitter la page, depuis n'importe quel appareil.",
"Ouvrez n'importe quel worktree dans /workspace : un arbre de fichiers à gauche, un éditeur Monaco et le diff inline au centre, et le terminal de la session corrélée à droite. Indexez les changements fichier par fichier, rédigez un message de commit, poussez, sans quitter la page, depuis n'importe quel appareil.",
wsEditor: 'Éditeur',
wsDiff: 'Diff',
wsFiles: 'Fichiers',

2
packages/site/src/lib/links.ts
View File

@@ -1,4 +1,4 @@
// URLs externes du site vitrine — source unique de vérité.
// URLs externes du site vitrine : source unique de vérité.
// Le dépôt Gitea est « arboretum » (et non « git-arboretum », qui est le nom du
// paquet npm `@johanleroy/git-arboretum`). Centralisé ici pour ne plus dériver.
export const REPO = 'https://git.lidge.fr/johanleroy/arboretum';

2
packages/site/src/main.ts
View File

@@ -1,5 +1,5 @@
import { createApp } from 'vue';
// Polices self-host (subset latin) — bundlées par Vite, aucune requête Google Fonts.
// Polices self-host (subset latin) : bundlées par Vite, aucune requête Google Fonts.
import '@fontsource/jetbrains-mono/latin-400.css';
import '@fontsource/jetbrains-mono/latin-500.css';
import '@fontsource/jetbrains-mono/latin-600.css';

6
packages/vscode/CHANGELOG.md
View File

@@ -3,18 +3,18 @@
## 0.2.0
Follows the daemon's "worktree IDE" milestone (P7→P12), while keeping the extension a lightweight
**visual worktree manager** — no editor/diff duplicated here, that lives in the web IDE:
**visual worktree manager**: no editor/diff duplicated here, that lives in the web IDE:
- **Detailed git status** in the worktree tree: staged / unstaged / conflict counts and the last commit
subject (from the daemon's enriched `WorktreeGitStatus`).
- **Open Worktree IDE** command — deep-links to the web `/workspace/:repoId/:wt` view.
- **Open Worktree IDE** command: deep-links to the web `/workspace/:repoId/:wt` view.
- **Fetch** and **Pull** (fast-forward only or rebase) commands on worktrees, alongside commit/push.
- **Archived sessions**: the `session_archived` event is handled live; finished, auto-archived sessions
are badged and hidden by default, with a new `arboretum.showArchivedSessions` setting to reveal them.
## 0.1.0
Initial release — native VS Code integration for the Arboretum daemon:
Initial release: native VS Code integration for the Arboretum daemon:
- Real-time **Repositories** and **Groups** trees (repos → worktrees → sessions) over the daemon WebSocket.
- **Native terminals** (`Pseudoterminal`) to attach/observe any session, reusing VS Code's rendering and

14
packages/vscode/README.md
View File

@@ -1,26 +1,26 @@
# Arboretum for VS Code
Pilot your git **worktrees** and **Claude Code sessions** from inside VS Code — a real native
Pilot your git **worktrees** and **Claude Code sessions** from inside VS Code: a real native
integration on top of the [Arboretum](https://git.lidge.fr/johanleroy/arboretum) daemon, not a webview.
- **Live tree** of Repositories → Worktrees → Sessions (and a Groups view), updated in real time over
the daemon's WebSocket.
- **Native terminals**: attach to any session in a real VS Code terminal (a `Pseudoterminal` bridges the
daemon's PTY) — you get VS Code's own rendering, scrollback, copy/paste and links for free.
daemon's PTY): you get VS Code's own rendering, scrollback, copy/paste and links for free.
- **Waiting alerts**: a status-bar counter and native notifications when a Claude session is waiting for
input — answer **Yes/No** without even opening the terminal (uses the daemon's `answer` command).
- **Git mutations** from the tree: create worktree, commit, push, fetch, pull, promote to main — with a
input: answer **Yes/No** without even opening the terminal (uses the daemon's `answer` command).
- **Git mutations** from the tree: create worktree, commit, push, fetch, pull, promote to main, with a
**detailed git status** on each worktree (staged / unstaged / conflicts and the last commit subject).
- **Open Worktree IDE**: jump from any worktree to its full `/workspace` view (file tree, Monaco editor,
inline diffs, integrated terminal) in the browser. The extension stays a lightweight visual worktree
manager — the heavy editing lives in the web IDE.
manager: the heavy editing lives in the web IDE.
- **Workspace-aware**: the worktree matching your open folder is highlighted; start a session or create a
worktree for the current folder in one command.
## Requirements
- A running Arboretum daemon (`npx @johanleroy/git-arboretum`, or installed as a user service via
`arboretum install`). The extension is a **client** — it does not start the daemon.
`arboretum install`). The extension is a **client**: it does not start the daemon.
- An access token. The bootstrap token is printed once on first daemon start; you can also create one in
the Arboretum dashboard (**Settings → Tokens**).
@@ -41,7 +41,7 @@ integration on top of the [Arboretum](https://git.lidge.fr/johanleroy/arboretum)
| `arboretum.notifyOnWaiting` | `true` | Native notification when a session starts waiting for input. |
The extension authenticates with `Authorization: Bearer <token>` on both REST and the WebSocket upgrade.
For remote access, point `arboretum.url` at your Tailscale Serve URL (`https://…`) — the WebSocket is
For remote access, point `arboretum.url` at your Tailscale Serve URL (`https://…`): the WebSocket is
derived automatically (`wss://`).
## Building & packaging (private VSIX)

2
packages/vscode/package.json
View File

@@ -1,7 +1,7 @@
{
"name": "git-arboretum",
"displayName": "Arboretum",
"description": "Pilot your git worktrees and Claude Code sessions from VS Code — native terminals, live tree, waiting alerts.",
"description": "Pilot your git worktrees and Claude Code sessions from VS Code: native terminals, live tree, waiting alerts.",
"version": "0.2.0",
"private": true,
"publisher": "johanleroy",

2
packages/vscode/src/api/rest-client.ts
View File

@@ -1,4 +1,4 @@
// Client REST typé du daemon Arboretum — module pur (pas d'import vscode), testable.
// Client REST typé du daemon Arboretum : module pur (pas d'import vscode), testable.
// Auth par en-tête `Authorization: Bearer <token>` (le hook preValidation du serveur l'accepte
// au même titre que le cookie). Un client Node n'envoie pas d'en-tête Origin → il passe le check
// Origin strict côté serveur. Réutilise les types de `@arboretum/shared`.

8
packages/vscode/src/api/ws-client.ts
View File

@@ -1,4 +1,4 @@
// Client WebSocket multiplexé Node — portage du client web (packages/web/src/lib/ws-client.ts).
// Client WebSocket multiplexé Node : portage du client web (packages/web/src/lib/ws-client.ts).
// UNE connexion, plusieurs canaux ; handshake hello/hello_ok, sub des topics, corrélation FIFO des
// 'attached', flow control par ACK (cumul d'octets PAR CANAL, remis à 0 à chaque RESYNC), reconnexion
// avec backoff. Différences vs web :
@@ -39,7 +39,7 @@ export interface AttachOptions {
sink: AttachmentSink;
}
/** Transport minimal — abstrait pour les tests ; l'impl par défaut enveloppe `ws`. */
/** Transport minimal : abstrait pour les tests ; l'impl par défaut enveloppe `ws`. */
export interface RawSocket {
send(data: string): void;
close(): void;
@@ -404,7 +404,7 @@ export class ArbWsClient {
return;
case 'error': {
if (msg.channel !== undefined) {
this.opts.log?.(`channel ${msg.channel}: ${msg.code} — ${msg.message}`);
this.opts.log?.(`channel ${msg.channel}: ${msg.code}: ${msg.message}`);
return;
}
if ((msg.code === 'NOT_FOUND' || msg.code === 'SESSION_EXITED') && this.awaitingAttached.length > 0) {
@@ -420,7 +420,7 @@ export class ArbWsClient {
}
return;
}
this.opts.log?.(`${msg.code} — ${msg.message}`);
this.opts.log?.(`${msg.code}: ${msg.message}`);
return;
}
case 'pong':

6
packages/vscode/src/commands.ts
View File

@@ -42,7 +42,7 @@ async function run(label: string, fn: () => Promise<void>): Promise<void> {
await fn();
} catch (err) {
const msg = err instanceof RestError ? `${err.code}: ${err.message}` : (err as Error).message;
void vscode.window.showErrorMessage(`Arboretum — ${label}: ${msg}`);
void vscode.window.showErrorMessage(`Arboretum · ${label}: ${msg}`);
}
}
@@ -310,7 +310,7 @@ async function promoteWorktreeFlow(deps: CommandDeps, repoId: string, worktree:
return;
}
const msg = err instanceof RestError ? `${err.code}: ${err.message}` : (err as Error).message;
void vscode.window.showErrorMessage(`Arboretum — promote: ${msg}`);
void vscode.window.showErrorMessage(`Arboretum · promote: ${msg}`);
}
}
@@ -326,7 +326,7 @@ async function startGroupSessionFlow(deps: CommandDeps, group: GroupSummary): Pr
deps.terminals.open(res.session, 'interactive');
if (res.skipped.length > 0) {
void vscode.window.showWarningMessage(
`Arboretum: ${res.skipped.length} repo(s) skipped — ${res.skipped.map((s) => s.reason).join('; ')}`,
`Arboretum: ${res.skipped.length} repo(s) skipped: ${res.skipped.map((s) => s.reason).join('; ')}`,
);
}
});

4
packages/vscode/src/config.ts
View File

@@ -1,4 +1,4 @@
// Lecture des réglages `arboretum.*` — module pur (aucun import vscode) pour rester testable.
// Lecture des réglages `arboretum.*` : module pur (aucun import vscode) pour rester testable.
// L'extension fournit un `ConfigSnapshot` lu depuis workspace.getConfiguration ; ce module
// normalise/dérive les valeurs (notamment l'URL WebSocket à partir de l'URL HTTP).
@@ -22,7 +22,7 @@ export function wsUrlFromBase(baseUrl: string): string {
}
/**
* Construit l'URL de la vue IDE web d'un worktree — deep-link vers la route `/workspace/:repoId/:wt`
* Construit l'URL de la vue IDE web d'un worktree : deep-link vers la route `/workspace/:repoId/:wt`
* (le routeur web est en history mode). `repoId` et le chemin du worktree sont encodés par segment.
*/
export function workspaceUrl(baseUrl: string, repoId: string, worktreePath: string): string {

2
packages/vscode/src/extension.ts
View File

@@ -93,7 +93,7 @@ export async function activate(context: vscode.ExtensionContext): Promise<void>
try {
await probe.me();
} catch (err) {
void vscode.window.showErrorMessage(`Arboretum: sign in failed — ${(err as Error).message}`);
void vscode.window.showErrorMessage(`Arboretum: sign in failed: ${(err as Error).message}`);
return;
}
await auth.storeToken(token);

2
packages/vscode/src/notifications.ts
View File

@@ -41,7 +41,7 @@ export class WaitingNotifier implements vscode.Disposable {
private notify(session: SessionSummary): void {
const title = session.title?.trim() || session.command;
const detail = session.waitingFor ? ` — ${session.waitingFor}` : '';
const detail = session.waitingFor ? ` · ${session.waitingFor}` : '';
void vscode.window
.showInformationMessage(`Arboretum: "${title}" is waiting for input${detail}`, 'Open Terminal', 'Yes', 'No')
.then((choice) => {

4
packages/vscode/src/state/store.ts
View File

@@ -1,4 +1,4 @@
// État mémoire de l'extension — module pur (aucun import vscode), testable.
// État mémoire de l'extension : module pur (aucun import vscode), testable.
// Seedé via REST au (re)connect, puis patché par les events WS. Émet onDidChange à chaque mutation ;
// les arbres / status bar / notifications s'y abonnent. Principe « groupe léger » : on ne corrèle pas
// les worktrees aux sessions via la liste embarquée (potentiellement périmée) mais par `cwd`, exactement
@@ -194,7 +194,7 @@ export class Store {
.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
}
/** sessions en attente d'input (activity === 'waiting') — pour la status bar et les notifications. */
/** sessions en attente d'input (activity === 'waiting') : pour la status bar et les notifications. */
waitingSessions(): SessionSummary[] {
return [...this.sessions.values()].filter((s) => s.live && s.activity === 'waiting');
}

2
packages/vscode/src/terminal/session-bridge.ts
View File

@@ -1,4 +1,4 @@
// Pont d'une session vers un terminal — module pur (aucun import vscode), testable.
// Pont d'une session vers un terminal : module pur (aucun import vscode), testable.
// Le ws-client remet des octets BRUTS (un chunk PTY peut couper un caractère UTF-8 en frontière de
// frame, exactement comme côté web où xterm.write(Uint8Array) gérait le décodage). Ici la cible est
// un Pseudoterminal qui veut des `string` → on décode en streaming avec un TextDecoder, et on recrée

6
packages/vscode/src/terminal/session-pty.ts
View File

@@ -1,5 +1,5 @@
// Adaptateur vscode.Pseudoterminal : expose une session Arboretum comme un terminal NATIF de VS Code
// (rendu, scrollback, copier/coller, liens gratuits). C'est la pièce maîtresse de l'intégration —
// (rendu, scrollback, copier/coller, liens gratuits). C'est la pièce maîtresse de l'intégration :
// pas de xterm-in-webview. Le pont WS/décodage vit dans SessionBridge (pur) ; cet adaptateur ne fait
// que relier les events Pseudoterminal ↔ bridge.
import * as vscode from 'vscode';
@@ -45,13 +45,13 @@ export class SessionTerminalManager {
},
onControlChanged: (controlling) => {
if (!controlling && mode === 'interactive') {
writeEmitter.fire('\r\n\x1b[33m[arboretum: control lost — now observing]\x1b[0m\r\n');
writeEmitter.fire('\r\n\x1b[33m[arboretum: control lost: now observing]\x1b[0m\r\n');
}
},
});
this.bridges.set(session.id, bridge);
bridge.open(dims?.columns ?? 80, dims?.rows ?? 24).catch((err: Error) => {
writeEmitter.fire(`\r\n\x1b[31m[arboretum: cannot attach — ${err.message}]\x1b[0m\r\n`);
writeEmitter.fire(`\r\n\x1b[31m[arboretum: cannot attach: ${err.message}]\x1b[0m\r\n`);
closeEmitter.fire();
});
},

4
packages/vscode/src/views/tree-items.ts
View File

@@ -94,12 +94,12 @@ function sessionDescription(s: SessionSummary): string {
if (s.archived) parts.push('archived');
if (s.source === 'discovered') parts.push('external');
if (s.groupId) parts.push('group');
if (s.waitingFor) parts.push(`— ${s.waitingFor}`);
if (s.waitingFor) parts.push(`· ${s.waitingFor}`);
return parts.join(' ');
}
function sessionTooltip(s: SessionSummary): string {
const lines = [`${s.command} — ${s.cwd}`, `status: ${s.status}${s.live ? ' (live)' : ''}`];
const lines = [`${s.command} · ${s.cwd}`, `status: ${s.status}${s.live ? ' (live)' : ''}`];
if (s.activity) lines.push(`activity: ${s.activity}`);
if (s.addedDirs && s.addedDirs.length > 0) lines.push(`added dirs: ${s.addedDirs.length}`);
return lines.join('\n');

2
packages/web/public/sw.js
View File

@@ -1,5 +1,5 @@
// Service worker Arboretum (P4-C) : Web Push + clic de notification.
// Volontairement minimal — pas de précache offline (hors périmètre P4) : son seul rôle est de
// Volontairement minimal, pas de précache offline (hors périmètre P4) : son seul rôle est de
// recevoir les push (session passée en `waiting`) et d'ouvrir/focus la vue session au clic.
self.addEventListener('push', (event) => {

2
packages/web/src/components/CommandPalette.vue
View File

@@ -157,7 +157,7 @@ watch(open, async (v) => {
}
});
// raccourci global ⌘K / Ctrl+K — en phase de capture pour passer devant xterm (SessionView).
// raccourci global ⌘K / Ctrl+K : en phase de capture pour passer devant xterm (SessionView).
function onKey(e: KeyboardEvent): void {
if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') {
e.preventDefault();

2
packages/web/src/components/DialogPrompt.vue
View File

@@ -28,7 +28,7 @@
<script setup lang="ts">
// P4-A : répondre à un dialogue Claude sans ouvrir le terminal. Le composant gère sa
// propre attache interactive LÉGÈRE (sink no-op, sans xterm), créée à la demande au
// premier clic et libérée au démontage — c'est ce qui réalise la réponse « mobile ».
// premier clic et libérée au démontage : c'est ce qui réalise la réponse « mobile ».
import { computed, onUnmounted } from 'vue';
import { useI18n } from 'vue-i18n';
import type { SessionSummary } from '@arboretum/shared';

4
packages/web/src/components/TerminalView.vue
View File

@@ -65,7 +65,7 @@ onMounted(async () => {
try {
const { WebglAddon } = await import('@xterm/addon-webgl');
const webgl = new WebglAddon();
// perte de contexte GPU : on dispose (retour au renderer DOM) PUIS on repeint — sinon l'écran
// perte de contexte GPU : on dispose (retour au renderer DOM) PUIS on repeint, sinon l'écran
// reste figé sur le dernier rendu WebGL jusqu'à la prochaine interaction (« texte qui ne s'affiche
// que si ça bouge »).
webgl.onContextLoss(() => {
@@ -132,7 +132,7 @@ onMounted(async () => {
resizeObserver = new ResizeObserver(refit);
resizeObserver.observe(container.value);
// Re-révélation RÉELLE du conteneur : cellule de grille démontée/remontée (maximize↔grille), scroll
// hors/dans le viewport, ou navigation SPA — autant de cas que `visibilitychange` (onglet only) ne
// hors/dans le viewport, ou navigation SPA : autant de cas que `visibilitychange` (onglet only) ne
// couvre PAS. Au retour visible, on repeint (le rendu était gelé hors-écran) ET on flushe l'ACK pour
// sortir d'une éventuelle pause serveur (le callback de xterm.write était throttlé tant que caché).
intersectionObserver = new IntersectionObserver((entries) => {

2
packages/web/src/components/WorktreeCard.vue
View File

@@ -191,7 +191,7 @@ async function onStart(): Promise<void> {
}
const branchLabel = computed(() =>
props.worktree.branch ?? (props.worktree.detached ? `${t('worktrees.detached')} ${props.worktree.head.slice(0, 7)}` : '—'),
props.worktree.branch ?? (props.worktree.detached ? `${t('worktrees.detached')} ${props.worktree.head.slice(0, 7)}` : '·'),
);
// --- actions git : commit / push / promotion en principal ---

2
packages/web/src/components/ui/EmptyState.vue
View File

@@ -10,7 +10,7 @@
</template>
<script setup lang="ts">
// État vide soigné (icône + titre + indice + CTA) — remplace les <p text-zinc-500> plats.
// État vide soigné (icône + titre + indice + CTA) : remplace les <p text-zinc-500> plats.
import type { Component } from 'vue';
defineProps<{ icon?: Component; title: string; hint?: string }>();

2
packages/web/src/components/workspace/FileTreeNode.vue
View File

@@ -47,7 +47,7 @@ const error = ref<string | null>(null);
const children = ref<FsEntry[]>([]);
let loaded = false;
// chemin relatif au worktree (POSIX) — clé utilisée par l'API fichiers / diff.
// chemin relatif au worktree (POSIX) : clé utilisée par l'API fichiers / diff.
const relPath = computed(() => (props.entry.path.startsWith(props.wt) ? props.entry.path.slice(props.wt.length + 1) : props.entry.name));
const isActive = computed(() => props.entry.isFile && props.active === relPath.value);

2
packages/web/src/composables/useDebouncedRef.ts
View File

@@ -2,7 +2,7 @@ import { ref, watch, onUnmounted, getCurrentInstance, type Ref } from 'vue';
/**
* Renvoie un miroir débouncé d'un ref source. Le ref source reste instantané (idéal pour un
* v-model d'input) ; le miroir ne se met à jour qu'après `delay` ms de stabilité — c'est lui
* v-model d'input) ; le miroir ne se met à jour qu'après `delay` ms de stabilité : c'est lui
* que le pipeline de tri/filtre consomme, pour ne pas recalculer à chaque frappe.
*/
export function useDebouncedRef<T>(source: Ref<T>, delay = 150): Ref<T> {

2
packages/web/src/composables/useListControls.ts
View File

@@ -38,7 +38,7 @@ export interface ListControlsOptions<T> {
urlKey?: string;
}
/** Sous-ensemble consommé par ListToolbar (sans pagination) — implémentable aussi par un store partagé. */
/** Sous-ensemble consommé par ListToolbar (sans pagination) : implémentable aussi par un store partagé. */
export interface ListToolbarControls<T> {
search: Ref<string>;
sortKey: Ref<string>;

2
packages/web/src/composables/useWorktreeView.ts
View File

@@ -12,7 +12,7 @@ export interface WorktreeView extends ListToolbarControls<WorktreeSummary> {
/**
* État de tri/filtre/recherche des worktrees, PARTAGÉ entre toutes les RepoSection du dashboard
* (une seule toolbar pilote toutes les sections). Singleton module-level — et non un store Pinia,
* (une seule toolbar pilote toutes les sections). Singleton module-level, et non un store Pinia,
* car Pinia déballe les refs, ce que ListToolbar attend justement comme refs. Pas de pagination
* (liste groupée par repo) ; `apply()` filtre+trie le sous-ensemble d'un repo donné.
*/

40
packages/web/src/i18n/en.ts
View File

@@ -21,13 +21,13 @@ export default {
submit: 'Sign in',
submitting: 'Signing in…',
invalidToken: 'Invalid token',
rateLimited: 'Too many attempts — please wait before retrying',
rateLimited: 'Too many attempts. Please wait before retrying',
genericError: 'Sign-in failed ({status})',
},
sessions: {
title: 'Sessions',
refresh: 'Refresh',
empty: 'No sessions yet — start one below.',
empty: 'No sessions yet. Start one below.',
newSession: 'New session',
cwdLabel: 'Working directory',
cwdPlaceholder: '/absolute/path/to/project',
@@ -91,10 +91,10 @@ export default {
namePlaceholder: 'e.g. Payments stack',
colorLabel: 'Color',
reposLabel: 'Repositories',
empty: 'No group yet — create one above.',
empty: 'No group yet. Create one above.',
noRepos: 'No repository selected.',
noReposInGroup: 'No repository in this group yet — add some below.',
noReposRegistered: 'No repository registered yet — add some from the dashboard first.',
noReposInGroup: 'No repository in this group yet. Add some below.',
noReposRegistered: 'No repository registered yet. Add some from the dashboard first.',
open: 'Open',
edit: 'Edit repositories',
editDone: 'Done',
@@ -108,13 +108,13 @@ export default {
viewList: 'Repos',
viewGrid: 'Terminals',
gridEmpty: 'No active session in this group.',
gridCapped: 'Showing {shown} of {total} sessions — close some terminals to see the rest.',
gridCapped: 'Showing {shown} of {total} sessions. Close some terminals to see the rest.',
newFeature: 'New group session',
spanBadge: 'group · {n} repo | group · {n} repos',
},
crossRepo: {
title: 'New group session',
intro: 'Launch one Claude session that spans every repo in this group — a single conversation across all of them.',
intro: 'Launch one Claude session that spans every repo in this group: a single conversation across all of them.',
modeLabel: 'Directories',
modeFeature: 'New branch in each repo',
modeMain: 'Main checkouts',
@@ -140,7 +140,7 @@ export default {
remove: 'Remove',
pathLabel: 'Repository path',
pathPlaceholder: '/absolute/path/to/repo',
empty: 'No repository registered yet — add one above, or scan for repos.',
empty: 'No repository registered yet. Add one above, or scan for repos.',
invalid: 'unavailable',
scan: 'Scan',
scanResult: 'No new repository found | 1 new repository added | {n} new repositories added',
@@ -209,7 +209,7 @@ export default {
files: 'Files',
changes: 'Changes',
noChanges: 'No changes',
changesTruncated: 'Too many changes — list truncated.',
changesTruncated: 'Too many changes. List truncated.',
terminal: 'Terminal',
editor: 'Editor',
diff: 'Diff',
@@ -226,7 +226,7 @@ export default {
overwrite: 'Overwrite',
},
diff: {
binary: 'Binary file — no text diff.',
binary: 'Binary file. No text diff.',
tooLarge: 'Diff too large to display.',
noChanges: 'No changes in this file.',
},
@@ -304,7 +304,7 @@ export default {
observer: 'observer (read-only)',
sessionEnded: 'Session ended',
back: 'Sessions',
notAttachable: 'This session runs outside Arboretum — fork it to interact, or resume it once it has stopped.',
notAttachable: 'This session runs outside Arboretum. Fork it to interact, or resume it once it has stopped.',
fullscreen: 'Fullscreen',
exitFullscreen: 'Exit fullscreen',
maximize: 'Maximize',
@@ -316,7 +316,7 @@ export default {
push: {
enable: 'Enable notifications',
disable: 'Notifications on',
denied: 'Notification permission denied — enable it in your browser settings.',
denied: 'Notification permission denied. Enable it in your browser settings.',
unsupported: 'Push needs HTTPS (e.g. Tailscale Serve); on iOS, install the app to your home screen first.',
},
fs: {
@@ -329,7 +329,7 @@ export default {
repoBadge: 'repo',
},
ws: {
reconnecting: 'Connection lost — reconnecting…',
reconnecting: 'Connection lost. Reconnecting…',
},
nav: {
worktrees: 'Worktrees',
@@ -473,7 +473,7 @@ export default {
preferencesHint: 'These apply to this browser only.',
language: 'Language',
notifications: 'Notifications',
notificationsEnabled: 'Enabled — you will be notified when a session needs input.',
notificationsEnabled: 'Enabled. You will be notified when a session needs input.',
notificationsDisabled: 'Disabled.',
enableNotifications: 'Enable notifications',
disableNotifications: 'Disable notifications',
@@ -488,7 +488,7 @@ export default {
newTokenPlaceholder: 'e.g. phone, laptop',
createToken: 'Create token',
tokenCreated: 'Token created',
copyTokenHint: 'Copy this token now — for security it will never be shown again.',
copyTokenHint: 'Copy this token now. For security it will never be shown again.',
copy: 'Copy',
copied: 'Copied',
current: 'current',
@@ -498,7 +498,7 @@ export default {
revoke: 'Revoke',
confirmRevoke: 'Confirm revoke',
tokenRevoked: 'Token revoked',
lastTokenError: 'You cannot revoke the last active token — create another one first.',
lastTokenError: 'You cannot revoke the last active token. Create another one first.',
save: 'Save',
saved: 'Saved',
// Sécurité & conformité
@@ -513,21 +513,21 @@ export default {
discovery: 'Repository discovery',
discoveryHint: 'Arboretum scans these folders for git repositories and registers them automatically. Hidden repos are kept and never re-added.',
scanRoots: 'Scan folders',
scanRootsEmpty: 'No folder configured — your home directory is used by default.',
scanRootsEmpty: 'No folder configured. Your home directory is used by default.',
addRoot: 'Add folder',
removeRoot: 'Remove',
scanInterval: 'Re-scan interval (minutes)',
scanIntervalHint: '0 disables periodic scanning. Changes apply on the next daemon restart.',
// Sessions (rétention / archivage auto)
sessions: 'Sessions',
sessionsHint: 'Finished sessions older than the retention window are automatically archived (hidden from the list by default). Nothing is deleted — archived sessions stay resumable and forkable.',
sessionsHint: 'Finished sessions older than the retention window are automatically archived (hidden from the list by default). Nothing is deleted. Archived sessions stay resumable and forkable.',
retentionDays: 'Auto-archive after (days)',
retentionDaysHint: '0 never archives. Archived sessions are hidden by default; toggle "Show archived" in the sessions list to see them.',
// Claude CLI
claudeCli: 'Claude CLI',
claudeCliHint: 'Where Arboretum finds the `claude` binary and its data. Handy when the daemon runs as a service with a minimal PATH that does not include ~/.local/bin.',
claudeBinStatusOk: 'Detected',
claudeBinStatusNotFound: 'Not found — sessions cannot start until this is resolved.',
claudeBinStatusNotFound: 'Not found. Sessions cannot start until this is resolved.',
claudeBinStatusBadPath: 'The configured path is not an executable file.',
claudeBinSourceConfigured: 'configured',
claudeBinSourcePath: 'PATH',
@@ -539,7 +539,7 @@ export default {
claudeHomePlaceholder: 'e.g. /home/you/.claude',
// Serveur (lecture seule)
server: 'Server',
serverHint: 'Set at startup via CLI flags — changing them requires restarting the daemon.',
serverHint: 'Set at startup via CLI flags. Changing them requires restarting the daemon.',
version: 'Version',
port: 'Port',
bind: 'Bind address',

40
packages/web/src/i18n/fr.ts
View File

@@ -23,13 +23,13 @@ const fr: typeof en = {
submit: 'Se connecter',
submitting: 'Connexion…',
invalidToken: 'Jeton invalide',
rateLimited: 'Trop de tentatives — patientez avant de réessayer',
rateLimited: 'Trop de tentatives. Patientez avant de réessayer',
genericError: 'Échec de la connexion ({status})',
},
sessions: {
title: 'Sessions',
refresh: 'Rafraîchir',
empty: 'Aucune session — démarrez-en une ci-dessous.',
empty: 'Aucune session. Démarrez-en une ci-dessous.',
newSession: 'Nouvelle session',
cwdLabel: 'Répertoire de travail',
cwdPlaceholder: '/chemin/absolu/du/projet',
@@ -93,10 +93,10 @@ const fr: typeof en = {
namePlaceholder: 'ex. Stack paiements',
colorLabel: 'Couleur',
reposLabel: 'Dépôts',
empty: 'Aucun groupe — créez-en un ci-dessus.',
empty: 'Aucun groupe. Créez-en un ci-dessus.',
noRepos: 'Aucun dépôt sélectionné.',
noReposInGroup: 'Aucun dépôt dans ce groupe — ajoutez-en ci-dessous.',
noReposRegistered: 'Aucun dépôt enregistré — ajoutez-en d’abord depuis le tableau de bord.',
noReposInGroup: 'Aucun dépôt dans ce groupe. Ajoutez-en ci-dessous.',
noReposRegistered: 'Aucun dépôt enregistré. Ajoutez-en d’abord depuis le tableau de bord.',
open: 'Ouvrir',
edit: 'Modifier les dépôts',
editDone: 'Terminé',
@@ -110,13 +110,13 @@ const fr: typeof en = {
viewList: 'Dépôts',
viewGrid: 'Terminaux',
gridEmpty: 'Aucune session active dans ce groupe.',
gridCapped: '{shown} sessions affichées sur {total} — fermez des terminaux pour voir le reste.',
gridCapped: '{shown} sessions affichées sur {total}. Fermez des terminaux pour voir le reste.',
newFeature: 'Nouvelle session de groupe',
spanBadge: 'groupe · {n} dépôt | groupe · {n} dépôts',
},
crossRepo: {
title: 'Nouvelle session de groupe',
intro: 'Lance UNE session Claude couvrant tous les dépôts du groupe — une seule conversation reliant l’ensemble.',
intro: 'Lance UNE session Claude couvrant tous les dépôts du groupe : une seule conversation reliant l’ensemble.',
modeLabel: 'Répertoires',
modeFeature: 'Nouvelle branche dans chaque dépôt',
modeMain: 'Checkouts principaux',
@@ -142,7 +142,7 @@ const fr: typeof en = {
remove: 'Retirer',
pathLabel: 'Chemin du dépôt',
pathPlaceholder: '/chemin/absolu/du/repo',
empty: 'Aucun dépôt enregistré — ajoutez-en un ci-dessus, ou lancez un scan.',
empty: 'Aucun dépôt enregistré. Ajoutez-en un ci-dessus, ou lancez un scan.',
invalid: 'indisponible',
scan: 'Scanner',
scanResult: 'Aucun nouveau dépôt trouvé | 1 nouveau dépôt ajouté | {n} nouveaux dépôts ajoutés',
@@ -211,7 +211,7 @@ const fr: typeof en = {
files: 'Fichiers',
changes: 'Changements',
noChanges: 'Aucun changement',
changesTruncated: 'Trop de changements — liste tronquée.',
changesTruncated: 'Trop de changements. Liste tronquée.',
terminal: 'Terminal',
editor: 'Éditeur',
diff: 'Diff',
@@ -228,7 +228,7 @@ const fr: typeof en = {
overwrite: 'Écraser',
},
diff: {
binary: 'Fichier binaire — pas de diff texte.',
binary: 'Fichier binaire. Pas de diff texte.',
tooLarge: 'Diff trop volumineux à afficher.',
noChanges: 'Aucun changement dans ce fichier.',
},
@@ -307,7 +307,7 @@ const fr: typeof en = {
sessionEnded: 'Session terminée',
back: 'Sessions',
notAttachable:
'Cette session tourne hors d’Arboretum — dupliquez-la pour interagir, ou reprenez-la une fois arrêtée.',
'Cette session tourne hors d’Arboretum. Dupliquez-la pour interagir, ou reprenez-la une fois arrêtée.',
fullscreen: 'Plein écran',
exitFullscreen: 'Quitter le plein écran',
maximize: 'Agrandir',
@@ -319,7 +319,7 @@ const fr: typeof en = {
push: {
enable: 'Activer les notifications',
disable: 'Notifications activées',
denied: 'Permission de notification refusée — activez-la dans les réglages du navigateur.',
denied: 'Permission de notification refusée. Activez-la dans les réglages du navigateur.',
unsupported: 'Le push nécessite HTTPS (ex. Tailscale Serve) ; sur iOS, installez d’abord l’app sur l’écran d’accueil.',
},
fs: {
@@ -332,7 +332,7 @@ const fr: typeof en = {
repoBadge: 'dépôt',
},
ws: {
reconnecting: 'Connexion perdue — reconnexion…',
reconnecting: 'Connexion perdue. Reconnexion…',
},
nav: {
worktrees: 'Worktrees',
@@ -476,7 +476,7 @@ const fr: typeof en = {
preferencesHint: 'Ces réglages ne s’appliquent qu’à ce navigateur.',
language: 'Langue',
notifications: 'Notifications',
notificationsEnabled: 'Activées — vous serez notifié lorsqu’une session attend une réponse.',
notificationsEnabled: 'Activées. Vous serez notifié lorsqu’une session attend une réponse.',
notificationsDisabled: 'Désactivées.',
enableNotifications: 'Activer les notifications',
disableNotifications: 'Désactiver les notifications',
@@ -491,7 +491,7 @@ const fr: typeof en = {
newTokenPlaceholder: 'ex. téléphone, portable',
createToken: 'Créer un jeton',
tokenCreated: 'Jeton créé',
copyTokenHint: 'Copiez ce jeton maintenant — par sécurité il ne sera plus jamais affiché.',
copyTokenHint: 'Copiez ce jeton maintenant. Par sécurité il ne sera plus jamais affiché.',
copy: 'Copier',
copied: 'Copié',
current: 'courant',
@@ -501,7 +501,7 @@ const fr: typeof en = {
revoke: 'Révoquer',
confirmRevoke: 'Confirmer la révocation',
tokenRevoked: 'Jeton révoqué',
lastTokenError: 'Impossible de révoquer le dernier jeton actif — créez-en un autre d’abord.',
lastTokenError: 'Impossible de révoquer le dernier jeton actif. Créez-en un autre d’abord.',
save: 'Enregistrer',
saved: 'Enregistré',
// Sécurité & conformité
@@ -516,21 +516,21 @@ const fr: typeof en = {
discovery: 'Découverte des dépôts',
discoveryHint: 'Arboretum scanne ces dossiers à la recherche de dépôts git et les enregistre automatiquement. Les dépôts masqués sont conservés et jamais ré-ajoutés.',
scanRoots: 'Dossiers à scanner',
scanRootsEmpty: 'Aucun dossier configuré — votre dossier personnel est utilisé par défaut.',
scanRootsEmpty: 'Aucun dossier configuré. Votre dossier personnel est utilisé par défaut.',
addRoot: 'Ajouter un dossier',
removeRoot: 'Retirer',
scanInterval: 'Intervalle de re-scan (minutes)',
scanIntervalHint: '0 désactive le scan périodique. Les changements prennent effet au prochain redémarrage du daemon.',
// Sessions (rétention / archivage auto)
sessions: 'Sessions',
sessionsHint: 'Les sessions terminées plus anciennes que la fenêtre de rétention sont archivées automatiquement (masquées de la liste par défaut). Rien n’est supprimé — une session archivée reste reprenable et forkable.',
sessionsHint: 'Les sessions terminées plus anciennes que la fenêtre de rétention sont archivées automatiquement (masquées de la liste par défaut). Rien n’est supprimé. Une session archivée reste reprenable et forkable.',
retentionDays: 'Auto-archiver après (jours)',
retentionDaysHint: '0 n’archive jamais. Les sessions archivées sont masquées par défaut ; activez « Afficher les archivées » dans la liste pour les voir.',
// Claude CLI
claudeCli: 'CLI Claude',
claudeCliHint: 'Où Arboretum trouve le binaire `claude` et ses données. Utile quand le daemon tourne en service avec un PATH minimal qui n’inclut pas ~/.local/bin.',
claudeBinStatusOk: 'Détecté',
claudeBinStatusNotFound: 'Introuvable — impossible de lancer une session tant que ce n’est pas résolu.',
claudeBinStatusNotFound: 'Introuvable. Impossible de lancer une session tant que ce n’est pas résolu.',
claudeBinStatusBadPath: 'Le chemin configuré n’est pas un fichier exécutable.',
claudeBinSourceConfigured: 'configuré',
claudeBinSourcePath: 'PATH',
@@ -542,7 +542,7 @@ const fr: typeof en = {
claudeHomePlaceholder: 'ex. /home/vous/.claude',
// Serveur (lecture seule)
server: 'Serveur',
serverHint: 'Définis au démarrage via des flags CLI — les modifier nécessite de redémarrer le daemon.',
serverHint: 'Définis au démarrage via des flags CLI. Les modifier nécessite de redémarrer le daemon.',
version: 'Version',
port: 'Port',
bind: 'Adresse de liaison',

2
packages/web/src/lib/monaco-setup.ts
View File

@@ -2,7 +2,7 @@
// (cf. composables/useMonaco) → chunk séparé, zéro impact sur le bundle initial.
// Workers via Vite (?worker) : on ne fournit que le worker de base. La colorisation syntaxique
// (Monarch) tourne sur le thread principal et ne dépend d'aucun worker ; les services de langage
// avancés (TS/JSON) dégradent proprement — suffisant pour éditer + sauver dans le navigateur.
// avancés (TS/JSON) dégradent proprement : suffisant pour éditer + sauver dans le navigateur.
import * as monaco from 'monaco-editor';
import EditorWorker from 'monaco-editor/esm/vs/editor/editor.worker?worker';

24
packages/web/src/lib/ws-client.ts
View File

@@ -1,4 +1,4 @@
// Client WebSocket multiplexé — UNE seule connexion pour toute l'app.
// Client WebSocket multiplexé : UNE seule connexion pour toute l'app.
// Handshake hello/hello_ok, reconnexion avec backoff (ré-attache des terminaux
// ouverts + re-sub), corrélation FIFO des 'attached', flow control par ACK
// (cumul d'octets traités PAR CANAL, remis à zéro à chaque RESYNC).
@@ -29,11 +29,11 @@ export interface TerminalSink {
export type SessionEvent = Extract<ServerMessage, { type: 'session_update' | 'session_exit' | 'session_archived' }>;
export type WorktreeEvent = Extract<ServerMessage, { type: 'repo_update' | 'repo_removed' | 'worktree_update' | 'worktree_removed' }>;
export type GroupEvent = Extract<ServerMessage, { type: 'group_update' | 'group_removed' }>;
/** P11 — un réglage a changé (diffusé au topic 'settings'). */
/** P11 : un réglage a changé (diffusé au topic 'settings'). */
export type SettingsUpdateEvent = Extract<ServerMessage, { type: 'settings_update' }>;
/** P12 — progression/fin d'un clone (diffusée au topic 'clones'). */
/** P12 : progression/fin d'un clone (diffusée au topic 'clones'). */
export type CloneEvent = Extract<ServerMessage, { type: 'clone_update' }>;
/** P7 — signal ciblé « le détail (changes/diff) d'un worktree regardé a changé ». */
/** P7 : signal ciblé « le détail (changes/diff) d'un worktree regardé a changé ». */
export type WorktreeChangesEvent = Extract<ServerMessage, { type: 'worktree_changes' }>;
export interface AttachOptions {
@@ -48,7 +48,7 @@ const BACKOFF_MIN_MS = 500;
const BACKOFF_MAX_MS = 10_000;
export class Attachment {
/** canal courant — réassigné à chaque reconnexion, -1 tant que non attaché */
/** canal courant : réassigné à chaque reconnexion, -1 tant que non attaché */
channel = -1;
controlling = false;
closed = false;
@@ -133,7 +133,7 @@ export class WsClient {
private readonly groupListeners = new Set<(e: GroupEvent) => void>();
private readonly settingsListeners = new Set<(e: SettingsUpdateEvent) => void>();
private readonly cloneListeners = new Set<(e: CloneEvent) => void>();
/** P7 — abonnements ciblés au détail d'un worktree (clé repoId\0path → listeners). */
/** P7 : abonnements ciblés au détail d'un worktree (clé repoId\0path → listeners). */
private readonly worktreeChangesListeners = new Map<string, Set<(e: WorktreeChangesEvent) => void>>();
connect(): void {
@@ -248,7 +248,7 @@ export class WsClient {
}
/**
* P7 — observe le détail (changes/diff) d'un worktree précis : envoie `watch`, route les
* P7 : observe le détail (changes/diff) d'un worktree précis : envoie `watch`, route les
* `worktree_changes` correspondants vers `listener`, et ré-arme automatiquement après reconnexion.
* La désinscription envoie `unwatch` quand plus aucun listener ne regarde ce worktree.
*/
@@ -418,13 +418,13 @@ export class WsClient {
}, 200);
}
/** ACK immédiat du reliquat traité pour tous les terminaux ouverts — au retour en avant-plan,
/** ACK immédiat du reliquat traité pour tous les terminaux ouverts : au retour en avant-plan,
* pour rattraper sans attendre le débounce un serveur éventuellement en pause. */
private flushAcks(): void {
for (const att of this.attachments) this.flushAttachmentAck(att);
}
/** ACK immédiat du reliquat traité d'UN attachment — n'ACK que du réellement traité (invariant
/** ACK immédiat du reliquat traité d'UN attachment : n'ACK que du réellement traité (invariant
* préservé). Factorisé : utilisé par flushAcks() et par le flush ciblé flushAck(). */
private flushAttachmentAck(att: Attachment): void {
if (att.closed || att.channel < 0) return;
@@ -447,7 +447,7 @@ export class WsClient {
this.backoffMs = BACKOFF_MIN_MS;
this.status.value = 'open';
this.sendSub();
// P7 — ré-arme les watchers de worktree (clé repoId\0path) après reconnexion.
// P7 : ré-arme les watchers de worktree (clé repoId\0path) après reconnexion.
for (const key of this.worktreeChangesListeners.keys()) {
const sep = key.indexOf('\0');
this.sendControl({ type: 'watch', repoId: key.slice(0, sep), path: key.slice(sep + 1) });
@@ -530,7 +530,7 @@ export class WsClient {
}
case 'error': {
if (msg.channel !== undefined) {
console.warn(`[ws] channel ${msg.channel}: ${msg.code} — ${msg.message}`);
console.warn(`[ws] channel ${msg.channel}: ${msg.code}: ${msg.message}`);
return;
}
// un échec d'attach est la seule erreur sans canal corrélable à une requête
@@ -547,7 +547,7 @@ export class WsClient {
}
return;
}
console.warn(`[ws] ${msg.code} — ${msg.message}`);
console.warn(`[ws] ${msg.code}: ${msg.message}`);
return;
}
case 'pong':

2
packages/web/src/router/index.ts
View File

@@ -3,7 +3,7 @@ import { useAuthStore } from '../stores/auth';
// Type du layout choisi par App.vue : 'bare' (login, sans coquille),
// 'shell' (sidebar + contenu centré), 'fullbleed' (terminal plein écran dans la coquille),
// 'ide' (vue Workspace plein écran SANS coquille — gère son propre layout 3 panneaux).
// 'ide' (vue Workspace plein écran SANS coquille : gère son propre layout 3 panneaux).
declare module 'vue-router' {
interface RouteMeta {
layout?: 'bare' | 'shell' | 'fullbleed' | 'ide';

4
packages/web/src/stores/groups.ts
View File

@@ -138,8 +138,8 @@ export const useGroupsStore = defineStore('groups', () => {
/**
* Lance une session de groupe reliant tous les repos (P6). En mode « feature » (branch fournie),
* crée d'abord le même worktree de branche dans chaque repo — orchestration côté client tolérante
* aux échecs partiels, feedback par repo — PUIS une seule session couvrant ces worktrees. En mode
* crée d'abord le même worktree de branche dans chaque repo : orchestration côté client tolérante
* aux échecs partiels, feedback par repo, PUIS une seule session couvrant ces worktrees. En mode
* « checkouts principaux » (sans branch), la session couvre directement le worktree principal de chaque repo.
*/
async function createGroupFeature(

2
packages/web/src/stores/sessions.ts
View File

@@ -159,7 +159,7 @@ export const useSessionsStore = defineStore('sessions', () => {
return res.session;
}
// Fork d'une session (vivante ou morte) — ne corrompt jamais l'originale.
// Fork d'une session (vivante ou morte) : ne corrompt jamais l'originale.
async function forkSession(id: string): Promise<SessionSummary> {
const res = await api.post<SessionResponse>(`/api/v1/sessions/${id}/fork`);
upsert(res.session);

2
packages/web/src/stores/settings.ts
View File

@@ -34,7 +34,7 @@ export const useSettingsStore = defineStore('settings', () => {
loaded.value = true;
}
// P11 — temps réel : un PATCH /settings d'un autre client/onglet rafraîchit le store ici.
// P11, temps réel : un PATCH /settings d'un autre client/onglet rafraîchit le store ici.
function startRealtime(): void {
unsubscribe ??= wsClient.subscribeSettings((e) => applySettings(e.settings));
}

2
packages/web/src/views/SessionView.vue
View File

@@ -52,7 +52,7 @@ const session = computed(() => store.sessions.find((s) => s.id === sessionId.val
// défaut true : une navigation directe (liste pas encore chargée) tente l'attache d'une session managée.
const attachable = computed(() => session.value?.attachable ?? true);
// Vrai plein écran (API Fullscreen) — surtout utile sur mobile pour récupérer la barre d'URL.
// Vrai plein écran (API Fullscreen) : surtout utile sur mobile pour récupérer la barre d'URL.
// On synchronise `isFullscreen` sur l'événement natif : l'utilisateur peut sortir via Échap.
const root = useTemplateRef<HTMLDivElement>('root');
const isFullscreen = ref(false);

2
packages/web/src/views/SettingsView.vue
View File

@@ -474,7 +474,7 @@ async function deleteMyData(): Promise<void> {
}
}
// P11 — un settings_update WS (autre onglet/client) re-synchronise un draft SCALAIRE uniquement
// P11 : un settings_update WS (autre onglet/client) re-synchronise un draft SCALAIRE uniquement
// s'il n'a pas été modifié localement (le draft valait encore l'ancienne valeur du store) → on
// n'écrase jamais une saisie en cours.
watch(() => settings.scanIntervalMin, (n, o) => { if (intervalDraft.value === o) intervalDraft.value = n; });

Some files were not shown because too many files have changed in this diff Show More