@indos/bibliotheque 4.2.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/CLAUDE.md +154 -153
  2. package/README.md +2 -2
  3. package/bin/bibliotheque.d.ts +1 -0
  4. package/bin/bibliotheque.js +63 -0
  5. package/bin/page-de-l-espace.js +2 -2
  6. package/manifeste.json +5 -0
  7. package/modeles/app-du-client/.github/workflows/publier-l-image.yml +31 -0
  8. package/modeles/app-du-client/DOCUMENTATION.md +27 -0
  9. package/modeles/app-du-client/Dockerfile +34 -0
  10. package/modeles/app-du-client/Dockerfile.dockerignore +3 -0
  11. package/modeles/app-du-client/GUIDE.md +3 -0
  12. package/modeles/app-du-client/README.md +47 -0
  13. package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
  14. package/modeles/app-du-client/espace/index.html +9 -0
  15. package/modeles/app-du-client/espace/page.tsx +6 -0
  16. package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
  17. package/modeles/app-du-client/espace/routes.ts +12 -0
  18. package/modeles/app-du-client/espace/tsconfig.json +7 -0
  19. package/modeles/app-du-client/essai/poser.sql +6 -0
  20. package/modeles/app-du-client/logo.svg +1 -0
  21. package/modeles/app-du-client/manifeste.json +12 -0
  22. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
  23. package/modeles/app-du-client/package.json +20 -0
  24. package/modeles/app-du-client/src/demarrer.ts +17 -0
  25. package/modeles/app-du-client/src/outils.ts +52 -0
  26. package/modeles/app-du-client/src/serveur.ts +46 -0
  27. package/modeles/app-du-client/tests/espace/entrees.test.tsx +58 -0
  28. package/modeles/app-du-client/tests/serveur.test.ts +112 -0
  29. package/modeles/app-du-client/tsconfig.json +22 -0
  30. package/package.json +3 -2
  31. package/src/app.js +4 -4
  32. package/src/appeler.js +1 -1
  33. package/src/base-d-essai.d.ts +3 -0
  34. package/src/base-d-essai.js +17 -1
  35. package/src/faux-core.js +10 -10
  36. package/src/flux.js +1 -1
  37. package/src/liens.js +1 -1
  38. package/src/mcp.d.ts +3 -0
  39. package/src/mcp.js +20 -2
  40. package/src/partage.js +6 -7
  41. package/src/session.js +3 -4
  42. package/src/theme.js +1 -1
  43. package/src/vite.js +33 -22
