cof-cli 1.2.2__tar.gz → 1.2.3__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.
Files changed (88) hide show
  1. cof_cli-1.2.3/PKG-INFO +75 -0
  2. cof_cli-1.2.3/README.md +58 -0
  3. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/__init__.py +1 -1
  4. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/agents.py +18 -7
  5. cof_cli-1.2.3/cof_cli/agesignals.py +226 -0
  6. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/cast.py +1 -1
  7. cof_cli-1.2.3/cof_cli/charx.py +755 -0
  8. cof_cli-1.2.3/cof_cli/cli.py +1614 -0
  9. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/container.py +20 -2
  10. cof_cli-1.2.3/cof_cli/convert.py +1457 -0
  11. cof_cli-1.2.3/cof_cli/draft.py +1047 -0
  12. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/memories.py +33 -14
  13. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/model.py +22 -4
  14. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/ops.py +347 -51
  15. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/platform_import.py +65 -2
  16. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/psyche.py +58 -12
  17. cof_cli-1.2.3/cof_cli/safejson.py +62 -0
  18. cof_cli-1.2.3/cof_cli/selection.py +1022 -0
  19. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/selfdesc.py +87 -8
  20. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/validate.py +125 -15
  21. cof_cli-1.2.3/cof_cli.egg-info/PKG-INFO +75 -0
  22. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli.egg-info/SOURCES.txt +36 -1
  23. {cof_cli-1.2.2 → cof_cli-1.2.3}/pyproject.toml +1 -1
  24. cof_cli-1.2.3/tests/test_ageless.py +220 -0
  25. {cof_cli-1.2.2 → cof_cli-1.2.3}/tests/test_agents.py +3 -3
  26. cof_cli-1.2.3/tests/test_agesignals.py +115 -0
  27. cof_cli-1.2.3/tests/test_card_psyche_charx.py +315 -0
  28. cof_cli-1.2.3/tests/test_charx_import.py +228 -0
  29. cof_cli-1.2.3/tests/test_draft.py +206 -0
  30. cof_cli-1.2.3/tests/test_hard_rule_matrix.py +732 -0
  31. cof_cli-1.2.3/tests/test_lived_young.py +251 -0
  32. {cof_cli-1.2.2 → cof_cli-1.2.3}/tests/test_platform_import.py +3 -2
  33. cof_cli-1.2.3/tests/test_png_card_image_fit.py +61 -0
  34. cof_cli-1.2.3/tests/test_r31a_f3_draft_audience_parity.py +61 -0
  35. cof_cli-1.2.3/tests/test_r31a_r12_keep_intimate_images.py +52 -0
  36. cof_cli-1.2.3/tests/test_r31a_r6_intimate_scope.py +131 -0
  37. cof_cli-1.2.3/tests/test_r31b_f1_outputs.py +115 -0
  38. cof_cli-1.2.3/tests/test_r31b_f2_schema_and_hard_rules.py +79 -0
  39. cof_cli-1.2.3/tests/test_r31b_f3_draft_audience.py +44 -0
  40. cof_cli-1.2.3/tests/test_r31b_f4f5_validate_tracebacks.py +76 -0
  41. cof_cli-1.2.3/tests/test_r31b_r11_import_age_signal.py +60 -0
  42. cof_cli-1.2.3/tests/test_r31b_r6_real_intimate_scope.py +46 -0
  43. cof_cli-1.2.3/tests/test_r31b_regressions_122.py +36 -0
  44. cof_cli-1.2.3/tests/test_r31c_agent_withheld_consent.py +81 -0
  45. cof_cli-1.2.3/tests/test_r31c_charx_withheld_reason.py +78 -0
  46. cof_cli-1.2.3/tests/test_r31c_png_keep_intimate_rights.py +51 -0
  47. cof_cli-1.2.3/tests/test_r32d_merge_presets.py +368 -0
  48. cof_cli-1.2.3/tests/test_r32f_merge.py +327 -0
  49. cof_cli-1.2.3/tests/test_regression_residuals.py +109 -0
  50. cof_cli-1.2.3/tests/test_review_13nov.py +694 -0
  51. cof_cli-1.2.3/tests/test_review_13nov_e2e.py +272 -0
  52. {cof_cli-1.2.2 → cof_cli-1.2.3}/tests/test_roundtrip.py +20 -6
  53. cof_cli-1.2.3/tests/test_secret_rule.py +78 -0
  54. cof_cli-1.2.3/tests/test_selection.py +262 -0
  55. cof_cli-1.2.3/tests/test_style_tag.py +10 -0
  56. cof_cli-1.2.3/tests/test_version.py +18 -0
  57. cof_cli-1.2.2/PKG-INFO +0 -58
  58. cof_cli-1.2.2/README.md +0 -41
  59. cof_cli-1.2.2/cof_cli/cli.py +0 -847
  60. cof_cli-1.2.2/cof_cli/convert.py +0 -576
  61. cof_cli-1.2.2/cof_cli.egg-info/PKG-INFO +0 -58
  62. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/completeness.py +0 -0
  63. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/migrate.py +0 -0
  64. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/profiles.py +0 -0
  65. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/propose.py +0 -0
  66. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/attitude.schema.json +0 -0
  67. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/body.schema.json +0 -0
  68. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/card.schema.json +0 -0
  69. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/consent.schema.json +0 -0
  70. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/garments-1.0.json +0 -0
  71. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/hair.schema.json +0 -0
  72. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/manifest.schema.json +0 -0
  73. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/memory.schema.json +0 -0
  74. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/pose.schema.json +0 -0
  75. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/psyche-node.schema.json +0 -0
  76. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/psyche.schema.json +0 -0
  77. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/skeleton.schema.json +0 -0
  78. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/visemes.schema.json +0 -0
  79. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/voice-profile.schema.json +0 -0
  80. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/schemas/weights.schema.json +0 -0
  81. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/tokens.py +0 -0
  82. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli/zodiac.py +0 -0
  83. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli.egg-info/dependency_links.txt +0 -0
  84. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli.egg-info/entry_points.txt +0 -0
  85. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli.egg-info/requires.txt +0 -0
  86. {cof_cli-1.2.2 → cof_cli-1.2.3}/cof_cli.egg-info/top_level.txt +0 -0
  87. {cof_cli-1.2.2 → cof_cli-1.2.3}/setup.cfg +0 -0
  88. {cof_cli-1.2.2 → cof_cli-1.2.3}/tests/test_hunt.py +0 -0
