cof-cli 1.1.0__tar.gz → 1.2.0__tar.gz
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.
- cof_cli-1.2.0/PKG-INFO +55 -0
- cof_cli-1.2.0/README.md +38 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/__init__.py +2 -2
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/cast.py +1 -1
- cof_cli-1.2.0/cof_cli/cli.py +639 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/container.py +18 -2
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/convert.py +92 -12
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/memories.py +16 -3
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/migrate.py +206 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/model.py +25 -4
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/ops.py +160 -30
- cof_cli-1.2.0/cof_cli/profiles.py +453 -0
- cof_cli-1.2.0/cof_cli/propose.py +704 -0
- cof_cli-1.2.0/cof_cli/psyche.py +374 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/attitude.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/body.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/card.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/consent.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/hair.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/manifest.schema.json +33 -7
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/memory.schema.json +34 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/pose.schema.json +1 -1
- cof_cli-1.2.0/cof_cli/schemas/psyche-node.schema.json +379 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/psyche.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/skeleton.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/visemes.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/voice-profile.schema.json +1 -1
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/weights.schema.json +1 -1
- cof_cli-1.2.0/cof_cli/selfdesc.py +440 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/validate.py +493 -48
- cof_cli-1.2.0/cof_cli/zodiac.py +157 -0
- cof_cli-1.2.0/cof_cli.egg-info/PKG-INFO +55 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli.egg-info/SOURCES.txt +6 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/pyproject.toml +1 -1
- cof_cli-1.2.0/tests/test_hunt.py +266 -0
- cof_cli-1.2.0/tests/test_roundtrip.py +2542 -0
- cof_cli-1.1.0/PKG-INFO +0 -46
- cof_cli-1.1.0/README.md +0 -29
- cof_cli-1.1.0/cof_cli/cli.py +0 -393
- cof_cli-1.1.0/cof_cli/selfdesc.py +0 -201
- cof_cli-1.1.0/cof_cli.egg-info/PKG-INFO +0 -46
- cof_cli-1.1.0/tests/test_roundtrip.py +0 -1285
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/completeness.py +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/schemas/garments-1.0.json +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli/tokens.py +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli.egg-info/dependency_links.txt +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli.egg-info/entry_points.txt +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli.egg-info/requires.txt +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/cof_cli.egg-info/top_level.txt +0 -0
- {cof_cli-1.1.0 → cof_cli-1.2.0}/setup.cfg +0 -0
cof_cli-1.2.0/PKG-INFO
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: cof-cli
|
|
3
|
+
Version: 1.2.0
|
|
4
|
+
Summary: COF — Character Open File: validate, pack, unpack and convert .cof character containers
|
|
5
|
+
Author: Yann Souetre
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Requires-Python: >=3.10
|
|
8
|
+
Description-Content-Type: text/markdown
|
|
9
|
+
Requires-Dist: jsonschema>=4.20
|
|
10
|
+
Provides-Extra: tokens
|
|
11
|
+
Requires-Dist: tiktoken>=0.7; extra == "tokens"
|
|
12
|
+
Provides-Extra: png
|
|
13
|
+
Requires-Dist: Pillow>=10; extra == "png"
|
|
14
|
+
Provides-Extra: dev
|
|
15
|
+
Requires-Dist: pytest>=8; extra == "dev"
|
|
16
|
+
Requires-Dist: Pillow>=10; extra == "dev"
|
|
17
|
+
|
|
18
|
+
# cof-cli
|
|
19
|
+
|
|
20
|
+
Outil de référence pour COF (Character Open File) : validation, empaquetage, extraction, fusion, conversions, l'ajout d'un souvenir vécu (1.1) et d'un nœud de psyché vécu (1.2). `pip install cof-cli` (PyPI) ou, depuis ce dossier, `pip install -e ".[dev]"`. Python ≥ 3.10.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
cof validate spec/examples/10-clara-mercier # dossier ou fichier .cof : erreurs, avertissements, complétude (--json pour la CI)
|
|
24
|
+
cof pack spec/examples/10-clara-mercier -o clara.cof # recalcule hashes, complétude, langues ; écrit COF.md et la vignette
|
|
25
|
+
cof info clara.cof # presets, déclinaisons, âges, tags — le point de départ pour un agent
|
|
26
|
+
cof unpack clara.cof -o clara/
|
|
27
|
+
cof tokens clara.cof
|
|
28
|
+
cof extract clara.cof --preset fr-65 -o clara-65/ # une tranche plus légère : un preset, un personnage (--identity) ou des tags (--tag fr --tag age-65) ; les lieux et objets que nomment ses souvenirs et nœuds suivent
|
|
29
|
+
cof extract clara.cof --identity clara-mercier --all-audiences -o clara-sfw/ # sans nudité ni intime, médias des souvenirs explicites retirés (gist conservé)
|
|
30
|
+
cof extract clara.cof --preset default --keep-personal -o clara-perso/ # garde les souvenirs et nœuds de psyché `visibility: personal` (retirés par défaut)
|
|
31
|
+
cof extract clara.cof --preset default --no-risk -o clara-sans-risque/ # purge de risque (RFC 0004) : retire les nœuds `inappropriate` et `dangerous` (et les contradictions amputées), tags.content corrigés ; --all-audiences les retire aussi
|
|
32
|
+
cof merge clara.cof martien.cof -o duo/ # un casting : même nom + surnom + statut fictif + morphologie ⇒ même personnage, sinon plusieurs
|
|
33
|
+
cof memory add clara.cof --gist fr="Ce matin, relu avec Léo." --gist en="This morning, reread with Léo." --date 2026-10-25 --who "Léo" --what "le carnet" --what "item=appearance/x1" --tag travail --personal # --what : un objet (1.2, RFC 0005), un nom et/ou item=<élément>, |shown s'il est dans un média
|
|
34
|
+
cof memory add clara/ --kind period --gist en="The agency years." --age 24 --approx --fidelity faded # sur un dossier ; `--help` liste tout (--where, --self-shown, --media, --preset…)
|
|
35
|
+
cof psyche add clara.cof --kind stance --gist fr="Envers l'utilisateur : une collègue." --about user --strength 60 --stability shifting --link because=memories/ev3 --since-date 2026-10-25 # nœud vécu, `visibility: personal` (--canon sinon), première révision ; `--help` liste tout (--lie, --risk, --tag, --preset…)
|
|
36
|
+
cof psyche add clara.cof --kind habit --gist fr="Garde la guitare près du bureau." --who "ma grand-mère" --where "environment=appearance/e1" --what "ma guitare|item=appearance/x1" --canon # personnes, lieux, objets du nœud (RFC 0005) ; une personne du casting : --who identity=<id> (les liens --link ne visent que souvenirs et nœuds)
|
|
37
|
+
cof psyche add clara.cof --kind stance --gist fr="Envers l'utilisateur : de la chaleur." --about user --valence 60 --aware partly --canon # RFC 0004 § 3 nonies : --valence −100…+100 (position ou goût seulement), --aware yes|partly|no, --until-age / --until-date (quand le nœud a cessé d'être tenu)
|
|
38
|
+
cof psyche add clara.cof --kind fear --gist fr="Perdre le dernier carnet." --image carnet.png --canon # RFC 0004 § 3 decies : une illustration du nœud (images seulement, la première remplace l'icône, 3 au plus) ; --self-shown --age N si elle montre le personnage (l'âge entre dans les règles des mineurs)
|
|
39
|
+
cof psyche propose clara.cof --preset fr-agent --from-file proposition.json # personnalité → psyché : une proposition validée (docs/psyche-propose.md), affichée en table, rien d'écrit
|
|
40
|
+
cof psyche propose clara.cof --from-file proposition.json --apply --accept c2,c3 # n'écrit que les candidats acceptés ; --rules (listes 1.0), --zodiac vierge, --mbti INFJ, --enneagram 4w5, --big-five O=80,C=35,E=20,A=70,N=60, --bundle-out, --provider openai-compatible (clé : COF_AI_KEY)
|
|
41
|
+
cof psyche text clara.cof --preset fr-agent # l'inverse : le texte « Qui elle est » ; --into-card l'ajoute à la suite du champ personnalité de la carte
|
|
42
|
+
cof import carte.png -o perso/ --age 30 --lang fr --keep-png # carte PNG CCv2/V3 → dossier COF
|
|
43
|
+
cof export clara.cof --format png -o clara.png # → PNG avec chunks chara + ccv3
|
|
44
|
+
cof export clara.cof --format card -o clara.card.json
|
|
45
|
+
cof export clara.cof --format soul -o ./agent/ # → SOUL.md + IDENTITY.md
|
|
46
|
+
cof export clara.cof --format agent -o ./agent/ # → espace de travail d'agent : SOUL.md (avec « Qui elle est » rendu depuis la psyché), IDENTITY.md, skills/, MEMORY.md + memories/ (--keep-personal, --keep-dangerous, --preset)
|
|
47
|
+
cof embed-text clara.png fiche.md -o clara-fiche.png # texte descriptif dans un PNG (iTXt), lisible par le builder
|
|
48
|
+
cof read-text clara-fiche.png
|
|
49
|
+
cof migrate dossier-v0.5/ # v0.2 … v0.5 → 1.0
|
|
50
|
+
cof migrate clara/ --psyche # 1.2 : les listes goals / fears / values / behavior deviennent des nœuds de psyché (les listes restent ; idempotent)
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Ce que `validate` vérifie : la structure de l'archive (sentinelle `mimetype`, chemins sûrs, pas d'entrée en double ni chiffrée, taux de compression, taille), les hashes SHA-256 et tailles des assets, les schémas JSON du manifeste et des sous-fichiers (`card`, `psyche`, `weights`, `voice-profile`, `memory`…), la résolution des presets (slots, alternatives, `extends`, `derives_from`), les identifiants d'assets et de déclinaisons, les règles d'âge sur l'**âge le plus bas** d'un preset (déclinaisons appliquées et offertes, `age_override`, souvenirs qui montrent le personnage), l'interdiction de tout contenu nu ou intime sous 18 ans, le consentement d'une personne réelle, les règles des souvenirs (RFC 0002 : forme de `when`, liens, `media_from`, nœuds explicites — qui est montré, âges connus et adultes, âge vécu ≥ 18, drapeau `nudity`, `tags.content`), les relations entre personnages d'un casting (RFC 0003), les styles mélangés, les transcriptions des échantillons de voix, le contenu exécutable non déclaré, les doublons, les budgets de tokens ; puis recalcule la complétude et les cibles prêtes. En 1.2, il vérifie aussi la psyché (RFC 0004) : fichier `psyche-node.json` de chaque nœud, cibles des liens et de `about`, `supports` / `conflicts` entre nœuds seulement, une `contradiction` à exactement deux `conflicts`, `false_but_held` sur une `belief` et `about` sur une `stance` seulement, pas de cycle de `because`, miroir de `strength`, un nœud ne s'appuie que sur les souvenirs de son personnage, cohérence `risk` ↔ `tags.content` (`psyche-inappropriate`, `psyche-dangerous`) et `cof: "1.2"` déclaré ; les personnes, lieux et objets (RFC 0005) : `what` des souvenirs, `who` / `where` / `what` des nœuds — identité, environnement ou objet (`item`) résolus et du même personnage dans un casting, un nœud sans lien vers `identities/…` (les personnes vont dans `who`), `cof: "1.2"` déclaré ; un `item` qui n'est pas un accessoire ou un lieu qui n'est pas un environnement est un avertissement ; les informations non bloquantes s'affichent en lignes `INFO`. Les chemins et noms lus dans un manifeste ne sortent jamais du dossier de sortie (`export`, `extract`, `merge`).
|
|
54
|
+
|
|
55
|
+
Tests : `pytest` (dossier `cli/`, 88 tests) ; le corpus négatif de `tests/invalid/` (80 cas, un par règle) est régénéré par `python tests/invalid/build.py`. Tokens : installer `tiktoken` pour un comptage exact (sinon heuristique par caractères).
|
cof_cli-1.2.0/README.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# cof-cli
|
|
2
|
+
|
|
3
|
+
Outil de référence pour COF (Character Open File) : validation, empaquetage, extraction, fusion, conversions, l'ajout d'un souvenir vécu (1.1) et d'un nœud de psyché vécu (1.2). `pip install cof-cli` (PyPI) ou, depuis ce dossier, `pip install -e ".[dev]"`. Python ≥ 3.10.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
cof validate spec/examples/10-clara-mercier # dossier ou fichier .cof : erreurs, avertissements, complétude (--json pour la CI)
|
|
7
|
+
cof pack spec/examples/10-clara-mercier -o clara.cof # recalcule hashes, complétude, langues ; écrit COF.md et la vignette
|
|
8
|
+
cof info clara.cof # presets, déclinaisons, âges, tags — le point de départ pour un agent
|
|
9
|
+
cof unpack clara.cof -o clara/
|
|
10
|
+
cof tokens clara.cof
|
|
11
|
+
cof extract clara.cof --preset fr-65 -o clara-65/ # une tranche plus légère : un preset, un personnage (--identity) ou des tags (--tag fr --tag age-65) ; les lieux et objets que nomment ses souvenirs et nœuds suivent
|
|
12
|
+
cof extract clara.cof --identity clara-mercier --all-audiences -o clara-sfw/ # sans nudité ni intime, médias des souvenirs explicites retirés (gist conservé)
|
|
13
|
+
cof extract clara.cof --preset default --keep-personal -o clara-perso/ # garde les souvenirs et nœuds de psyché `visibility: personal` (retirés par défaut)
|
|
14
|
+
cof extract clara.cof --preset default --no-risk -o clara-sans-risque/ # purge de risque (RFC 0004) : retire les nœuds `inappropriate` et `dangerous` (et les contradictions amputées), tags.content corrigés ; --all-audiences les retire aussi
|
|
15
|
+
cof merge clara.cof martien.cof -o duo/ # un casting : même nom + surnom + statut fictif + morphologie ⇒ même personnage, sinon plusieurs
|
|
16
|
+
cof memory add clara.cof --gist fr="Ce matin, relu avec Léo." --gist en="This morning, reread with Léo." --date 2026-10-25 --who "Léo" --what "le carnet" --what "item=appearance/x1" --tag travail --personal # --what : un objet (1.2, RFC 0005), un nom et/ou item=<élément>, |shown s'il est dans un média
|
|
17
|
+
cof memory add clara/ --kind period --gist en="The agency years." --age 24 --approx --fidelity faded # sur un dossier ; `--help` liste tout (--where, --self-shown, --media, --preset…)
|
|
18
|
+
cof psyche add clara.cof --kind stance --gist fr="Envers l'utilisateur : une collègue." --about user --strength 60 --stability shifting --link because=memories/ev3 --since-date 2026-10-25 # nœud vécu, `visibility: personal` (--canon sinon), première révision ; `--help` liste tout (--lie, --risk, --tag, --preset…)
|
|
19
|
+
cof psyche add clara.cof --kind habit --gist fr="Garde la guitare près du bureau." --who "ma grand-mère" --where "environment=appearance/e1" --what "ma guitare|item=appearance/x1" --canon # personnes, lieux, objets du nœud (RFC 0005) ; une personne du casting : --who identity=<id> (les liens --link ne visent que souvenirs et nœuds)
|
|
20
|
+
cof psyche add clara.cof --kind stance --gist fr="Envers l'utilisateur : de la chaleur." --about user --valence 60 --aware partly --canon # RFC 0004 § 3 nonies : --valence −100…+100 (position ou goût seulement), --aware yes|partly|no, --until-age / --until-date (quand le nœud a cessé d'être tenu)
|
|
21
|
+
cof psyche add clara.cof --kind fear --gist fr="Perdre le dernier carnet." --image carnet.png --canon # RFC 0004 § 3 decies : une illustration du nœud (images seulement, la première remplace l'icône, 3 au plus) ; --self-shown --age N si elle montre le personnage (l'âge entre dans les règles des mineurs)
|
|
22
|
+
cof psyche propose clara.cof --preset fr-agent --from-file proposition.json # personnalité → psyché : une proposition validée (docs/psyche-propose.md), affichée en table, rien d'écrit
|
|
23
|
+
cof psyche propose clara.cof --from-file proposition.json --apply --accept c2,c3 # n'écrit que les candidats acceptés ; --rules (listes 1.0), --zodiac vierge, --mbti INFJ, --enneagram 4w5, --big-five O=80,C=35,E=20,A=70,N=60, --bundle-out, --provider openai-compatible (clé : COF_AI_KEY)
|
|
24
|
+
cof psyche text clara.cof --preset fr-agent # l'inverse : le texte « Qui elle est » ; --into-card l'ajoute à la suite du champ personnalité de la carte
|
|
25
|
+
cof import carte.png -o perso/ --age 30 --lang fr --keep-png # carte PNG CCv2/V3 → dossier COF
|
|
26
|
+
cof export clara.cof --format png -o clara.png # → PNG avec chunks chara + ccv3
|
|
27
|
+
cof export clara.cof --format card -o clara.card.json
|
|
28
|
+
cof export clara.cof --format soul -o ./agent/ # → SOUL.md + IDENTITY.md
|
|
29
|
+
cof export clara.cof --format agent -o ./agent/ # → espace de travail d'agent : SOUL.md (avec « Qui elle est » rendu depuis la psyché), IDENTITY.md, skills/, MEMORY.md + memories/ (--keep-personal, --keep-dangerous, --preset)
|
|
30
|
+
cof embed-text clara.png fiche.md -o clara-fiche.png # texte descriptif dans un PNG (iTXt), lisible par le builder
|
|
31
|
+
cof read-text clara-fiche.png
|
|
32
|
+
cof migrate dossier-v0.5/ # v0.2 … v0.5 → 1.0
|
|
33
|
+
cof migrate clara/ --psyche # 1.2 : les listes goals / fears / values / behavior deviennent des nœuds de psyché (les listes restent ; idempotent)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Ce que `validate` vérifie : la structure de l'archive (sentinelle `mimetype`, chemins sûrs, pas d'entrée en double ni chiffrée, taux de compression, taille), les hashes SHA-256 et tailles des assets, les schémas JSON du manifeste et des sous-fichiers (`card`, `psyche`, `weights`, `voice-profile`, `memory`…), la résolution des presets (slots, alternatives, `extends`, `derives_from`), les identifiants d'assets et de déclinaisons, les règles d'âge sur l'**âge le plus bas** d'un preset (déclinaisons appliquées et offertes, `age_override`, souvenirs qui montrent le personnage), l'interdiction de tout contenu nu ou intime sous 18 ans, le consentement d'une personne réelle, les règles des souvenirs (RFC 0002 : forme de `when`, liens, `media_from`, nœuds explicites — qui est montré, âges connus et adultes, âge vécu ≥ 18, drapeau `nudity`, `tags.content`), les relations entre personnages d'un casting (RFC 0003), les styles mélangés, les transcriptions des échantillons de voix, le contenu exécutable non déclaré, les doublons, les budgets de tokens ; puis recalcule la complétude et les cibles prêtes. En 1.2, il vérifie aussi la psyché (RFC 0004) : fichier `psyche-node.json` de chaque nœud, cibles des liens et de `about`, `supports` / `conflicts` entre nœuds seulement, une `contradiction` à exactement deux `conflicts`, `false_but_held` sur une `belief` et `about` sur une `stance` seulement, pas de cycle de `because`, miroir de `strength`, un nœud ne s'appuie que sur les souvenirs de son personnage, cohérence `risk` ↔ `tags.content` (`psyche-inappropriate`, `psyche-dangerous`) et `cof: "1.2"` déclaré ; les personnes, lieux et objets (RFC 0005) : `what` des souvenirs, `who` / `where` / `what` des nœuds — identité, environnement ou objet (`item`) résolus et du même personnage dans un casting, un nœud sans lien vers `identities/…` (les personnes vont dans `who`), `cof: "1.2"` déclaré ; un `item` qui n'est pas un accessoire ou un lieu qui n'est pas un environnement est un avertissement ; les informations non bloquantes s'affichent en lignes `INFO`. Les chemins et noms lus dans un manifeste ne sortent jamais du dossier de sortie (`export`, `extract`, `merge`).
|
|
37
|
+
|
|
38
|
+
Tests : `pytest` (dossier `cli/`, 88 tests) ; le corpus négatif de `tests/invalid/` (80 cas, un par règle) est régénéré par `python tests/invalid/build.py`. Tokens : installer `tiktoken` pour un comptage exact (sinon heuristique par caractères).
|
|
@@ -169,7 +169,7 @@ def cast_rules(manifest: dict, src: Path, rep) -> None:
|
|
|
169
169
|
# a relation that began after the age the preset shows (coherence, RFC 0003 § 6)
|
|
170
170
|
from .model import preset_age, preset_owner
|
|
171
171
|
for pid in (manifest.get("presets") or {}):
|
|
172
|
-
pa = preset_age(manifest, pid, ignore={"memories"})
|
|
172
|
+
pa = preset_age(manifest, pid, ignore={"memories", "psyche"})
|
|
173
173
|
oid = preset_owner(manifest, pid)
|
|
174
174
|
if pa is None or not oid:
|
|
175
175
|
continue
|