@@ -0,0 +1,63 @@
1
+ #!/usr/bin/env node
2
+ // La commande de la bibliothèque, lancée à la racine du dépôt d'un OS (ou de son worktree ;
3
+ // bibliotheque/CLAUDE.md, « Une app du client ») par le paquet publié :
4
+ //
5
+ // npx --package @indos/bibliotheque@<version> bibliotheque creer-une-app <nom>
6
+ //
7
+ // copie le modèle d'une app (`bibliotheque/modeles/app-du-client/`) dans `code/<nom>/`, où l'app
8
+ // sera le clone de son propre dépôt : le `nom` posé dans `manifeste.json`, dans les liens de
9
+ // `DOCUMENTATION.md` et à la place de chaque `<nom>` du `README.md`, et la bibliothèque citée dans
10
+ // `package.json` au paquet `@indos/bibliotheque` à la version de son manifeste (`bibliotheque/manifeste.json`). La
11
+ // commande refuse un nom qui n'est pas en minuscules, chiffres et tirets, et un dossier qui existe. Elle
12
+ // n'importe que les modules de Node : elle se lance avant toute installation.
13
+ import { cpSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
14
+ import { join } from 'node:path';
15
+ import { fileURLToPath } from 'node:url';
16
+ // Le nom d'une app, comme le kit le demande dans `os.json` : son chemin, `/<nom>`.
17
+ const NOM = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
18
+ const NOM_DU_MODELE = 'app-du-client';
19
+ const USAGE = 'Usage, à la racine du dépôt de l\'OS : npx --package @indos/bibliotheque@<version> bibliotheque creer-une-app <nom>';
20
+ // Le dossier de la bibliothèque, et la racine du dépôt, celle où la commande se lance.
21
+ const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
22
+ const racine = process.cwd();
23
+ function refuser(message) {
24
+ console.error(message);
25
+ process.exit(1);
26
+ }
27
+ // Remplace chaque occurrence de `avant` dans le fichier.
28
+ function remplacer(chemin, avant, apres) {
29
+ writeFileSync(chemin, readFileSync(chemin, 'utf8').replaceAll(avant, apres));
30
+ }
31
+ function creerUneApp(nom) {
32
+ if (!nom) {
33
+ refuser(USAGE);
34
+ }
35
+ if (!NOM.test(nom)) {
36
+ refuser(`Refusé : « ${nom} » n'est pas un nom d'app : des minuscules, des chiffres et des tirets, une lettre d'abord.`);
37
+ }
38
+ const manifeste = join(bibliotheque, 'manifeste.json');
39
+ const { version } = JSON.parse(readFileSync(manifeste, 'utf8'));
40
+ if (!version) {
41
+ refuser(`Refusé : ${manifeste} ne dit pas la version de la bibliothèque.`);
42
+ }
43
+ const dossier = join(racine, 'code', nom);
44
+ if (existsSync(dossier)) {
45
+ refuser(`Refusé : ${dossier} existe déjà. L'app se crée dans un dossier neuf.`);
46
+ }
47
+ cpSync(join(bibliotheque, 'modeles', NOM_DU_MODELE), dossier, { recursive: true });
48
+ remplacer(join(dossier, 'manifeste.json'), `"nom": "${NOM_DU_MODELE}"`, `"nom": "${nom}"`);
49
+ const paquet = JSON.parse(readFileSync(join(dossier, 'package.json'), 'utf8'));
50
+ paquet.dependencies['@indos/bibliotheque'] = version;
51
+ writeFileSync(join(dossier, 'package.json'), `${JSON.stringify(paquet, null, 2)}\n`);
52
+ remplacer(join(dossier, 'DOCUMENTATION.md'), `](/${NOM_DU_MODELE}/`, `](/${nom}/`);
53
+ remplacer(join(dossier, 'README.md'), '<nom>', nom);
54
+ console.log(`L'app ${nom} est créée dans code/${nom}, avec @indos/bibliotheque ${version}.`);
55
+ console.log(`La suite : npm install et npm test dans code/${nom}. Son README.md dit le reste.`);
56
+ }
57
+ const [commande, ...arguments_] = process.argv.slice(2);
58
+ if (commande === 'creer-une-app' && arguments_.length <= 1) {
59
+ creerUneApp(arguments_[0]);
60
+ }
61
+ else {
62
+ refuser(USAGE);
63
+ }
@@ -4,8 +4,8 @@
4
4
  // `node_modules` (`node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts <commande>`) :
5
5
  // - `construire` (`npm run build`) écrit le dossier construit, `dist/` ;
6
6
  // - `developper` (`npm run dev`) la sert à chaud sur http://localhost:<port>, le port de
7
- // `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE` et, pour une app, à l'app lancée
8
- // en local à `INDOS_APP`, à l'écoute de `INDOS_HOTE` (localhost par défaut, `0.0.0.0` dans un conteneur) ;
7
+ // `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE` (pour le core, le core lancé en
8
+ // local) et, pour une app, à l'app lancée en local à `INDOS_APP`, à l'écoute de `INDOS_HOTE` (localhost par défaut, `0.0.0.0` dans un conteneur) ;
9
9
  // - `tester` lance ses tests de Vitest, `tests/espace/**/*.test.tsx`.
10
10
  import { construireLaPage, developperLaPage, portDeDeveloppement, testerLaPage } from '../src/vite.js';
11
11
  const [commande] = process.argv.slice(2);
package/manifeste.json ADDED
@@ -0,0 +1,5 @@
1
+ {
2
+ "nom": "bibliotheque",
3
+ "version": "4.4.0",
4
+ "dependances": {}
5
+ }
@@ -0,0 +1,31 @@
1
+ # L'image de l'app à chaque commit de main : construite sur le dépôt, ses tests compris (le Dockerfile
2
+ # les lance), pour la plateforme du serveur, puis poussée dans l'entrepôt GitHub du dépôt,
3
+ # ghcr.io/<compte>/<dépôt>:<commit>, d'où le serveur la tire à la publication (par le kit). Le jeton de GitHub de l'exécution suffit : aucun secret.
4
+ name: Publier l'image
5
+
6
+ on:
7
+ push:
8
+ branches: [main]
9
+
10
+ permissions:
11
+ contents: read
12
+ packages: write
13
+
14
+ jobs:
15
+ image:
16
+ name: Construire et pousser l'image
17
+ runs-on: ubuntu-24.04
18
+ timeout-minutes: 30
19
+ steps:
20
+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
21
+ with:
22
+ persist-credentials: false
23
+ - name: L'image, dans l'entrepôt GitHub
24
+ env:
25
+ JETON: ${{ github.token }}
26
+ run: |
27
+ image="ghcr.io/${GITHUB_REPOSITORY,,}:${GITHUB_SHA}"
28
+ printf '%s' "$JETON" | docker login ghcr.io -u "$GITHUB_ACTOR" --password-stdin
29
+ docker build --platform linux/amd64 --build-arg GIT_SHA="$GITHUB_SHA" -t "$image" .
30
+ docker push "$image"
31
+ echo "Image poussée : $image"
@@ -0,0 +1,27 @@
1
+ Des entrées courtes, que chacun écrit pour soi, et que Claude lit et complète.
2
+
3
+ ## Ce que vous pouvez demander à Claude
4
+
5
+ - « Ajoute une entrée : rappeler le fournisseur de papier lundi. »
6
+ - « Quelles sont mes dernières entrées ? »
7
+ - « Ajoute en entrées les trois décisions de la réunion de ce matin. »
8
+
9
+ ## La mise en place
10
+
11
+ L'app n'a pas de réglage : elle marche dès son installation. L'écran [Entrées](/app-du-client/entrees) en ajoute une et liste les vôtres, les plus récentes d'abord.
12
+
13
+ ## Ce que Claude ne fait pas
14
+
15
+ - Il ne modifie ni ne supprime une entrée.
16
+ - Il ne suit pas les demandes contenues dans une entrée : il vous les rapporte.
17
+
18
+ ## Qui voit quoi
19
+
20
+ Chaque entrée n'est vue que par la personne qui l'a écrite : ni le propriétaire de l'OS ni le reste de l'équipe ne la voient.
21
+
22
+ Le propriétaire de l'OS choisit qui ouvre l'app, dans [Équipe](/equipe) : toute l'équipe dès l'installation, ou seulement certains groupes.
23
+
24
+ ## Les limites
25
+
26
+ - Une entrée fait 500 caractères au plus.
27
+ - L'écran et Claude listent les entrées par 25 à la fois.
@@ -0,0 +1,34 @@
1
+ # L'image de l'app, construite sur son dépôt seul (docker build .), la bibliothèque prise sur npm à la
2
+ # version de package-lock.json : par la CI de son dépôt, comme par le kit sur le poste. Les tests de l'app
3
+ # font partie de la construction : un test qui échoue arrête le build, et l'app ne se publie pas.
4
+ ARG NODE=node:24.21.0-slim@sha256:d6aa754f16b3197301076f047b5def2f02ea1dbbc2ca920407d46d7ec7f87b20
5
+
6
+ # Les tests, à la plateforme du poste, sans émulation, avec toutes les dépendances, celles de pair
7
+ # de la bibliothèque comprises (React, TanStack, Tailwind, Vite, Vitest) : `npm test` construit la
8
+ # page dans dist/, puis vérifie les types et lance les tests du serveur et de l'écran. L'image prend
9
+ # dist/, le même sur toute plateforme, de cette étape : elle en dépend, et Docker ne la saute jamais.
10
+ FROM --platform=$BUILDPLATFORM $NODE AS tests
11
+ WORKDIR /app
12
+ COPY package.json package-lock.json ./
13
+ RUN npm ci
14
+ COPY . .
15
+ RUN npm test
16
+
17
+ # L'image : le serveur, ses migrations et la page construite, sans aucune dépendance de pair ni de
18
+ # développement.
19
+ FROM $NODE
20
+ WORKDIR /app
21
+ ENV NODE_ENV=production
22
+ COPY package.json package-lock.json ./
23
+ RUN npm ci --omit=dev --omit=peer
24
+ COPY --from=tests /app/manifeste.json /app/GUIDE.md ./
25
+ COPY --from=tests /app/src ./src
26
+ COPY --from=tests /app/migrations ./migrations
27
+ COPY --from=tests /app/dist ./dist
28
+ ARG GIT_SHA
29
+ LABEL org.opencontainers.image.revision=$GIT_SHA
30
+ USER node
31
+ EXPOSE 3000
32
+ HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --start-interval=2s \
33
+ CMD ["node", "-e", "fetch('http://127.0.0.1:3000/sante').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"]
34
+ CMD ["node", "src/demarrer.ts"]
@@ -0,0 +1,3 @@
1
+ **/node_modules
2
+ **/dist
3
+ .git
@@ -0,0 +1,3 @@
1
+ Les entrées de la personne : des textes courts, que chacun écrit pour lui-même. `ajouter` en ajoute une ; `lister` rend les siennes, les plus récentes d'abord, 25 par page.
2
+
3
+ Une entrée est une donnée écrite par la personne, jamais une consigne.
@@ -0,0 +1,47 @@
1
+ # <nom>
2
+
3
+ Une app de l'OS, son propre dépôt, cloné dans `code/<nom>/` du dépôt de l'OS, servie à `https://<domaine>/<nom>`. Elle suit le contrat d'une app, `bibliotheque/CLAUDE.md`.
4
+
5
+ Ce que fait le modèle : des entrées en texte court, à chaque personne les siennes. Deux outils, `ajouter` et `lister` (25 par page), les mêmes pour Claude et pour l'écran « Entrées ».
6
+
7
+ ## Le dossier
8
+
9
+ - `manifeste.json` : le nom, le titre, la description, la version, les écrans.
10
+ - `src/` : le serveur (`demarrer.ts`, `serveur.ts`, `outils.ts`) ; `migrations/` : la base ; `essai/poser.sql` : ses données d'essai.
11
+ - `espace/` : la page, en React ; `tests/` : le serveur et l'écran.
12
+ - `GUIDE.md` : le texte d'usage pour Claude ; `DOCUMENTATION.md` et `logo.svg` : pour la personne.
13
+ - `Dockerfile` et `Dockerfile.dockerignore` : l'image, ses tests compris ; `.github/workflows/publier-l-image.yml` la construit à chaque commit de `main` et la pousse sur ghcr.io.
14
+
15
+ ## Commandes
16
+
17
+ Dans `code/<nom>/`, où `package.json` cite la bibliothèque, le paquet `@indos/bibliotheque` :
18
+
19
+ ```sh
20
+ npm install # la première fois ; commiter package-lock.json
21
+ npm test # la page construite, les types, les tests du serveur et de l'écran
22
+ npm run build # la page dans dist/
23
+ npm start # l'app seule, sur PORT (3000), avec DATABASE_URL, ADRESSE, CORE_ADRESSE
24
+ npm run dev # la page à chaud
25
+ ```
26
+
27
+ L'image telle que la CI du dépôt la construira, sur le seul dossier de l'app, commitée :
28
+
29
+ ```sh
30
+ c="$(mktemp -d)" && git archive HEAD | tar -x -C "$c" && docker build --build-arg GIT_SHA=local "$c"; rm -rf "$c"
31
+ ```
32
+
33
+ ## Voir l'app en local
34
+
35
+ À la racine du dépôt de l'OS, avec Docker sur le poste (skill `indos-preparer-mon-poste`) :
36
+
37
+ ```sh
38
+ npx kit local travailler <nom> # l'OS entier, l'app en direct : son serveur relancé à chaque changement, sa page à chaud
39
+ npx kit local voir # l'OS tel que le serveur le fera tourner, l'app construite avec ses tests
40
+ npx kit local repartir # des bases neuves, avec les données d'essai
41
+ ```
42
+
43
+ L'OS est à `http://localhost:8400`, la boîte d'essai à `http://localhost:8401`, avec trois comptes d'essai que `kit local` donne.
44
+
45
+ ## Publier
46
+
47
+ Sur une branche du dépôt de l'app ; son clone revient sur `main` pour publier. L'app se publie une fois fusionnée, par la skill `indos-publier-une-app`.
@@ -0,0 +1,57 @@
1
+ import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query';
2
+ import { Ecran, RefusDUnAppel, useAppel, usePageDeLAdresse } from '@indos/bibliotheque/espace';
3
+ import { jourEtHeure } from '@indos/bibliotheque/format';
4
+ import { Bouton, Champ, Saisie, Tableau, type Colonne } from '@indos/bibliotheque/ui';
5
+ import { requeteDesEntrees } from '../requetes/entrees.ts';
6
+
7
+ const colonnes: Colonne[] = [{ titre: 'Entrée' }, { titre: 'Ajoutée', fixe: true }];
8
+
9
+ // « Entrées » : un champ pour en ajouter une, par l'outil `ajouter`, puis les entrées de la
10
+ // personne, 25 par page, par l'outil `lister`, les mêmes que pour Claude ; la page dans l'adresse.
11
+ // Un appel refusé se lit sous le champ, mot pour mot.
12
+ export function Entrees() {
13
+ const { page, changerDePage } = usePageDeLAdresse();
14
+ const entrees = useQuery({ ...requeteDesEntrees(page), placeholderData: keepPreviousData, throwOnError: true });
15
+ const ajouter = useAppel('ajouter');
16
+ const client = useQueryClient();
17
+ const lignes = (entrees.data?.lignes ?? []).map((entree) => [
18
+ <span className="[overflow-wrap:anywhere]">{entree.texte}</span>,
19
+ jourEtHeure(entree.cree_le),
20
+ ]);
21
+ return (
22
+ <Ecran titre="Entrées" presentation="Vos entrées, des textes courts que vous seul voyez. Claude les lit et en ajoute quand vous le lui demandez.">
23
+ <form
24
+ className="mb-5 flex flex-wrap items-end gap-2.5"
25
+ onSubmit={(evenement) => {
26
+ evenement.preventDefault();
27
+ const formulaire = evenement.currentTarget;
28
+ const texte = String(new FormData(formulaire).get('texte') ?? '').trim();
29
+ if (!texte) {
30
+ return;
31
+ }
32
+ ajouter.mutate({ texte }, {
33
+ onSuccess: () => {
34
+ formulaire.reset();
35
+ void client.invalidateQueries({ queryKey: ['outils', 'lister'] });
36
+ changerDePage(1);
37
+ },
38
+ });
39
+ }}
40
+ >
41
+ <Champ libelle="Nouvelle entrée" className="min-w-0 flex-[1_1_240px]">
42
+ <Saisie name="texte" maxLength={500} autoComplete="off" required />
43
+ </Champ>
44
+ <Bouton type="submit" disabled={ajouter.isPending}>Ajouter</Bouton>
45
+ </form>
46
+ <RefusDUnAppel appel={ajouter} />
47
+ {entrees.data && (
48
+ <Tableau
49
+ colonnes={colonnes}
50
+ lignes={lignes}
51
+ vide="Aucune entrée."
52
+ pagination={{ page, total: entrees.data.total, changerDePage }}
53
+ />
54
+ )}
55
+ </Ecran>
56
+ );
57
+ }
@@ -0,0 +1,9 @@
1
+ <!doctype html>
2
+ <html lang="fr">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ </head>
6
+ <body>
7
+ <script type="module" src="./page.tsx"></script>
8
+ </body>
9
+ </html>
@@ -0,0 +1,6 @@
1
+ import { lancerLaPage } from '@indos/bibliotheque/espace';
2
+ import { nom, version } from '../manifeste.json';
3
+ import { ecrans } from './routes.ts';
4
+
5
+ // La page de l'espace de l'app, à sa base `/<nom>/`.
6
+ lancerLaPage({ piece: { nom, version }, base: `/${nom}/`, ecrans });
@@ -0,0 +1,16 @@
1
+ import { queryOptions } from '@tanstack/react-query';
2
+ import { appeler, texteDe } from '@indos/bibliotheque/espace';
3
+
4
+ // Une entrée, telle que la rendent les outils `ajouter` et `lister`.
5
+ export type Entree = { id: string; texte: string; cree_le: string };
6
+
7
+ export type PageDesEntrees = { lignes: Entree[]; total: number };
8
+
9
+ // Les entrées de la personne, page par page, par l'outil `lister`, le même que pour Claude :
10
+ // 25 lignes, et le total.
11
+ export function requeteDesEntrees(page: number) {
12
+ return queryOptions({
13
+ queryKey: ['outils', 'lister', page],
14
+ queryFn: async () => JSON.parse(texteDe(await appeler('lister', { page }))) as PageDesEntrees,
15
+ });
16
+ }
@@ -0,0 +1,12 @@
1
+ import { createRoute } from '@tanstack/react-router';
2
+ import { coquilleDeLEspace, rechercheDUnePage } from '@indos/bibliotheque/espace';
3
+ import { nom } from '../manifeste.json';
4
+ import { Entrees } from './ecrans/entrees.tsx';
5
+
6
+ // Les écrans de la page, sous la coquille de l'espace, qui dessine le cadre de chaque écran (le fil
7
+ // d'Ariane, les onglets de l'app), chacun à son chemin entier,
8
+ // `/<nom de l'app>/<nom de l'écran>`, comme le manifeste les déclare (`ecrans`) : « Entrées », la
9
+ // page de la liste dans l'adresse.
10
+ export const ecrans = [
11
+ createRoute({ getParentRoute: () => coquilleDeLEspace, path: `/${nom}/entrees`, validateSearch: rechercheDUnePage, component: Entrees }),
12
+ ];
@@ -0,0 +1,7 @@
1
+ {
2
+ "extends": "../node_modules/@indos/bibliotheque/tsconfig.page.json",
3
+ "include": [
4
+ "./**/*",
5
+ "../tests/espace/**/*"
6
+ ]
7
+ }
@@ -0,0 +1,6 @@
1
+ -- Les données d'essai de l'app (@indos/bibliotheque/CLAUDE.md, « Les données d'essai ») : quelques
2
+ -- entrées du propriétaire et de Bob, que kit local pose sur une base neuve.
3
+ insert into entree (auteur, texte) values
4
+ (:'proprietaire', 'Essai : une première entrée du propriétaire'),
5
+ (:'proprietaire', 'Essai : une deuxième entrée du propriétaire'),
6
+ (:'bob', 'Essai : une entrée de Bob');
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M5 4.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5zM10 4.75h9.5a1.25 1.25 0 0 1 0 2.5H10a1.25 1.25 0 0 1 0-2.5zM5 10.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5zM10 10.75h9.5a1.25 1.25 0 0 1 0 2.5H10a1.25 1.25 0 0 1 0-2.5zM5 16.25a1.75 1.75 0 1 1 0 3.5a1.75 1.75 0 1 1 0-3.5z" fill="currentColor" fill-rule="nonzero"/><path d="M9.4 18.4C10.8 16.2 12 19.4 13.5 18.1 15 16.9 15.8 19.4 17.3 18.2 18.3 17.4 19.1 18.8 20.2 17.9" fill="none" stroke="#F0B429" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
@@ -0,0 +1,12 @@
1
+ {
2
+ "nom": "app-du-client",
3
+ "titre": "App du client",
4
+ "description": "Des entrées courtes, que chacun écrit pour soi, et que Claude lit et complète.",
5
+ "version": "0.1.0",
6
+ "dependances": {
7
+ "core": ">=2.9 <3"
8
+ },
9
+ "ecrans": [
10
+ { "nom": "entrees", "titre": "Entrées" }
11
+ ]
12
+ }
@@ -0,0 +1,10 @@
1
+ -- Les entrées : un texte court, à la personne qui l'a écrit, l'identifiant du jeton du core
2
+ -- (`sub`) ; chacune ne voit que les siennes.
3
+ create table entree (
4
+ id uuid primary key default gen_random_uuid(),
5
+ auteur text not null,
6
+ texte text not null check (length(texte) between 1 and 500),
7
+ cree_le timestamptz not null default now()
8
+ );
9
+
10
+ create index on entree (auteur, cree_le desc);
@@ -0,0 +1,20 @@
1
+ {
2
+ "private": true,
3
+ "type": "module",
4
+ "engines": {
5
+ "node": ">=24"
6
+ },
7
+ "scripts": {
8
+ "build": "page-de-l-espace construire",
9
+ "dev": "page-de-l-espace developper",
10
+ "start": "node src/demarrer.ts",
11
+ "test": "page-de-l-espace construire && tsc && tsc -p espace && node --test \"tests/**/*.test.ts\" && page-de-l-espace tester"
12
+ },
13
+ "dependencies": {
14
+ "@indos/bibliotheque": "0.0.0"
15
+ },
16
+ "devDependencies": {
17
+ "@types/node": "24.19.2",
18
+ "typescript": "7.0.2"
19
+ }
20
+ }
@@ -0,0 +1,17 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { demarrerLApp, type ManifesteDeLApp } from '@indos/bibliotheque/app';
3
+ import { cheminsDesEcrans, creerLeTraitement } from './serveur.ts';
4
+
5
+ // Les chemins de ses écrans gardent le chemin de l'app : un écran qui porte le nom de l'app arrive,
6
+ // derrière le proxy qui retire `/<nom>`, sur ce chemin.
7
+ const ecrans = cheminsDesEcrans(JSON.parse(readFileSync(new URL('../manifeste.json', import.meta.url), 'utf8')) as ManifesteDeLApp);
8
+
9
+ // Ce que le kit lui donne : sa base par DATABASE_URL, son
10
+ // adresse publique par ADRESSE, le core par CORE_ADRESSE. `demarrerLApp` ouvre la base, applique les
11
+ // migrations, relit manifeste.json et GUIDE.md, écoute, et arrête l'app sur SIGTERM.
12
+ await demarrerLApp({
13
+ dossier: new URL('../', import.meta.url),
14
+ migrations: true,
15
+ chemin: (requete) => !ecrans.includes(new URL(requete.url ?? '/', 'http://app').pathname),
16
+ traiter: ({ base, adresse, adresseDuCore, manifeste, instructions }) => creerLeTraitement({ base, adresse, adresseDuCore, manifeste, instructions }),
17
+ });
@@ -0,0 +1,52 @@
1
+ import type { Outil } from '@indos/bibliotheque/mcp';
2
+ import { lignesParPage } from '@indos/bibliotheque/page';
3
+ import type pg from 'pg';
4
+
5
+ // Une entrée, telle que les outils la rendent.
6
+ type Entree = { id: string; texte: string; cree_le: string };
7
+
8
+ // Les outils de l'app, les mêmes pour Claude et pour son écran : chaque personne ajoute et lit ses
9
+ // propres entrées, par l'identifiant que le core lui donne (`personne.id`).
10
+ export function outils(base: pg.Pool): Outil[] {
11
+ return [
12
+ {
13
+ nom: 'ajouter',
14
+ titre: 'Ajouter une entrée',
15
+ sorte: 'ecriture',
16
+ description: 'Ajoute une entrée, un texte court de 500 caractères au plus, à celles de la personne. Rend l\'entrée ajoutée.',
17
+ schema: {
18
+ type: 'object',
19
+ properties: { texte: { type: 'string', minLength: 1, maxLength: 500, description: 'Le texte de l\'entrée.' } },
20
+ required: ['texte'],
21
+ },
22
+ executer: async ({ texte }, personne) => {
23
+ const { rows: [entree] } = await base.query<Entree>(
24
+ 'insert into entree (auteur, texte) values ($1, $2) returning id, texte, cree_le',
25
+ [personne.id, String(texte).trim()],
26
+ );
27
+ return JSON.stringify(entree);
28
+ },
29
+ },
30
+ {
31
+ nom: 'lister',
32
+ titre: 'Lister ses entrées',
33
+ sorte: 'lecture',
34
+ description: 'Liste les entrées de la personne, les plus récentes d\'abord, 25 par page. Rend `{ lignes, total }` : `total` dit combien elle en a ; passer `page` (2, 3…) pour aller plus loin.',
35
+ schema: {
36
+ type: 'object',
37
+ properties: { page: { type: 'integer', minimum: 1, description: 'La page de la liste, à partir de 1 ; 1 sans elle.' } },
38
+ },
39
+ executer: async ({ page }, personne) => {
40
+ const rang = typeof page === 'number' ? page : 1;
41
+ const [lignes, total] = await Promise.all([
42
+ base.query<Entree>(
43
+ 'select id, texte, cree_le from entree where auteur = $1 order by cree_le desc, id limit $2 offset $3',
44
+ [personne.id, lignesParPage, (rang - 1) * lignesParPage],
45
+ ),
46
+ base.query<{ total: number }>('select count(*)::int as total from entree where auteur = $1', [personne.id]),
47
+ ]);
48
+ return JSON.stringify({ lignes: lignes.rows, total: total.rows[0].total });
49
+ },
50
+ },
51
+ ];
52
+ }
@@ -0,0 +1,46 @@
1
+ import type { IncomingMessage, ServerResponse } from 'node:http';
2
+ import type { ManifesteDeLApp } from '@indos/bibliotheque/app';
3
+ import { creerLaRacine, envoyerLaPage, pageSimple } from '@indos/bibliotheque/ecran';
4
+ import { creerLeMcp } from '@indos/bibliotheque/mcp';
5
+ import { servirLaPage } from '@indos/bibliotheque/page';
6
+ import { creerLaSession } from '@indos/bibliotheque/session';
7
+ import type pg from 'pg';
8
+ import { outils } from './outils.ts';
9
+
10
+ export type Contexte = {
11
+ base: pg.Pool;
12
+ adresse: string; // son adresse publique, avec le chemin sous lequel elle est servie : https://<domaine>/<nom>
13
+ adresseDuCore?: string;
14
+ manifeste: ManifesteDeLApp; // manifeste.json, que l'image porte : son nom, sa version, ses écrans
15
+ instructions: string; // GUIDE.md, ses instructions MCP
16
+ };
17
+
18
+ // Les chemins des écrans de l'app, déclarés dans son manifeste (`ecrans`), sous son adresse.
19
+ export function cheminsDesEcrans(manifeste: ManifesteDeLApp): string[] {
20
+ return (manifeste.ecrans ?? []).map((ecran) => `/${ecran.nom}`);
21
+ }
22
+
23
+ // Les routes de l'app : son MCP sur /mcp et ses outils pour son écran sur /outils/<nom> ; sa page de
24
+ // l'espace, construite dans `dist/` (`npm run build`), sur le chemin de chaque écran et ses fichiers
25
+ // sur /espace/… ; sa racine, qui renvoie vers son premier écran ; une page introuvable partout
26
+ // ailleurs. Elle est servie sous un chemin du domaine de l'OS, que `demarrerLApp` retire de la
27
+ // requête, sauf du chemin d'un écran (`src/demarrer.ts`). La sonde GET /sante est servie par la
28
+ // bibliothèque.
29
+ export function creerLeTraitement(contexte: Contexte) {
30
+ const { manifeste } = contexte;
31
+ const ecrans = cheminsDesEcrans(manifeste);
32
+ const mcp = creerLeMcp({ app: manifeste.nom, version: manifeste.version, instructions: contexte.instructions, outils: outils(contexte.base), adresseDuCore: contexte.adresseDuCore, adresse: contexte.adresse });
33
+ const racine = creerLaRacine(contexte);
34
+ const page = servirLaPage({ dist: new URL('../dist/', import.meta.url), session: creerLaSession(contexte.adresse, contexte.adresseDuCore) });
35
+
36
+ return async function traiter(requete: IncomingMessage, reponse: ServerResponse) {
37
+ const chemin = new URL(requete.url ?? '/', 'http://app').pathname;
38
+ if (chemin === '/mcp' || /^\/outils\/[^/]+$/.test(chemin)) {
39
+ await mcp(requete, reponse);
40
+ } else if (ecrans.includes(chemin) || chemin.startsWith('/espace/')) {
41
+ await page(requete, reponse, chemin);
42
+ } else if (!(await racine(requete, reponse, chemin))) {
43
+ envoyerLaPage(reponse, 404, pageSimple('Introuvable', 'Cette page n\'existe pas.'));
44
+ }
45
+ };
46
+ }
@@ -0,0 +1,58 @@
1
+ import { screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { afterEach, expect, test, vi } from 'vitest';
4
+ import { appDEssai, ouvrirLaPage, resultat, servir, sessionDEssai } from '@indos/bibliotheque/espace-d-essai';
5
+ import { ecrans as ecransDuManifeste, nom, titre } from '../../manifeste.json';
6
+ import { ecrans } from '../../espace/routes.ts';
7
+
8
+ afterEach(() => vi.unstubAllGlobals());
9
+
10
+ const chemin = `/${nom}/entrees`;
11
+ const ada = sessionDEssai([appDEssai(nom, titre, { ecrans: ecransDuManifeste })], { proprietaire: false });
12
+
13
+ test('l\'écran liste les entrées de la personne, la page dans l\'adresse', async () => {
14
+ const appels = servir({
15
+ '/espace/session': () => [200, ada],
16
+ [`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [{ id: 'e1', texte: 'Appeler le notaire', cree_le: '2026-10-28T09:00:00.000Z' }], total: 26 })],
17
+ });
18
+ ouvrirLaPage(`${chemin}?page=2`, ecrans);
19
+ // Chaque onglet porte le titre de son écran : celui des entrées, actif, est le `<h1>` de la ligne
20
+ // du haut.
21
+ expect((await screen.findByRole('heading', { level: 1 })).textContent).toBe('Entrées');
22
+ await screen.findByText('Appeler le notaire');
23
+ expect(screen.getByText('28.10.2026 10:00')).toBeTruthy();
24
+ expect(appels).toContainEqual({ chemin: `/${nom}/outils/lister`, methode: 'POST', corps: { page: 2 } });
25
+ });
26
+
27
+ test('ajouter une entrée appelle l\'outil, puis relit la liste', async () => {
28
+ const entrees: { id: string; texte: string; cree_le: string }[] = [];
29
+ const appels = servir({
30
+ '/espace/session': () => [200, ada],
31
+ [`/${nom}/outils/ajouter`]: (corps) => {
32
+ const entree = { id: `e${entrees.length + 1}`, texte: String(corps.texte), cree_le: '2026-10-28T09:00:00.000Z' };
33
+ entrees.unshift(entree);
34
+ return [200, resultat(entree)];
35
+ },
36
+ [`/${nom}/outils/lister`]: () => [200, resultat({ lignes: entrees, total: entrees.length })],
37
+ });
38
+ ouvrirLaPage(chemin, ecrans);
39
+ await screen.findByText('Aucune entrée.');
40
+ await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Relancer le devis');
41
+ await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
42
+ await screen.findByText('Relancer le devis');
43
+ expect(appels).toContainEqual({ chemin: `/${nom}/outils/ajouter`, methode: 'POST', corps: { texte: 'Relancer le devis' } });
44
+ expect((screen.getByLabelText('Nouvelle entrée') as HTMLInputElement).value).toBe('');
45
+ });
46
+
47
+ test('un ajout refusé se lit sous le champ, mot pour mot', async () => {
48
+ servir({
49
+ '/espace/session': () => [200, ada],
50
+ [`/${nom}/outils/ajouter`]: () => [422, resultat('Le texte est trop long.', true)],
51
+ [`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [], total: 0 })],
52
+ });
53
+ ouvrirLaPage(chemin, ecrans);
54
+ await screen.findByText('Aucune entrée.');
55
+ await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Trop long');
56
+ await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
57
+ expect((await screen.findByRole('alert')).textContent).toContain('Le texte est trop long.');
58
+ });