cof_cli-1.2.3/PKG-INFO ADDED
@@ -0,0 +1,75 @@
1
+ Metadata-Version: 2.4
2
+ Name: cof-cli
3
+ Version: 1.2.3
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é), souvenirs explicites sans média retirés en entier, allowSexualUsage à false
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 (une ligne `note:` le dit), sinon plusieurs ; 1.2.3 : chaque personnage garde ses presets (et leur `extends`), souvenirs, psyché, médias et relations, aucun identifiant renommé n'en écrase un autre ; le fichier déclare la version `cof` la plus haute de ses sources ; `tags.content` = l'union des sources ; la marque de licence (`tags.ip`, une par fichier) = la lecture la plus protectrice des sources (une ligne `note:` dit qu'elle vaut pour tout le fichier) ; `-o` désigne toujours un dossier, même nommé `x.cof` (`cof pack` ensuite)
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 memory add clara.cof --from-agent ./agent/ # le retour : les notes du jour d'un espace OpenClaw (memory/AAAA-MM-JJ.md) ou les entrées § d'un profil Hermes (memories/MEMORY.md) deviennent des souvenirs vécus, personnels, datés, étiquetés lived:<hôte>, avec l'âge de vie du préréglage à côté de la date (`--date` seul reçoit aussi cet âge quand la date n'est pas antérieure au présent) ; idempotent (--agent-source, --lang). 1.2.3 : un souvenir vécu n'est listé QUE dans le preset où il a été vécu — `--preset`, sinon le preset par défaut du personnage (dit dans la sortie) ; un preset mineur seulement s'il est nommé seul par `--preset` ; adulte et mineur ensemble : refusé
36
+ cof memory unlist clara.cof ev15 --preset en-12 # 1.2.3 : retire un souvenir de la liste d'un preset (supprimé en entier si plus aucun preset ne le liste) ; --lived-young retire d'un coup tout souvenir vécu dans un présent adulte qu'un preset mineur ou d'âge inconnu liste (ce que `cof validate` signale ; les fichiers de la 1.2.2 listaient un souvenir de --from-agent dans tous les presets)
37
+ 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…)
38
+ 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)
39
+ 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)
40
+ 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)
41
+ 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
42
+ 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)
43
+ 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
44
+ cof select clara.cof --context "Parle-moi du Martien" --budget 10 --json # 1.2.3 (IMPLEMENTING § 7 quater) : ce qu'un hôte injecterait pour ce tour — souvenirs et nœuds du preset filtrés (personnels, secrets, dangereux, explicites, temps, consentement), notés (saillance ou force, focus, mots du tour, liens, récence, fidélité), choisis sous un budget (12 éléments, ou 600t en tokens ; les nœuds `core` toujours, comptés dedans) ; --focus tag:… label:… user memories/ev3 appearance/x1 (après le fichier : `cof select clara.cof --focus tag:x user`), --now 29|AAAA-MM-JJ (une vraie date), --temperature 8 --seed 7 (tirage softmax reproductible), --period-cap, --personal, --keep-secrets, --keep-dangerous, --allow-explicit, --no-unknown-age-minor (par défaut, comme le player, un âge inconnu compte comme mineur pour les nœuds `inappropriate`) ; sans --json, le texte rendu (« Qui elle est » puis « Souvenirs »)
45
+ cof import carte.png -o perso/ --age 30 --lang fr --keep-png # carte PNG CCv2/V3 → dossier COF ; 1.2.3 : avec un --age de 18 ou plus, le texte de la carte est lu, et un indice de minorité donne un avertissement (« declared age N despite a minor signal »), jamais un blocage
46
+ cof import perso.charx -o perso/ --age 30 # 1.2.3 : conteneur CHARX (Character Card V3) → dossier COF : la carte comme une carte PNG/JSON (tous les champs V3, character_book = lorebook du preset), l'icône `main` → vue de face de la tête (l'avatar : --age requis, ou --no-avatar), les `emotion` → images d'expression, les `background` → décors (le `main` appliqué), `user_icon` et types propres à une plateforme gardés sous extensions/charx/ seulement quand leur contenu (pas l'extension annoncée) est une image PNG, JPEG, WebP ou GIF, un son OGG, MP3, WAV ou FLAC, ou du JSON / texte brut — écrits sous leur vraie extension ; tout le reste (code, balisage, exécutable, extension de code annoncée) n'est jamais écrit ; `embeded://`, `__asset:` (ancien), `data:` lus ; `ccdefault:` noté ; une URI http(s) jamais téléchargée (gardée comme référence dans manifest.extensions.charx). Archive bornée comme les exports de plateformes : un chemin dangereux, un membre trop gros ou trop compressé, deux membres du même nom, un lien symbolique ou un nom non UTF-8 refuse tout le fichier. Retour de notre propre export (x_cof.json) : les entrées de lorebook issues des souvenirs canon redeviennent des souvenirs (une entrée modifiée dans le CHARX garde le texte modifié, une entrée désactivée reste une entrée désactivée), le texte « Qui elle est » redevient les nœuds de psyché (pas de doublon), genre restauré. x_cof.json n'est pas vérifié : il ne peut que restreindre — droits laissés aux valeurs prudentes (seul un minUserAge est repris ; les lignes CHECK disent ce qui ne l'a pas été), `original` jamais mis à vrai par lui (une carte importée est d'origine inconnue, `original: false`, sauf --original), étiquettes de contenu vérifiées, jamais de souvenir explicite ; l'âge le plus bas qu'une source déclare compte pour la règle des mineurs, et --age ne peut pas relever un âge déclaré mineur. Le rapport dit ce qui n'a pas pu être restauré. --inspect fonctionne sur un CHARX (valeurs masquées)
47
+ cof draft build brouillon.json -o perso/ # 1.2.3 (docs/draft-contract.md) : le brouillon JSON qu'écrit un modèle de langage → dossier COF validé (règles dures appliquées : mineur, personne réelle, personnage sous licence ; --audience minor) ; même résultat que le builder (tools/shared/cofdraft.js), sans images
48
+ cof export clara.cof --format png -o clara.png # → PNG avec chunks chara + ccv3 (la carte de --format card)
49
+ cof export clara.cof --format card -o clara.card.json # → Character Card V3 du preset ; une personnalité en texte libre (kind description) donne une carte construite : nom, texte en description, salutation du preset en first_mes. Avec une psyché, le texte « Qui elle est » (celui de SOUL.md) est ajouté à la suite de data.personality, jamais à la place du texte de l'auteur ni dans system_prompt ; les ids des nœuds rendus vont dans data.extensions.cof.psyche_nodes, les droits dans data.extensions.cof.rights. « Permissif mais il prévient » : nœuds personnels, `dangerous` et `secret` laissés de côté par défaut (--keep-personal, --keep-dangerous, --keep-secrets : les secrets sont alors marqués `secret`, avec une ligne disant que le personnage ne les révèle jamais), images intimes ou nues laissées de côté (--keep-intimate, qui ne les inclut que si les droits de l'auteur autorisent l'usage sexuel — allowSexualUsage — et, pour une personne réelle, avec la portée de consentement `intimate`) ; une ligne WARN dit ce qui a été laissé et le drapeau qui l'inclut, une autre ce qui a été inclus à la demande. `inappropriate` toujours retiré d'un preset mineur. Seules les règles dures arrêtent l'export — de tous les formats (agent, hermes, soul, card, png, charx), quels que soient les drapeaux : mineur et contenu intime ou nudité (--keep-intimate refusé pour un preset de moins de 18 ans ou d'âge inconnu), personne réelle sans consentement valide pour l'usage (`conversational-persona`, et `likeness-image` si une image part ; une date `granted`, une date `expires` lisible et non dépassée — illisible vaut expirée —, `age_of_subject_at_consent` ≥ 18), personnage dont tags.ip nomme une franchise ou une œuvre source sans `modification` explicitement permise (absente vaut interdite) ; les autres erreurs de `cof validate` deviennent un avertissement, --strict garde l'ancien refus. Une image partagée avec une variante intime est intime ; une image exportée (PNG, CHARX, avatar d'agent) perd ses métadonnées (EXIF, XMP, ancienne carte, prompt) ; un lien symbolique dans un dossier n'est jamais lu (une ligne WARN le dit, en PNG comme en CHARX)
50
+ cof export clara.cof --format charx -o clara.charx # → conteneur CHARX (Character Card V3) : card.json (la même carte, avec la psyché), icône principale (vue de face de la tête, sinon image principale du preset), expressions en assets `emotion`, décor en `background` (chemins assets/<type>/images/, URI embeded://), lorebook = celui du preset + une entrée par souvenir canon (gist dans la langue du preset, clés : étiquettes, personnes, lieu, objets ; souvenirs personnels, secrets et explicites laissés de côté sauf --keep-personal, --keep-secrets, --keep-intimate — un souvenir explicite exige aussi allowSexualUsage dans les droits de l'auteur, comme `cof select`, et pour une personne réelle la portée de consentement `intimate` — `nudity` ou `intimate` pour un souvenir `explicit: nudity`), x_cof.json (jamais rien de ce que l'export a retenu : ni lien vers un souvenir laissé de côté, ni révisions, ni felt_* ; version, source, preset, ce qui a été laissé de côté et ce qu'un CHARX ne porte pas : voix, mouvement, 3D, médias des souvenirs, droits en texte seulement ; et, pour le retour par `cof import`, les nœuds exportés, le texte de la psyché, langue, âge, genre, étiquettes de contenu). Mêmes avertissements et mêmes règles dures que --format card
51
+ cof export clara.cof --format soul -o ./agent/ # → SOUL.md + IDENTITY.md
52
+ cof diff clara.cof rebuilt.cof # ce qui diffère entre deux .cof : membres, octets, clés JSON (code de sortie 1 si différent) — l'outil de la promesse « rien d'autre ne bouge » du builder
53
+ 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, AGENTS.md (consignes de mémoire pour l'hôte), skills/, MEMORY.md, COF.md (--keep-personal, --keep-dangerous, --keep-secrets, --keep-intimate, --preset) ; les souvenirs explicites restent dans le .cof sauf --keep-intimate ET allowSexualUsage dans les droits de l'auteur, et pour une personne réelle la portée de consentement qui convient (jamais pour un preset mineur ou d'âge inconnu ; leurs médias jamais), comme card / png / charx, avec la même ligne WARN ; les souvenirs ET les nœuds de psyché `disclosure: secret` restent dans le .cof sauf --keep-secrets (la ligne « WARN left out: secret … (--keep-secrets) », la même pour card, png, charx, agent, hermes et soul), qui les inclut, marqués `secret` : les souvenirs dans MEMORY.md (AGENTS.md ajoute une ligne : ce sont des secrets que le personnage ne révèle jamais), les nœuds dans une sous-section « What she never tells » de « Who she is » (jamais dans le texte ouvert), avec la même ligne (H5-11, une seule règle)
54
+ cof export clara.cof --format hermes -o ./hermes/ # → profil Hermes Agent (HERMES_HOME) : SOUL.md (identité fusionnée), memories/MEMORY.md en entrées § sous le plafond de l'hôte (2 200 caractères, les plus saillants), skills/, COF.md ; mêmes options, secrets laissés de côté par défaut (avec --keep-secrets : entrées préfixées « (secret) », la ligne dans SOUL.md)
55
+ cof embed-text clara.png fiche.md -o clara-fiche.png # texte descriptif dans un PNG (iTXt), lisible par le builder
56
+ cof read-text clara-fiche.png
57
+ cof migrate dossier-v0.5/ # v0.2 … v0.5 → 1.0
58
+ cof migrate clara/ --psyche # 1.2 : les listes goals / fears / values / behavior deviennent des nœuds de psyché (les listes restent ; idempotent)
59
+ ```
60
+
61
+ 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`).
62
+
63
+ **Règles dures, sur chaque sortie (1.2.3).** Trois choses ne se forcent jamais (« COF est permissif mais il prévient ») : (1) rien d'intime ni de nu avec un mineur — âge déclaré, âge apparent d'une image, âge inconnu ; (2) le consentement des personnes réelles ; (3) les droits des personnages sous licence. `tests/test_hard_rule_matrix.py` les vérifie pour chaque commande qui écrit quelque chose qu'un tiers peut recevoir (pack, extract et ses purges, export dans les six formats × les drapeaux `--keep-*`, select texte et `--json`, psyche text, memory add, merge, import carte / PNG / CHARX hostile / Character.AI, draft build) : le contenu interdit est absent de chaque octet écrit (arbres et archives fouillés), la commande refuse ou retire avec son message ; une commande ou un format ajouté plus tard fait échouer le test tant qu'il n'est pas dans la table. Ce que la table a fait corriger : `cof pack --force` ne passe jamais outre une erreur de règle dure (un consentement donné avant 18 ans en est une) ; `cof extract` et `cof merge` refusent un résultat qui en enfreint une — il est construit dans un dossier temporaire et n'atteint jamais `-o`, qui reste tel qu'il était (une sortie qui est l'entrée est refusée avant toute écriture, pour `export`, `psyche text --out` et `psyche propose --out` aussi) —, et `extract` retire des presets mineurs ou d'âge inconnu les souvenirs explicites ; `cof psyche text` refuse une personne réelle sans consentement et un personnage sous licence qui interdit la modification ; `cof import` (carte, PNG, CHARX, Character.AI) s'arrête sur une carte qui se lit comme sexuelle avec un âge de moins de 18 ans (et ne garde pas son image sans âge) ; `cof pack` affiche les avertissements qui touchent une règle dure ; `cof validate` signale un consentement expiré. Depuis la revue du 18 novembre, une erreur de schéma ne masque plus les règles dures : `validate`, `pack --force` et `merge` les vérifient quand même, et une règle qui n'a pas pu être vérifiée compte comme une erreur de règle dure. Une personne réelle sans consentement reste un avertissement dans le fichier de l'auteur (pack, extract, merge, memory add, import l'écrivent en le disant) ; chaque export, `cof select` et le lecteur refusent une personne réelle **non publique** sans consentement.
64
+
65
+ **Personnes réelles : trois statuts (décision du 13 novembre 2026, `docs/IMPLEMENTING.md` § 6 bis).** « Fictif ? » a trois réponses : fictif ; personne réelle **non publique** (consentement requis — le défaut de `fictional: false`, un ancien fichier compris) ; personne réelle **publique**, déclarée par l'auteur (consentement recommandé). Le format 1.2 n'a pas de champ pour ce dernier cas : les outils 1.2.3 écrivent `public_figure: true` à côté de `fictional: false` (l'identité, et la copie à la racine pour le personnage par défaut), une clé que les schémas 1.2 et la CLI 1.2.2 acceptent ; elle deviendra un champ du format 1.3. Une seule fonction décide, `selection.person_use` (= `COFSELECT.personUse`) : une personne publique est jouée et exportée sans consentement **avec un avertissement** (texte et ses propres images) ; une image générée à sa ressemblance, le contenu intime ou nu et une voix demandent leur portée ; une personne réelle de moins de 18 ans est toujours non publique. « Publique » ne se vérifie pas : c'est la déclaration de l'auteur, qui en répond.
66
+
67
+ ```
68
+ cof rights person clara.cof --public # personne réelle publique, déclarée par vous (--private : non publique ; --fictional ; --identity ID dans un casting)
69
+ cof age ember.cof --adult # « adulte, sans âge précis » (âge 18 déclaré, marqueur ageless_adult ; refusé sur un indice de minorité) ; --remove le retire ; cof import carte.png --adult à l'import
70
+ cof import carte.png --real --public-figure # import d'une personne réelle publique (--real seul : non publique)
71
+ ```
72
+
73
+ Rapport d'import : la première ligne « CHECK » est celle de l'origine — `--original` si le personnage est votre création originale ; sans lui, origine inconnue (`tags.ip.original` faux).
74
+
75
+ Tests : `pytest` (dossier `cli/`) ; le corpus négatif de `tests/invalid/` (92 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).
@@ -0,0 +1,58 @@
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é), souvenirs explicites sans média retirés en entier, allowSexualUsage à false
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 (une ligne `note:` le dit), sinon plusieurs ; 1.2.3 : chaque personnage garde ses presets (et leur `extends`), souvenirs, psyché, médias et relations, aucun identifiant renommé n'en écrase un autre ; le fichier déclare la version `cof` la plus haute de ses sources ; `tags.content` = l'union des sources ; la marque de licence (`tags.ip`, une par fichier) = la lecture la plus protectrice des sources (une ligne `note:` dit qu'elle vaut pour tout le fichier) ; `-o` désigne toujours un dossier, même nommé `x.cof` (`cof pack` ensuite)
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 memory add clara.cof --from-agent ./agent/ # le retour : les notes du jour d'un espace OpenClaw (memory/AAAA-MM-JJ.md) ou les entrées § d'un profil Hermes (memories/MEMORY.md) deviennent des souvenirs vécus, personnels, datés, étiquetés lived:<hôte>, avec l'âge de vie du préréglage à côté de la date (`--date` seul reçoit aussi cet âge quand la date n'est pas antérieure au présent) ; idempotent (--agent-source, --lang). 1.2.3 : un souvenir vécu n'est listé QUE dans le preset où il a été vécu — `--preset`, sinon le preset par défaut du personnage (dit dans la sortie) ; un preset mineur seulement s'il est nommé seul par `--preset` ; adulte et mineur ensemble : refusé
19
+ cof memory unlist clara.cof ev15 --preset en-12 # 1.2.3 : retire un souvenir de la liste d'un preset (supprimé en entier si plus aucun preset ne le liste) ; --lived-young retire d'un coup tout souvenir vécu dans un présent adulte qu'un preset mineur ou d'âge inconnu liste (ce que `cof validate` signale ; les fichiers de la 1.2.2 listaient un souvenir de --from-agent dans tous les presets)
20
+ 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…)
21
+ 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)
22
+ 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)
23
+ 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)
24
+ 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
25
+ 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)
26
+ 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
27
+ cof select clara.cof --context "Parle-moi du Martien" --budget 10 --json # 1.2.3 (IMPLEMENTING § 7 quater) : ce qu'un hôte injecterait pour ce tour — souvenirs et nœuds du preset filtrés (personnels, secrets, dangereux, explicites, temps, consentement), notés (saillance ou force, focus, mots du tour, liens, récence, fidélité), choisis sous un budget (12 éléments, ou 600t en tokens ; les nœuds `core` toujours, comptés dedans) ; --focus tag:… label:… user memories/ev3 appearance/x1 (après le fichier : `cof select clara.cof --focus tag:x user`), --now 29|AAAA-MM-JJ (une vraie date), --temperature 8 --seed 7 (tirage softmax reproductible), --period-cap, --personal, --keep-secrets, --keep-dangerous, --allow-explicit, --no-unknown-age-minor (par défaut, comme le player, un âge inconnu compte comme mineur pour les nœuds `inappropriate`) ; sans --json, le texte rendu (« Qui elle est » puis « Souvenirs »)
28
+ cof import carte.png -o perso/ --age 30 --lang fr --keep-png # carte PNG CCv2/V3 → dossier COF ; 1.2.3 : avec un --age de 18 ou plus, le texte de la carte est lu, et un indice de minorité donne un avertissement (« declared age N despite a minor signal »), jamais un blocage
29
+ cof import perso.charx -o perso/ --age 30 # 1.2.3 : conteneur CHARX (Character Card V3) → dossier COF : la carte comme une carte PNG/JSON (tous les champs V3, character_book = lorebook du preset), l'icône `main` → vue de face de la tête (l'avatar : --age requis, ou --no-avatar), les `emotion` → images d'expression, les `background` → décors (le `main` appliqué), `user_icon` et types propres à une plateforme gardés sous extensions/charx/ seulement quand leur contenu (pas l'extension annoncée) est une image PNG, JPEG, WebP ou GIF, un son OGG, MP3, WAV ou FLAC, ou du JSON / texte brut — écrits sous leur vraie extension ; tout le reste (code, balisage, exécutable, extension de code annoncée) n'est jamais écrit ; `embeded://`, `__asset:` (ancien), `data:` lus ; `ccdefault:` noté ; une URI http(s) jamais téléchargée (gardée comme référence dans manifest.extensions.charx). Archive bornée comme les exports de plateformes : un chemin dangereux, un membre trop gros ou trop compressé, deux membres du même nom, un lien symbolique ou un nom non UTF-8 refuse tout le fichier. Retour de notre propre export (x_cof.json) : les entrées de lorebook issues des souvenirs canon redeviennent des souvenirs (une entrée modifiée dans le CHARX garde le texte modifié, une entrée désactivée reste une entrée désactivée), le texte « Qui elle est » redevient les nœuds de psyché (pas de doublon), genre restauré. x_cof.json n'est pas vérifié : il ne peut que restreindre — droits laissés aux valeurs prudentes (seul un minUserAge est repris ; les lignes CHECK disent ce qui ne l'a pas été), `original` jamais mis à vrai par lui (une carte importée est d'origine inconnue, `original: false`, sauf --original), étiquettes de contenu vérifiées, jamais de souvenir explicite ; l'âge le plus bas qu'une source déclare compte pour la règle des mineurs, et --age ne peut pas relever un âge déclaré mineur. Le rapport dit ce qui n'a pas pu être restauré. --inspect fonctionne sur un CHARX (valeurs masquées)
30
+ cof draft build brouillon.json -o perso/ # 1.2.3 (docs/draft-contract.md) : le brouillon JSON qu'écrit un modèle de langage → dossier COF validé (règles dures appliquées : mineur, personne réelle, personnage sous licence ; --audience minor) ; même résultat que le builder (tools/shared/cofdraft.js), sans images
31
+ cof export clara.cof --format png -o clara.png # → PNG avec chunks chara + ccv3 (la carte de --format card)
32
+ cof export clara.cof --format card -o clara.card.json # → Character Card V3 du preset ; une personnalité en texte libre (kind description) donne une carte construite : nom, texte en description, salutation du preset en first_mes. Avec une psyché, le texte « Qui elle est » (celui de SOUL.md) est ajouté à la suite de data.personality, jamais à la place du texte de l'auteur ni dans system_prompt ; les ids des nœuds rendus vont dans data.extensions.cof.psyche_nodes, les droits dans data.extensions.cof.rights. « Permissif mais il prévient » : nœuds personnels, `dangerous` et `secret` laissés de côté par défaut (--keep-personal, --keep-dangerous, --keep-secrets : les secrets sont alors marqués `secret`, avec une ligne disant que le personnage ne les révèle jamais), images intimes ou nues laissées de côté (--keep-intimate, qui ne les inclut que si les droits de l'auteur autorisent l'usage sexuel — allowSexualUsage — et, pour une personne réelle, avec la portée de consentement `intimate`) ; une ligne WARN dit ce qui a été laissé et le drapeau qui l'inclut, une autre ce qui a été inclus à la demande. `inappropriate` toujours retiré d'un preset mineur. Seules les règles dures arrêtent l'export — de tous les formats (agent, hermes, soul, card, png, charx), quels que soient les drapeaux : mineur et contenu intime ou nudité (--keep-intimate refusé pour un preset de moins de 18 ans ou d'âge inconnu), personne réelle sans consentement valide pour l'usage (`conversational-persona`, et `likeness-image` si une image part ; une date `granted`, une date `expires` lisible et non dépassée — illisible vaut expirée —, `age_of_subject_at_consent` ≥ 18), personnage dont tags.ip nomme une franchise ou une œuvre source sans `modification` explicitement permise (absente vaut interdite) ; les autres erreurs de `cof validate` deviennent un avertissement, --strict garde l'ancien refus. Une image partagée avec une variante intime est intime ; une image exportée (PNG, CHARX, avatar d'agent) perd ses métadonnées (EXIF, XMP, ancienne carte, prompt) ; un lien symbolique dans un dossier n'est jamais lu (une ligne WARN le dit, en PNG comme en CHARX)
33
+ cof export clara.cof --format charx -o clara.charx # → conteneur CHARX (Character Card V3) : card.json (la même carte, avec la psyché), icône principale (vue de face de la tête, sinon image principale du preset), expressions en assets `emotion`, décor en `background` (chemins assets/<type>/images/, URI embeded://), lorebook = celui du preset + une entrée par souvenir canon (gist dans la langue du preset, clés : étiquettes, personnes, lieu, objets ; souvenirs personnels, secrets et explicites laissés de côté sauf --keep-personal, --keep-secrets, --keep-intimate — un souvenir explicite exige aussi allowSexualUsage dans les droits de l'auteur, comme `cof select`, et pour une personne réelle la portée de consentement `intimate` — `nudity` ou `intimate` pour un souvenir `explicit: nudity`), x_cof.json (jamais rien de ce que l'export a retenu : ni lien vers un souvenir laissé de côté, ni révisions, ni felt_* ; version, source, preset, ce qui a été laissé de côté et ce qu'un CHARX ne porte pas : voix, mouvement, 3D, médias des souvenirs, droits en texte seulement ; et, pour le retour par `cof import`, les nœuds exportés, le texte de la psyché, langue, âge, genre, étiquettes de contenu). Mêmes avertissements et mêmes règles dures que --format card
34
+ cof export clara.cof --format soul -o ./agent/ # → SOUL.md + IDENTITY.md
35
+ cof diff clara.cof rebuilt.cof # ce qui diffère entre deux .cof : membres, octets, clés JSON (code de sortie 1 si différent) — l'outil de la promesse « rien d'autre ne bouge » du builder
36
+ 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, AGENTS.md (consignes de mémoire pour l'hôte), skills/, MEMORY.md, COF.md (--keep-personal, --keep-dangerous, --keep-secrets, --keep-intimate, --preset) ; les souvenirs explicites restent dans le .cof sauf --keep-intimate ET allowSexualUsage dans les droits de l'auteur, et pour une personne réelle la portée de consentement qui convient (jamais pour un preset mineur ou d'âge inconnu ; leurs médias jamais), comme card / png / charx, avec la même ligne WARN ; les souvenirs ET les nœuds de psyché `disclosure: secret` restent dans le .cof sauf --keep-secrets (la ligne « WARN left out: secret … (--keep-secrets) », la même pour card, png, charx, agent, hermes et soul), qui les inclut, marqués `secret` : les souvenirs dans MEMORY.md (AGENTS.md ajoute une ligne : ce sont des secrets que le personnage ne révèle jamais), les nœuds dans une sous-section « What she never tells » de « Who she is » (jamais dans le texte ouvert), avec la même ligne (H5-11, une seule règle)
37
+ cof export clara.cof --format hermes -o ./hermes/ # → profil Hermes Agent (HERMES_HOME) : SOUL.md (identité fusionnée), memories/MEMORY.md en entrées § sous le plafond de l'hôte (2 200 caractères, les plus saillants), skills/, COF.md ; mêmes options, secrets laissés de côté par défaut (avec --keep-secrets : entrées préfixées « (secret) », la ligne dans SOUL.md)
38
+ cof embed-text clara.png fiche.md -o clara-fiche.png # texte descriptif dans un PNG (iTXt), lisible par le builder
39
+ cof read-text clara-fiche.png
40
+ cof migrate dossier-v0.5/ # v0.2 … v0.5 → 1.0
41
+ cof migrate clara/ --psyche # 1.2 : les listes goals / fears / values / behavior deviennent des nœuds de psyché (les listes restent ; idempotent)
42
+ ```
43
+
44
+ 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`).
45
+
46
+ **Règles dures, sur chaque sortie (1.2.3).** Trois choses ne se forcent jamais (« COF est permissif mais il prévient ») : (1) rien d'intime ni de nu avec un mineur — âge déclaré, âge apparent d'une image, âge inconnu ; (2) le consentement des personnes réelles ; (3) les droits des personnages sous licence. `tests/test_hard_rule_matrix.py` les vérifie pour chaque commande qui écrit quelque chose qu'un tiers peut recevoir (pack, extract et ses purges, export dans les six formats × les drapeaux `--keep-*`, select texte et `--json`, psyche text, memory add, merge, import carte / PNG / CHARX hostile / Character.AI, draft build) : le contenu interdit est absent de chaque octet écrit (arbres et archives fouillés), la commande refuse ou retire avec son message ; une commande ou un format ajouté plus tard fait échouer le test tant qu'il n'est pas dans la table. Ce que la table a fait corriger : `cof pack --force` ne passe jamais outre une erreur de règle dure (un consentement donné avant 18 ans en est une) ; `cof extract` et `cof merge` refusent un résultat qui en enfreint une — il est construit dans un dossier temporaire et n'atteint jamais `-o`, qui reste tel qu'il était (une sortie qui est l'entrée est refusée avant toute écriture, pour `export`, `psyche text --out` et `psyche propose --out` aussi) —, et `extract` retire des presets mineurs ou d'âge inconnu les souvenirs explicites ; `cof psyche text` refuse une personne réelle sans consentement et un personnage sous licence qui interdit la modification ; `cof import` (carte, PNG, CHARX, Character.AI) s'arrête sur une carte qui se lit comme sexuelle avec un âge de moins de 18 ans (et ne garde pas son image sans âge) ; `cof pack` affiche les avertissements qui touchent une règle dure ; `cof validate` signale un consentement expiré. Depuis la revue du 18 novembre, une erreur de schéma ne masque plus les règles dures : `validate`, `pack --force` et `merge` les vérifient quand même, et une règle qui n'a pas pu être vérifiée compte comme une erreur de règle dure. Une personne réelle sans consentement reste un avertissement dans le fichier de l'auteur (pack, extract, merge, memory add, import l'écrivent en le disant) ; chaque export, `cof select` et le lecteur refusent une personne réelle **non publique** sans consentement.
47
+
48
+ **Personnes réelles : trois statuts (décision du 13 novembre 2026, `docs/IMPLEMENTING.md` § 6 bis).** « Fictif ? » a trois réponses : fictif ; personne réelle **non publique** (consentement requis — le défaut de `fictional: false`, un ancien fichier compris) ; personne réelle **publique**, déclarée par l'auteur (consentement recommandé). Le format 1.2 n'a pas de champ pour ce dernier cas : les outils 1.2.3 écrivent `public_figure: true` à côté de `fictional: false` (l'identité, et la copie à la racine pour le personnage par défaut), une clé que les schémas 1.2 et la CLI 1.2.2 acceptent ; elle deviendra un champ du format 1.3. Une seule fonction décide, `selection.person_use` (= `COFSELECT.personUse`) : une personne publique est jouée et exportée sans consentement **avec un avertissement** (texte et ses propres images) ; une image générée à sa ressemblance, le contenu intime ou nu et une voix demandent leur portée ; une personne réelle de moins de 18 ans est toujours non publique. « Publique » ne se vérifie pas : c'est la déclaration de l'auteur, qui en répond.
49
+
50
+ ```
51
+ cof rights person clara.cof --public # personne réelle publique, déclarée par vous (--private : non publique ; --fictional ; --identity ID dans un casting)
52
+ cof age ember.cof --adult # « adulte, sans âge précis » (âge 18 déclaré, marqueur ageless_adult ; refusé sur un indice de minorité) ; --remove le retire ; cof import carte.png --adult à l'import
53
+ cof import carte.png --real --public-figure # import d'une personne réelle publique (--real seul : non publique)
54
+ ```
55
+
56
+ Rapport d'import : la première ligne « CHECK » est celle de l'origine — `--original` si le personnage est votre création originale ; sans lui, origine inconnue (`tags.ip.original` faux).
57
+
58
+ Tests : `pytest` (dossier `cli/`) ; le corpus négatif de `tests/invalid/` (92 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).
@@ -1,5 +1,5 @@
1
1
  """cof-cli — reference tooling for COF (Character Open File)."""
2
2
 
3
- __version__ = "1.2.2"
3
+ __version__ = "1.2.3"
4
4
  MIMETYPE = "application/vnd.cof.character+zip"
5
5
  SPEC_VERSION = "1.2"
@@ -83,7 +83,8 @@ def hermes_memory(entries: list[tuple[int, str]], limit: int = HERMES_MEMORY_CHA
83
83
  return text, len(entries) - len(kept)
84
84
 
85
85
 
86
- def export_hermes(src: Path, out: Path, preset: str | None = None, keep_personal: bool = False, keep_dangerous: bool = False, keep_secrets: bool = False) -> dict:
86
+ def export_hermes(src: Path, out: Path, preset: str | None = None, keep_personal: bool = False, keep_dangerous: bool = False, keep_secrets: bool = False,
87
+ likeness: bool = True, keep_intimate: bool = False) -> dict:
87
88
  """A Hermes Agent profile folder (to use as $HERMES_HOME, or to copy into one): SOUL.md (with the identity lines),
88
89
  memories/MEMORY.md (`§` entries within the host's limit), skills/, COF.md, README-COF.md. Built on export_agent.
89
90
  Secret memories stay behind unless `keep_secrets`; with it their entries carry `(secret)` and SOUL.md says they are never told."""
@@ -92,7 +93,8 @@ def export_hermes(src: Path, out: Path, preset: str | None = None, keep_personal
92
93
  from .convert import export_agent
93
94
  with tempfile.TemporaryDirectory(prefix="cof-hermes-") as td:
94
95
  ws = Path(td) / "ws"
95
- done = export_agent(src, ws, preset, keep_personal=keep_personal, keep_dangerous=keep_dangerous, keep_secrets=keep_secrets)
96
+ done = export_agent(src, ws, preset, keep_personal=keep_personal, keep_dangerous=keep_dangerous, keep_secrets=keep_secrets, likeness=likeness,
97
+ keep_intimate=keep_intimate)
96
98
  out.mkdir(parents=True, exist_ok=True)
97
99
  soul = (ws / "SOUL.md").read_text("utf-8").rstrip() + "\n"
98
100
  ident = (ws / "IDENTITY.md").read_text("utf-8") if (ws / "IDENTITY.md").is_file() else ""
@@ -100,7 +102,7 @@ def export_hermes(src: Path, out: Path, preset: str | None = None, keep_personal
100
102
  if block:
101
103
  head, _, rest = soul.partition("\n")
102
104
  soul = head + "\n\n" + block + "\n" + rest.lstrip("\n")
103
- entries = _memory_entries(src, preset, keep_personal, keep_secrets)
105
+ entries = _memory_entries(src, preset, keep_personal, keep_secrets, keep_intimate)
104
106
  if keep_secrets and done.get("secret_kept"): # Hermes has no AGENTS.md: SOUL.md is what it reads every session
105
107
  soul = soul.rstrip("\n") + "\n\n" + SECRETS_LINE.replace("(in `MEMORY.md`)", "(in `memories/MEMORY.md`)") + "\n"
106
108
  (out / "SOUL.md").write_text(soul, "utf-8")
@@ -130,14 +132,17 @@ def export_hermes(src: Path, out: Path, preset: str | None = None, keep_personal
130
132
  return done
131
133
 
132
134
 
133
- def _memory_entries(src: Path, pid: str | None, keep_personal: bool, keep_secrets: bool = False) -> list[tuple[int, str]]:
135
+ def _memory_entries(src: Path, pid: str | None, keep_personal: bool, keep_secrets: bool = False, keep_intimate: bool = False) -> list[tuple[int, str]]:
134
136
  """(salience, 'label (when): gist') per canon memory of the preset, timeline order."""
137
+ from .convert import explicit_memory_block
135
138
  from .memories import gist_text, load_nodes, preset_memories, timeline, when_label
136
139
  from .model import default_preset_id, resolve_variant
137
140
  manifest = json.loads((src / "manifest.json").read_text("utf-8"))
138
141
  pid = pid or default_preset_id(manifest)
142
+ from .selection import lived_out_of_reach
139
143
  nodes = load_nodes(src, manifest)
140
- vids = [v for v in preset_memories(manifest, pid) if v in nodes]
144
+ oor = lived_out_of_reach(manifest, nodes, pid) # lived with an adult preset, listed by a young one: never (1.2.3)
145
+ vids = [v for v in preset_memories(manifest, pid) if v in nodes and not oor(v)]
141
146
  out = []
142
147
  for vid in timeline(manifest, nodes, vids):
143
148
  node = nodes[vid]
@@ -147,8 +152,13 @@ def _memory_entries(src: Path, pid: str | None, keep_personal: bool, keep_secret
147
152
  if secret and not keep_secrets:
148
153
  continue # a secret never leaves with an agent that talks, unless asked (CLI-02)
149
154
  rv = resolve_variant(manifest, "memories", vid) or {}
155
+ if (node.get("explicit") or rv.get("nudity") is True) and explicit_memory_block(manifest, pid, keep_intimate, node, rv): # flag, rights, minor, consent scope (CB-01, CB-16, r31 R6)
156
+ continue
150
157
  lang, text = gist_text(manifest, vid, node, pid)
151
158
  when = when_label(rv.get("kind"), node, lang)
159
+ w0 = node.get("when") if isinstance(node.get("when"), dict) else {}
160
+ if node.get("origin") == "lived" and rv.get("kind") != "period" and isinstance(w0.get("date"), str) and w0.get("date"):
161
+ when = w0["date"] # a lived memory: its day (the age next to it is the preset's present, ED-01)
152
162
  label = rv.get("label") or vid
153
163
  t = text.strip()
154
164
  if t.lower().startswith(label.strip().rstrip("…").lower()[:40]): # a lived memory's label is the start of its text: say the when, not the text twice
@@ -157,7 +167,8 @@ def _memory_entries(src: Path, pid: str | None, keep_personal: bool, keep_secret
157
167
  entry = f"{label}" + (f" ({when})" if when else "") + f": {t}"
158
168
  if secret:
159
169
  entry = "(secret) " + entry
160
- out.append((int(node.get("salience") or 50), entry))
170
+ from .psyche import points
171
+ out.append((points(node.get("salience"), 50), entry))
161
172
  return out
162
173
 
163
174
 
@@ -252,7 +263,7 @@ def import_agent_memories(work: Path, folder: Path, *, identity: str | None = No
252
263
  who = [w.replace("|", "/") for w in e["with"]] # names only: an agent's note never sets shown / real / age (the --who syntax) — hunt 1.2.2, SAFETY-04
253
264
  vid = memory_add(work, identity=identity, kind="moment", gists={lang: e["text"]}, label=e["text"][:60], date=e["date"],
254
265
  where=e["where"] or None, who=who or None, tags=tags, personal=True, origin="lived",
255
- presets=presets, lang=lang)
266
+ presets=presets, lang=lang, present=True)
256
267
  lived.add((e["date"], n)); added.append(vid)
257
268
  return added
258
269
 
@@ -0,0 +1,226 @@
1
+ """« Adulte, sans âge précis » (ageless adult) and the minor-signal detector (1.2.3 tooling convention, decision A of 13 Nov. 2026).
2
+
3
+ An ageless adult is written, with no format change, as the preset's floor
4
+ age_override: {"value": 18, "unit": "years", "basis": "declared", "ageless_adult": true}
5
+ so every 1.2 reader sees a known age of 18 or more; the 1.2.3 tools read the extra key and show « adult (age not stated) »
6
+ instead of « 18 ». It only lifts the « unknown age » brake: the lowest age found anywhere still wins (SPEC § 2.2), and the
7
+ declaration is refused when a minor signal exists — an age under 18 stated anywhere, or the best-effort text signal below.
8
+
9
+ The text detector has a twin in tools/shared/cofage.js: the PATTERNS, NUMBER_WORDS and the normalisation are the same
10
+ (cli/tests/test_agesignals.py compares both on the same cases and checks the lists are equal). It is best-effort: it
11
+ cannot read every way of saying an age; the author stays responsible for what they declare.
12
+ """
13
+ from __future__ import annotations
14
+
15
+ import re
16
+ import unicodedata
17
+
18
+ ADULT = 18
19
+ AGELESS_KEY = "ageless_adult"
20
+
21
+ LABELS = {"fr": "adulte (âge non précisé)", "en": "adult (age not stated)", "de": "erwachsen (Alter nicht angegeben)",
22
+ "es": "adulto (edad no indicada)", "zh": "成年(未注明年龄)", "ja": "成人(年齢未記載)"}
23
+
24
+
25
+ def ageless_age() -> dict:
26
+ """The age object an ageless-adult declaration writes (a preset's age_override)."""
27
+ return {"value": ADULT, "unit": "years", "basis": "declared", AGELESS_KEY: True}
28
+
29
+
30
+ def is_ageless_age(a) -> bool:
31
+ """An age object that declares « adult, no specific age »: the boolean marker on exactly 18 years, basis declared (or absent).
32
+ Anything else (a marker on another value, a string « true ») is an ordinary age: the number counts, the marker is ignored."""
33
+ if not (isinstance(a, dict) and a.get(AGELESS_KEY) is True):
34
+ return False
35
+ v = a.get("value")
36
+ return (isinstance(v, (int, float)) and not isinstance(v, bool) and v == ADULT and a.get("unit", "years") == "years"
37
+ and a.get("basis", "declared") == "declared")
38
+
39
+
40
+ def age_label(a, lang: str = "en") -> str | None:
41
+ """« adult (age not stated) » for an ageless age, else None (the caller shows the number)."""
42
+ return LABELS.get((lang or "en")[:2], LABELS["en"]) if is_ageless_age(a) else None
43
+
44
+
45
+ # ---------------------------------------------------------------- the text detector (best-effort)
46
+
47
+ _INVISIBLE = re.compile("[­​-‏⁠]")
48
+ _MARKS = re.compile("[̀-ͯ]")
49
+
50
+
51
+ def normalize(t: str) -> str:
52
+ """NFKC (fullwidth digits and letters), no invisible characters, lower case, Latin accents stripped (« âgée » → « agee »)."""
53
+ t = _INVISIBLE.sub("", unicodedata.normalize("NFKC", t)).lower()
54
+ return unicodedata.normalize("NFC", _MARKS.sub("", unicodedata.normalize("NFD", t)))
55
+
56
+
57
+ # number words 1–17 (normalised spelling) → value; the same table in cofage.js
58
+ NUMBER_WORDS = {
59
+ "one": 1, "two": 2, "three": 3, "four": 4, "five": 5, "six": 6, "seven": 7, "eight": 8, "nine": 9, "ten": 10, "eleven": 11,
60
+ "twelve": 12, "thirteen": 13, "fourteen": 14, "fifteen": 15, "sixteen": 16, "seventeen": 17,
61
+ "deux": 2, "trois": 3, "quatre": 4, "cinq": 5, "sept": 7, "huit": 8, "neuf": 9, "dix": 10, "onze": 11, "douze": 12, "treize": 13,
62
+ "quatorze": 14, "quinze": 15, "seize": 16, "dix-sept": 17, "dix sept": 17,
63
+ "zwei": 2, "drei": 3, "vier": 4, "funf": 5, "sechs": 6, "sieben": 7, "acht": 8, "neun": 9, "zehn": 10, "elf": 11, "zwolf": 12,
64
+ "dreizehn": 13, "vierzehn": 14, "funfzehn": 15, "sechzehn": 16, "siebzehn": 17,
65
+ "dos": 2, "tres": 3, "cuatro": 4, "cinco": 5, "seis": 6, "siete": 7, "ocho": 8, "nueve": 9, "diez": 10, "once": 11, "doce": 12,
66
+ "trece": 13, "catorce": 14, "quince": 15, "dieciseis": 16, "diecisiete": 17,
67
+ }
68
+ _KANJI = {"一": 1, "二": 2, "三": 3, "四": 4, "五": 5, "六": 6, "七": 7, "八": 8, "九": 9}
69
+
70
+ # The patterns, in a small notation both ports compile: ‹ = no letter or digit before, › = none after, #N = a number
71
+ # (digits, or a number word of the language: #N_EN, #N_FR, #N_DE, #N_ES), #K = digits or a kanji number. A pattern with a
72
+ # capture is an age (a signal only under 18); one without is a word that says « a child ». #L = a letter. The
73
+ # « Name, 15, … » line of many cards is read only at the start of a field.
74
+ _FOLLOW = r"(?=\s*(?:[.,;:!?)\]]|$)|\s+(?:and|but|years?|yrs?|now|today|with|yo|und|jahre|et|ans|y|anos)›)"
75
+ PATTERNS = [
76
+ # en
77
+ r"‹(#N_EN)[\s-]*(?:years?|yrs?)[\s-]*old›",
78
+ r"‹([0-9]{1,3})\s*(?:yo|y/o|y\.o\.)›",
79
+ r"‹(?:i am|i'm|im|she is|he is|she's|he's|they are|they're|you are|you're|ich bin|sie ist|er ist|du bist)\s+(?:only\s+|just\s+|barely\s+|erst\s+|nur\s+)?(#N_EN|#N_DE)" + _FOLLOW,
80
+ r"‹(?:age|age\s*\(years\)|alter|edad)\s*[:=]\s*([0-9]{1,3})(?![0-9])",
81
+ # r31 R9 (review 18 Nov., #10): forms the detector missed
82
+ r"‹aged\s+(#N_EN)›",
83
+ r"‹(#N_EN)[\s-]*years?\s+of\s+age›",
84
+ r"‹age\s+([0-9]{1,3})(?![0-9])",
85
+ r"‹(?:she|he|i|they|who)\s+(?:just\s+|recently\s+)?turned\s+(#N_EN)›",
86
+ # fr
87
+ r"‹(?:(?<!y\s)a|ai|as|avoir|ayant|agee?s?\s+de)\s+(#N_FR)\s*ans›",
88
+ r"‹(?:fille|garcon|gamine?|adolescente?|enfant|eleve|ado|petite?|lyceen(?:ne)?|collegien(?:ne)?|ecolier(?:e)?|jeune\s+fille|jeune\s+garcon)\s+de\s+(#N_FR)\s*ans›",
89
+ # de
90
+ r"‹(#N_DE)[\s-]*jahre?n?[\s-]*alt›",
91
+ r"‹(#N_DE)[\s-]*jahrig(?:e|er|en|es)?›",
92
+ # es
93
+ r"‹(?:tiene|tengo|tienes|tenia|cumple|cumplio|cumplira)\s+(#N_ES)\s*anos?›",
94
+ r"‹(?:nina|nino|chica|chico|muchacha|muchacho|joven|adolescente)\s+de\s+(#N_ES)\s*anos?›",
95
+ r"‹(#N_ES)\s*anos\s+de\s+edad›",
96
+ # ja / zh
97
+ r"(#K)\s*(?:歳|才|岁|周岁)",
98
+ r"(?:年齢|年龄)\s*:?\s*([0-9]{1,3})(?![0-9])",
99
+ r"^\s*#L(?:#L|[' .-]){0,30},\s*([0-9]{1,2})\s*(?:[,;.—–-]|$)",
100
+ # r31 R9: « Léa, 15 ans, … » / « Léa (15 ans) » at the start of a field
101
+ r"^\s*#L(?:#L|[' .-]){0,30}(?:,\s*|\s*\(\s*)(#N_FR)\s*ans›",
102
+ # words — en
103
+ r"‹(?:loli|lolicon|lolita|shota|shotacon|underage|under-age|under\s*18|preteen|pre-teen|tween|schoolgirl|schoolboy|grade\s*schooler|"
104
+ r"elementary\s+school(?:er|\s+(?:student|pupil|girl|boy))|middle\s*schooler|middle\s+school\s+(?:student|pupil|girl|boy)|"
105
+ r"junior\s+high\s+(?:school\s+)?(?:student|girl|boy)|high\s*schooler|high\s+school\s+(?:student|freshman|sophomore|girl|boy)|kindergartner)›",
106
+ r"‹(?:is|she's|he's|i'm|i am)\s+(?:just\s+|only\s+|still\s+)?(?:a\s+)?(?:little\s+(?:girl|boy|child|kid)|child|kid)›",
107
+ # words — fr
108
+ r"‹(?:fillette|ecoliere?|collegienne?|lyceenne?|preado|pre-ado|preadolescente?|petite\s+fille|petit\s+garcon|moins\s+de\s+18\s+ans)›",
109
+ r"‹(?:est|suis|es|c'est)\s+(?:encore\s+|juste\s+|seulement\s+)?(?:une?\s+)?(?:enfant|gamine?|mineure?)›",
110
+ # words — de
111
+ r"‹(?:schulmadchen|schuljunge|grundschuler(?:in)?|minderjahrige?[rnms]?|unter\s+18)›",
112
+ r"‹(?:ist|bin|bist)\s+(?:noch\s+|erst\s+|nur\s+)?(?:ein\s+|eine\s+)?(?:kind|kleines\s+madchen)›",
113
+ # words — es
114
+ r"‹(?:colegiala|colegial|preadolescente|menor\s+de\s+edad|menor\s+de\s+18)›",
115
+ r"‹(?:es|soy|eres)\s+(?:solo\s+|todavia\s+|aun\s+)?(?:una?\s+)?(?:nina|nino|cria|chiquilla|chiquillo)›",
116
+ # words — ja / zh
117
+ r"(?:小学生|中学生|高校生|女子高生|男子高生|女子高校生|幼女|幼児|児童|園児|ロリ|ショタ|未成年|ランドセル|初中生|高中生|儿童|兒童|萝莉|蘿莉|正太|小女孩|小男孩)",
118
+ # r31 R9: « she is a minor » (not « a minor character »), « pas encore majeure », 中学二年生
119
+ r"‹(?:is|est|es)\s+(?:a\s+|une?\s+)?(?:minor|mineure?|menor)(?=\s*(?:[.,;:!?)\]]|$)|\s+(?:and|but|et|mais|y|pero|who|qui|que)›)",
120
+ r"‹pas\s+encore\s+majeure?›",
121
+ r"中学[一二三123]年生",
122
+ ]
123
+
124
+ _NUMS = {"EN": "one two three four five six seven eight nine ten eleven twelve thirteen fourteen fifteen sixteen seventeen".split(),
125
+ "FR": "deux trois quatre cinq six sept huit neuf dix onze douze treize quatorze quinze seize dix-sept".split() + ["dix sept"],
126
+ "DE": "zwei drei vier funf sechs sieben acht neun zehn elf zwolf dreizehn vierzehn funfzehn sechzehn siebzehn".split(),
127
+ "ES": "dos tres cuatro cinco seis siete ocho nueve diez once doce trece catorce quince dieciseis diecisiete".split()}
128
+
129
+
130
+ def _compile(p: str) -> re.Pattern:
131
+ def num(m):
132
+ words = sorted(_NUMS[m.group(1)], key=len, reverse=True)
133
+ return r"(?<![0-9])[0-9]{1,3}(?![0-9])|" + "|".join(re.escape(w) for w in words)
134
+ p = re.sub(r"#N_(EN|FR|DE|ES)", num, p)
135
+ p = p.replace("#K", r"(?<![0-9一二三四五六七八九十百千])(?:[0-9]{1,3}|十[一二三四五六七八九]?|[一二三四五六七八九])(?![0-9])")
136
+ p = p.replace("#L", r"[^\W\d_]")
137
+ p = p.replace("‹", r"(?<![^\W_])").replace("›", r"(?![^\W_])")
138
+ return re.compile(p)
139
+
140
+
141
+ _RX = [_compile(p) for p in PATTERNS]
142
+
143
+
144
+ def _value(tok: str) -> int | None:
145
+ tok = tok.strip()
146
+ if tok.isdigit():
147
+ return int(tok)
148
+ if tok in NUMBER_WORDS:
149
+ return NUMBER_WORDS[tok]
150
+ if tok and tok[0] == "十":
151
+ return 10 + (_KANJI.get(tok[1:], 0) if len(tok) > 1 else 0)
152
+ return _KANJI.get(tok)
153
+
154
+
155
+ def minor_signals(text) -> list[dict]:
156
+ """Best-effort signals that a text describes a person under 18: [{"kind": "age", "age": 15, "match": "15 ans"} |
157
+ {"kind": "word", "match": "schoolgirl"}], in reading order, without duplicates. Empty: nothing found (not a proof)."""
158
+ if not isinstance(text, str) or not text:
159
+ return []
160
+ t = normalize(text)
161
+ hits = []
162
+ for rx in _RX:
163
+ for m in rx.finditer(t):
164
+ if m.groups():
165
+ v = _value(m.group(1))
166
+ if v is None or v >= ADULT:
167
+ continue
168
+ hits.append((m.start(), {"kind": "age", "age": v, "match": m.group(0).strip()}))
169
+ else:
170
+ hits.append((m.start(), {"kind": "word", "match": m.group(0).strip()}))
171
+ out, seen = [], set()
172
+ for _, h in sorted(hits, key=lambda x: x[0]):
173
+ if h["match"] not in seen:
174
+ seen.add(h["match"]); out.append(h)
175
+ return out
176
+
177
+
178
+ CARD_FIELDS = ("name", "description", "personality", "scenario", "first_mes", "mes_example", "creator_notes", "system_prompt",
179
+ "post_history_instructions")
180
+
181
+
182
+ def card_texts(card) -> list[str]:
183
+ """The strings of a character card the detector reads: the text fields, the alternate greetings and the tags."""
184
+ data = card.get("data") if isinstance(card, dict) and isinstance(card.get("data"), dict) else (card if isinstance(card, dict) else {})
185
+ out = [data[k] for k in CARD_FIELDS if isinstance(data.get(k), str)]
186
+ for k in ("alternate_greetings", "group_only_greetings", "tags"):
187
+ if isinstance(data.get(k), list):
188
+ out += [x for x in data[k] if isinstance(x, str)]
189
+ return out
190
+
191
+
192
+ def texts_signals(texts) -> list[dict]:
193
+ out, seen = [], set()
194
+ for t in texts or []:
195
+ for h in minor_signals(t):
196
+ if h["match"] not in seen:
197
+ seen.add(h["match"]); out.append(h)
198
+ return out
199
+
200
+
201
+ def signal_line(sig: list[dict]) -> str:
202
+ return ", ".join(f"« {h['match']} »" for h in sig[:3])
203
+
204
+
205
+ def manifest_texts(src, manifest: dict) -> list[str]:
206
+ """The texts of a COF folder the detector reads before a declaration: the card of every personality variant (description,
207
+ personality, scenario, greetings, tags), the identities' summaries and names."""
208
+ import json
209
+ from pathlib import Path
210
+ out = []
211
+ for iid, ident in ((manifest.get("identities") or {}).items() if isinstance(manifest.get("identities"), dict) else []):
212
+ if isinstance(ident, dict):
213
+ out += [x for x in (ident.get("summary"), ) if isinstance(x, str)]
214
+ if isinstance(ident.get("summary"), dict):
215
+ out += [x for x in ident["summary"].values() if isinstance(x, str)]
216
+ for k in ("summary", "description"):
217
+ if isinstance(manifest.get(k), str):
218
+ out.append(manifest[k])
219
+ for v in (((manifest.get("elements") or {}).get("personality") or {}).get("variants") or {}).values():
220
+ if isinstance(v, dict) and isinstance(v.get("card"), str) and src is not None:
221
+ f = Path(src) / v["card"]
222
+ try:
223
+ out += card_texts(json.loads(f.read_text("utf-8")))
224
+ except (OSError, ValueError):
225
+ pass
226
+ return out
@@ -78,7 +78,7 @@ def identity_view(manifest: dict, pid: str | None, iid: str | None = None) -> di
78
78
  iid = presets[pid].get("identity") or manifest.get("default_identity")
79
79
  base = dict((manifest.get("identities") or {}).get(iid or "", {}) or {})
80
80
  if not base: # a root-only 1.0 file: the character's record is the root copy (SPEC § 2.1)
81
- base = {k: manifest[k] for k in ("name", "nickname", "summary", "fictional", "morphology", "language", "rights") if k in manifest}
81
+ base = {k: manifest[k] for k in ("name", "nickname", "summary", "fictional", "public_figure", "morphology", "language", "rights") if k in manifest}
82
82
  base.update(identity_override(manifest, pid))
83
83
  return base
84
84