@trazum/cli 3.0.1 → 3.0.3

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 (109) hide show
  1. package/README.md +4 -1
  2. package/assets/trazum-statusline.sh +45 -0
  3. package/dist/base-cost.d.ts +173 -0
  4. package/dist/base-cost.d.ts.map +1 -0
  5. package/dist/base-cost.js +244 -0
  6. package/dist/base-cost.js.map +1 -0
  7. package/dist/bill-range.d.ts +118 -0
  8. package/dist/bill-range.d.ts.map +1 -0
  9. package/dist/bill-range.js +122 -0
  10. package/dist/bill-range.js.map +1 -0
  11. package/dist/command-help.d.ts +17 -0
  12. package/dist/command-help.d.ts.map +1 -0
  13. package/dist/command-help.js +69 -0
  14. package/dist/command-help.js.map +1 -0
  15. package/dist/filter.d.ts +7 -1
  16. package/dist/filter.d.ts.map +1 -1
  17. package/dist/filter.js +10 -18
  18. package/dist/filter.js.map +1 -1
  19. package/dist/gateway-metrics.d.ts +83 -0
  20. package/dist/gateway-metrics.d.ts.map +1 -0
  21. package/dist/gateway-metrics.js +181 -0
  22. package/dist/gateway-metrics.js.map +1 -0
  23. package/dist/gateway-server.d.ts +23 -5
  24. package/dist/gateway-server.d.ts.map +1 -1
  25. package/dist/gateway-server.js +26 -1
  26. package/dist/gateway-server.js.map +1 -1
  27. package/dist/gateway-spend.d.ts +11 -1
  28. package/dist/gateway-spend.d.ts.map +1 -1
  29. package/dist/gateway-spend.js +44 -32
  30. package/dist/gateway-spend.js.map +1 -1
  31. package/dist/git.d.ts +70 -0
  32. package/dist/git.d.ts.map +1 -1
  33. package/dist/git.js +145 -0
  34. package/dist/git.js.map +1 -1
  35. package/dist/i18n/en.d.ts.map +1 -1
  36. package/dist/i18n/en.js +358 -6
  37. package/dist/i18n/en.js.map +1 -1
  38. package/dist/i18n/es.d.ts +0 -1
  39. package/dist/i18n/es.d.ts.map +1 -1
  40. package/dist/i18n/es.js +456 -35
  41. package/dist/i18n/es.js.map +1 -1
  42. package/dist/i18n/types.d.ts +205 -0
  43. package/dist/i18n/types.d.ts.map +1 -1
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +942 -59
  46. package/dist/index.js.map +1 -1
  47. package/dist/loopback-guard.d.ts +37 -0
  48. package/dist/loopback-guard.d.ts.map +1 -0
  49. package/dist/loopback-guard.js +65 -0
  50. package/dist/loopback-guard.js.map +1 -0
  51. package/dist/markdown.d.ts +23 -0
  52. package/dist/markdown.d.ts.map +1 -1
  53. package/dist/markdown.js +105 -0
  54. package/dist/markdown.js.map +1 -1
  55. package/dist/plan-edits.d.ts +63 -0
  56. package/dist/plan-edits.d.ts.map +1 -0
  57. package/dist/plan-edits.js +96 -0
  58. package/dist/plan-edits.js.map +1 -0
  59. package/dist/proactive.d.ts +17 -2
  60. package/dist/proactive.d.ts.map +1 -1
  61. package/dist/proactive.js +16 -9
  62. package/dist/proactive.js.map +1 -1
  63. package/dist/receipt-send.d.ts +44 -0
  64. package/dist/receipt-send.d.ts.map +1 -0
  65. package/dist/receipt-send.js +71 -0
  66. package/dist/receipt-send.js.map +1 -0
  67. package/dist/serve.d.ts +7 -0
  68. package/dist/serve.d.ts.map +1 -1
  69. package/dist/serve.js +22 -1
  70. package/dist/serve.js.map +1 -1
  71. package/dist/session-guard.d.ts +210 -0
  72. package/dist/session-guard.d.ts.map +1 -0
  73. package/dist/session-guard.js +463 -0
  74. package/dist/session-guard.js.map +1 -0
  75. package/dist/task.d.ts +7 -1
  76. package/dist/task.d.ts.map +1 -1
  77. package/dist/task.js +7 -26
  78. package/dist/task.js.map +1 -1
  79. package/dist/waste.d.ts +25 -0
  80. package/dist/waste.d.ts.map +1 -0
  81. package/dist/waste.js +39 -0
  82. package/dist/waste.js.map +1 -0
  83. package/dist/zone.d.ts +27 -0
  84. package/dist/zone.d.ts.map +1 -0
  85. package/dist/zone.js +96 -0
  86. package/dist/zone.js.map +1 -0
  87. package/package.json +2 -2
  88. package/src/base-cost.ts +384 -0
  89. package/src/bill-range.ts +206 -0
  90. package/src/command-help.ts +65 -0
  91. package/src/filter.ts +11 -18
  92. package/src/gateway-metrics.ts +209 -0
  93. package/src/gateway-server.ts +43 -6
  94. package/src/gateway-spend.ts +45 -33
  95. package/src/git.ts +158 -0
  96. package/src/i18n/en.ts +424 -6
  97. package/src/i18n/es.ts +542 -35
  98. package/src/i18n/types.ts +208 -0
  99. package/src/index.ts +952 -58
  100. package/src/loopback-guard.ts +74 -0
  101. package/src/markdown.ts +117 -0
  102. package/src/plan-edits.ts +120 -0
  103. package/src/proactive.ts +22 -13
  104. package/src/receipt-send.ts +89 -0
  105. package/src/serve.ts +23 -1
  106. package/src/session-guard.ts +541 -0
  107. package/src/task.ts +8 -26
  108. package/src/waste.ts +42 -0
  109. package/src/zone.ts +95 -0
package/src/i18n/es.ts CHANGED
@@ -13,10 +13,132 @@ const hace = (days: number | null): string =>
13
13
 
14
14
 
15
15
  /** Spanish catalogue. Mirrors `en.ts`; see that file for the contract. */
16
+ /**
17
+ * What `trazum task`, `trazum filter` and the core's task analysis raise, in
18
+ * Spanish (#871). Keyed by the English text they are raised with, because the
19
+ * core has no locale; `i18n.test.js` reads every such text from the sources and
20
+ * fails on one with no entry here.
21
+ */
22
+ const TASK_FILTER_ES: ReadonlyMap<string, string> = new Map(Object.entries({
23
+ // packages/cli/src/task.ts
24
+ 'Unknown task action. Run trazum task --help.': 'Acción de task desconocida. Prueba con "trazum task --help".',
25
+ 'Unsupported task option. Run trazum task --help.': 'Opción de task no admitida. Prueba con "trazum task --help".',
26
+ 'Task options cannot be repeated except source flags.': 'Las opciones de task no se pueden repetir, salvo las de fuente.',
27
+ 'A task option is missing its value.': 'A una opción de task le falta su valor.',
28
+ 'At most 16 task sources are accepted.': 'Se aceptan como mucho 16 fuentes de tarea.',
29
+ 'Task output exceeds the report limit; use a smaller complete task source.':
30
+ 'La salida de task supera el límite del informe; usa una fuente de tarea completa más pequeña.',
31
+ 'Wrong number of task input files. Run trazum task --help.':
32
+ 'Número de ficheros de entrada de task equivocado. Prueba con "trazum task --help".',
33
+ 'Provide at least one --claude-code or --codex file.': 'Indica al menos un fichero con --claude-code o --codex.',
34
+ // packages/cli/src/task-files.ts
35
+ 'Input must be a bounded regular file, not a symlink or stream.':
36
+ 'La entrada debe ser un fichero normal de tamaño acotado, no un enlace simbólico ni un flujo.',
37
+ 'Input must be a regular file, not a symlink or stream.': 'La entrada debe ser un fichero normal, no un enlace simbólico ni un flujo.',
38
+ 'Input changed while opening; retry after other edits finish.':
39
+ 'La entrada cambió mientras se abría; vuelve a intentarlo cuando terminen las otras ediciones.',
40
+ 'Input changed while reading; finish the task and retry with a stable transcript.':
41
+ 'La entrada cambió mientras se leía; termina la tarea y vuelve a intentarlo con una transcripción estable.',
42
+ 'Input was replaced while reading; retry after other edits finish.':
43
+ 'La entrada se sustituyó mientras se leía; vuelve a intentarlo cuando terminen las otras ediciones.',
44
+ 'Input must be UTF-8 text without NUL bytes.': 'La entrada debe ser texto UTF-8 sin bytes NUL.',
45
+ 'Cannot read input; provide an existing, readable regular file without a symlink.':
46
+ 'No se puede leer la entrada; indica un fichero normal que exista y se pueda leer, sin enlace simbólico.',
47
+ 'Cannot create output; choose a new file in an existing writable directory.':
48
+ 'No se puede crear la salida; elige un fichero nuevo en un directorio que exista y admita escritura.',
49
+ 'Instructions must be a regular file owned by you, without symlinks or hard links.':
50
+ 'Las instrucciones deben ser un fichero normal tuyo, sin enlaces simbólicos ni enlaces duros.',
51
+ 'The managed policy block was edited or is malformed; review it manually before retrying.':
52
+ 'El bloque de política gestionado se editó o está mal formado; revísalo a mano antes de volver a intentarlo.',
53
+ 'Instructions would exceed the input limit.': 'Las instrucciones superarían el límite de entrada.',
54
+ 'Instructions changed while preparing the policy; retry after other edits finish.':
55
+ 'Las instrucciones cambiaron mientras se preparaba la política; vuelve a intentarlo cuando terminen las otras ediciones.',
56
+ 'Cannot update instructions; choose an existing writable file in a writable directory.':
57
+ 'No se pueden actualizar las instrucciones; elige un fichero que exista y admita escritura, en un directorio que también la admita.',
58
+ // packages/cli/src/filter.ts
59
+ 'Store must be a real directory.': 'El almacén debe ser un directorio real.',
60
+ 'Store must be owned by you and have mode 0700.': 'El almacén debe ser tuyo y tener el modo 0700.',
61
+ 'Invalid recovery file.': 'Fichero de recuperación no válido.',
62
+ 'Recovery integrity check failed.': 'Ha fallado la comprobación de integridad de la recuperación.',
63
+ 'Invalid arguments. Run trazum filter --help.': 'Argumentos no válidos. Prueba con "trazum filter --help".',
64
+ 'Expected a SHA-256 recovery identifier.': 'Se esperaba un identificador de recuperación SHA-256.',
65
+ 'Pipe a tool log into stdin; interactive tools are not supported.':
66
+ 'Pasa el log de una herramienta por la entrada estándar; las herramientas interactivas no se admiten.',
67
+ 'Trazum: original could not be retained; passing log through unchanged.':
68
+ 'Trazum: no se pudo guardar el original; el log pasa sin cambios.',
69
+ // packages/core/src/task-analysis.ts and task.ts
70
+ 'Invalid task data. See the task workflow schema and limits.':
71
+ 'Datos de tarea no válidos. Consulta el esquema y los límites del flujo de task.',
72
+ 'Ambiguous Claude request identifiers across sessions. Supply separate session sources.':
73
+ 'Identificadores de petición de Claude ambiguos entre sesiones. Indica fuentes de sesión separadas.',
74
+ 'Duplicate task sources are not supported. Supply each session once.':
75
+ 'No se admiten fuentes de tarea duplicadas. Indica cada sesión una sola vez.',
76
+ 'Multiple sources from the same harness require explicit, disjoint sessions.':
77
+ 'Varias fuentes del mismo agente necesitan sesiones explícitas y sin solapes.',
78
+ 'Overlapping task sessions are not supported. Supply each session once.':
79
+ 'No se admiten sesiones de tarea solapadas. Indica cada sesión una sola vez.',
80
+ 'Task usage exceeds safe numeric limits.': 'El uso de la tarea supera los límites numéricos seguros.',
81
+ 'No actionable repeated read, search or explicit failure evidence was found.':
82
+ 'No se encontró ninguna prueba accionable de lecturas o búsquedas repetidas, ni de fallos explícitos.',
83
+ }));
84
+
16
85
  export const es: CliMessages = {
17
86
  locale: 'es',
18
87
  numberLocale: 'es-ES',
19
88
 
89
+ commandHelpMore: 'Todos los comandos, el fichero de configuración, los precios y los ejemplos: trazum --help',
90
+ taskFilter: {
91
+ taskHelp: (maxChars) => `Uso:
92
+ trazum task analyze --id <id> --type <tipo> --criterion <texto>
93
+ --claude-code <fichero> [--codex <fichero>] [--claude-code <fichero> ...]
94
+ [--outcome accepted|rejected|unknown --assessor <etiqueta>]
95
+ [--policy baseline|repeat-review-v1] [-o <informe-nuevo.json>]
96
+ trazum task policy <informe.json> [-o <politica-nueva.md>]
97
+ trazum task apply <informe.json> --instructions <fichero-existente>
98
+ trazum task revert --instructions <fichero-existente>
99
+ trazum task compare <antes.json> <despues.json> [-o <comparacion-nueva.json>]
100
+
101
+ Analiza en local fuentes de tareas explícitas y completas de Claude Code y Codex.
102
+ Repite las opciones de fuente para incluir sesiones de los dos agentes. No se
103
+ recorre la carpeta personal, ni se usa la red, ni se llama a un proveedor, ni se
104
+ instalan hooks, ni se ejecutan comandos. Hasta 16 fuentes y ${maxChars} caracteres
105
+ en total. No partas una sesión entre varias fuentes ni importes la misma sesión
106
+ más de una vez.
107
+ Los informes y las comparaciones son JSON por defecto (también se acepta --json).
108
+ El resultado y quien lo evalúa los declara quien llama; nunca se deducen del uso.
109
+ Aplicar la política añade un bloque gestionado, pequeño y opcional, al fichero que elijas.
110
+ Revisa el diff y haz tú una tarea comparable antes de comparar informes.
111
+ Revertir quita solo el bloque exacto y sin cambios. Cierra otros editores mientras
112
+ aplicas o reviertes. Los informes de salida que ya existen nunca se sobrescriben; los
113
+ ficheros nuevos se crean con 0600.
114
+ Los resultados de herramientas repetidos pueden ser intencionados. Una comparación
115
+ por pares es una observación, no prueba de un ahorro causal, de la calidad de la tarea
116
+ ni del margen de suscripción que queda.
117
+ `,
118
+ filterHelp: `Uso:
119
+ trazum filter compact --recovery-dir <directorio-privado> [--stats]
120
+ trazum filter restore <sha256> --recovery-dir <directorio-privado>
121
+ trazum filter instructions imprime una guía de salida opcional
122
+
123
+ Filtro de visualización experimental y opcional. Solo se compactan las líneas de
124
+ log repetidas seguidas. Los errores y las líneas únicas se conservan. No es para
125
+ ficheros de código ni para tuberías de datos.
126
+ Usa pipefail de Bash para conservar el fallo del comando que produce el log.
127
+ Los logs originales pueden contener datos sensibles: --recovery-dir acepta de forma
128
+ explícita guardarlos en local. Borra ese directorio cuando ya no necesites los originales.
129
+ Los recuentos de tokens son estimaciones, no medidas de facturación ni de cuota de suscripción.
130
+ --stats escribe un registro JSON en stderr, sin contenido del log ni rutas de recuperación.
131
+ `,
132
+ say: (message) => {
133
+ const fixed = TASK_FILTER_ES.get(message);
134
+ if (fixed !== undefined) return fixed;
135
+ const missing = /^Missing --([a-z-]+)\. Run trazum task --help\.$/.exec(message);
136
+ if (missing) return `Falta --${missing[1]}. Prueba con "trazum task --help".`;
137
+ const tooLong = /^Input exceeds (\d+) characters; use a smaller complete task source\.$/.exec(message);
138
+ if (tooLong) return `La entrada supera los ${tooLong[1]} caracteres; usa una fuente de tarea completa más pequeña.`;
139
+ return message;
140
+ },
141
+ },
20
142
  help: (d, bold) => `${bold('trazum')}: lo que cuestan tus agentes de IA y tus llamadas a la API, leído de los logs de esta máquina.
21
143
 
22
144
  ${bold('EMPIEZA AQUÍ')}
@@ -37,7 +159,7 @@ ${bold('USO')}
37
159
  trazum verify <plan.json> --against <nuevo.jsonl|dir> [opciones]
38
160
  trazum profile <log.jsonl|dir> [opciones]
39
161
  trazum history <dir-de-informes-guardados> [opciones]
40
- trazum connect <provider> [opciones]
162
+ trazum connect <proveedor> [opciones]
41
163
  trazum store [--prune] [opciones]
42
164
  trazum watch [--once | --interval 15m] [--sessions] [--notify] [opciones]
43
165
  trazum serve [--port <n> | --socket <ruta>]
@@ -54,37 +176,41 @@ ${bold('USO')}
54
176
  trazum position <uso.jsonl>
55
177
  trazum receipt <uso.jsonl> [--stamp] [--since <cuándo>] [--until <cuándo>] [-o <fichero>]
56
178
  trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
57
- [--since <cuándo>] [--until <cuándo>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
179
+ [--since <cuándo>] [--until <cuándo>] [--by day|week|month] [--pdf-out|--html-out|--markdown-out|--csv-out|--otlp-out|--prom-out <fichero>]
180
+ [--agent <nombre>] [--timezone <zona>] [--git-range <rango> [--delivery]]
58
181
  trazum weekly [<fichero|dir>...] [--until <cuándo>] [--label <nombre>] [--notify] [-o <fichero>]
59
182
  trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
60
183
  trazum from-codex <fichero|dir> [--label <nombre>] [-o <fichero>]
61
184
  trazum from-gemini-cli <fichero|dir> [--label <nombre>] [-o <fichero>]
62
185
  trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
63
186
  trazum from-litellm <fichero|dir> [-o <fichero>]
64
- trazum from-anthropic <usage.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
65
- trazum from-openai <usage.json> [--label <name>] [--label-by-project <file>] [-o <file>]
66
- trazum from-openrouter <activity.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
67
- trazum reconcile <receipt.json> --against <cost.json> [-o <file>]
187
+ trazum from-anthropic <usage.json> [--label <nombre>] [--label-by-workspace <fichero>] [-o <fichero>]
188
+ trazum from-openai <usage.json> [--label <nombre>] [--label-by-project <fichero>] [-o <fichero>]
189
+ trazum from-openrouter <activity.json> [--label <nombre>] [--label-by-workspace <fichero>] [-o <fichero>]
190
+ trazum reconcile <receipt.json> --against <cost.json> [-o <fichero>]
68
191
  trazum from-helicone <fichero|dir> [-o <fichero>]
69
192
  trazum from-langsmith <fichero|dir> [-o <fichero>]
70
193
  trazum switch <uso.jsonl> --to <modelo> [--migration-usd <n>] [--cases <n>]
71
194
  trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]
195
+ trazum model-pricing <managed-settings.json> --reviewed <AAAA-MM-DD> [-o <fichero>]
72
196
  trazum pulse [--max-stale-hours <n>]
73
- trazum proactive [status|on|off] [--only <item,...>] [--dry-run | --yes] [--json]
197
+ trazum proactive [status|on|off] [--only <elemento,...>] [--dry-run | --yes] [--json]
198
+ trazum session-guard [status|install|uninstall] --warn <usd> --stop <usd> --on-cannot-tell <fail-open|fail-closed> [--dry-run | --yes]
199
+ trazum waste <transcripcion.jsonl> [--min-reads <n>] [--claude-md <fichero>] [--mcp-servers <a,b>] [--json]
74
200
  trazum bench [--workload <id>] [--record <fichero>] [--against <fichero> --max-ratio <n>] [--json]
75
201
  trazum write [--answers <fichero>] [--json] [-o <fichero>]
76
202
  trazum models
77
203
  trazum rules [--measure <dir>] [--level <safe|aggressive>]
78
- trazum gateway <provider> --on-cannot-tell <fail-open|fail-closed>
79
- trazum experiment <log> --a <label> --b <label> --min-outcomes <n>
80
- trazum quality <log> --label <name> --at <iso> [--gate]
204
+ trazum gateway <proveedor> --on-cannot-tell <fail-open|fail-closed> [--metrics-port <n>]
205
+ trazum experiment <log> --a <etiqueta> --b <etiqueta> --min-outcomes <n>
206
+ trazum quality <log> --label <nombre> --at <iso> [--gate]
81
207
  trazum semantic <prompt> [--yes]
82
208
  trazum commitment <log> --floor <usd> --discount <pct> [--months 12]
83
- trazum report <log> --year <yyyy>
209
+ trazum report <log> --year <aaaa>
84
210
  trazum owners <log>
85
211
  trazum ladder <log>
86
212
  trazum feedback
87
- trazum filter compact|restore|instructions [--recovery-dir <directory>]
213
+ trazum filter compact|restore|instructions [--recovery-dir <directorio>]
88
214
  trazum task analyze|policy|apply|revert|compare [--help]
89
215
  trazum --version
90
216
 
@@ -219,12 +345,23 @@ ${bold('OPCIONES DE ownrate')}
219
345
  en trazum.config.json, de modo que el modelo que tú mismo sirves sea una
220
346
  fila de primera en cada informe, tasado por ti y marcado como tal.
221
347
 
348
+ ${bold('OPCIONES DE model-pricing')}
349
+ --reviewed <AAAA-MM-DD> Cuándo se comprobaron las tarifas contra el
350
+ contrato por última vez. Obligatorio.
351
+ -o, --out <fichero> Escribe el overlay ahí en vez de en stdout.
352
+
353
+ Las tarifas contratadas que tu organización dio a Claude Code en su ajuste
354
+ gestionado modelPricing, como overlay para --pricing, para que las cifras
355
+ de Trazum coincidan con las que muestra Claude Code. Lo que la tabla no
356
+ puede decir, lotes y modo rápido, conserva la cifra del catálogo y se
357
+ nombra por modelo.
358
+
222
359
  ${bold('OPCIONES DE reconcile')}
223
- --against <archivo> El informe de costes del proveedor: el
360
+ --against <fichero> El informe de costes del proveedor: el
224
361
  GET /v1/organizations/cost_report de Anthropic o
225
362
  el GET /v1/organization/costs de OpenAI, que se
226
363
  distinguen por su forma.
227
- -o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
364
+ -o, --out <fichero> Escribe la comparación ahí en vez de en stdout.
228
365
 
229
366
  Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
230
367
  dos tablas de precios en una sola cifra es como un informe se vuelve
@@ -239,7 +376,7 @@ ${bold('OPCIONES DE reconcile')}
239
376
  ${bold('OPCIONES DE from-anthropic')}
240
377
  --label <nombre> El proyecto al que pertenece este uso. El
241
378
  proveedor no conoce tus nombres de proyecto.
242
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
379
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
243
380
 
244
381
  El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
245
382
  credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
@@ -252,10 +389,10 @@ ${bold('OPCIONES DE from-anthropic')}
252
389
  ${bold('OPCIONES DE from-openai')}
253
390
  --label <nombre> El proyecto al que pertenece este uso. El
254
391
  proveedor no conoce tus nombres de proyecto.
255
- --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
392
+ --label-by-project <fichero> Una etiqueta por id de proyecto, como array JSON
256
393
  de {"project": "proj_…", "label": "nombre"}.
257
394
  Coincidencia exacta; --label es el respaldo.
258
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
395
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
259
396
 
260
397
  El informe de uso de OpenAI, leído como log, con el mismo arreglo que
261
398
  from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
@@ -279,8 +416,44 @@ ${bold('OPCIONES DE bill')}
279
416
  --by <day|week|month> Reparte el extracto por día UTC, semana ISO (de
280
417
  lunes a domingo) o mes. Sin él, una factura que
281
418
  abarca dos meses o más se reparte por mes.
419
+ --timezone <zona> Corta esos días, y un día suelto de --since/--until,
420
+ en esta zona IANA (Europe/Madrid) en vez de UTC. El
421
+ extracto dice cuál. No con --otlp-out,
422
+ --prom-out, --markdown-out, --html-out, --pdf-out ni un
423
+ --csv-shape distinto de slice: cortan los días en UTC.
424
+ --agent <nombre> Factura solo los registros de un agente de código:
425
+ claude-code, codex o gemini-cli. Un log suelto o una
426
+ exportación de proveedor no pertenece a ningún agente
427
+ y queda fuera, contado.
428
+ --git-range <rango> En vez de una factura, dice qué se registró en las
429
+ sesiones de Claude Code de este repositorio entre la
430
+ primera hora de autor y la última de commit del
431
+ rango (main..HEAD), ejecutado desde el repositorio.
432
+ Solo entran en la cifra las sesiones que empezaron y
433
+ terminaron dentro del periodo; las que cruzaron un
434
+ extremo se nombran y cuentan aparte. Es todo lo
435
+ gastado entonces en este repositorio, no el coste
436
+ del cambio. No con --since, --until, --label ni salida.
437
+ --delivery Con --git-range, dice además qué muestra git local que
438
+ llegó en el mismo rango (commits, pull requests con
439
+ número en un asunto, días con un commit) y divide la
440
+ cifra por cada uno. Solo recuentos: no se lee ningún
441
+ nombre, mensaje ni hash. Un promedio del periodo, no
442
+ lo que costó un commit o una pull request.
443
+ --otlp-out <fichero> Escribe además la factura como métricas OpenTelemetry
444
+ (JSON OTLP/HTTP): por día UTC cerrado, coste, tokens
445
+ y llamadas por proyecto, modelo y agente, y lo que no
446
+ se pudo cobrar como métrica aparte. Cada punto de coste
447
+ dice que es equivalente a API, no lo que pagó un plan.
448
+ Hoy, y un día que corta la ventana --since/--until, no
449
+ son puntos: el recurso dice cuáles y qué contenían.
450
+ Trazum escribe el fichero; tu pipeline lo envía.
451
+ --prom-out <fichero> Escribe además las mismas métricas en el formato de
452
+ texto de Prometheus, para el textfile collector del
453
+ node exporter: una serie por día UTC cerrado (su
454
+ etiqueta trazum_day), sin timestamps, sin enviar nada.
282
455
  --stamp Sella el recibo con la hora en que se escribió.
283
- -o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
456
+ -o, --out <fichero> Escribe el recibo ahí en vez de en stdout.
284
457
 
285
458
  Sin ruta, lee las carpetas de sesiones de cada agente que encuentra:
286
459
  Claude Code (~/.claude/projects), Codex ($CODEX_HOME/sessions y
@@ -309,7 +482,7 @@ ${bold('OPCIONES DE weekly')}
309
482
  una línea del resumen, la factura y su movimiento,
310
483
  con lo que tenga la plataforma (como watch
311
484
  --notify). Se dice, no es fatal, si no hay.
312
- -o, --out <archivo> Escribe el resumen ahí en vez de en stdout.
485
+ -o, --out <fichero> Escribe el resumen ahí en vez de en stdout.
313
486
 
314
487
  La semana en Markdown: la factura, qué se movió respecto a la semana
315
488
  anterior y los tres cambios que conviene hacer primero. Lee lo que lee
@@ -324,11 +497,11 @@ ${bold('OPCIONES DE weekly')}
324
497
 
325
498
  ${bold('OPCIONES DE from-openrouter')}
326
499
  --label <nombre> El proyecto al que pertenece este uso.
327
- --label-by-workspace <archivo> Una etiqueta por id de workspace, como array
500
+ --label-by-workspace <fichero> Una etiqueta por id de workspace, como array
328
501
  JSON de {"workspace": "…", "label": "nombre"}.
329
502
  Coincidencia exacta; --label es el respaldo.
330
503
  Requiere el informe pedido con group_by=workspace.
331
- -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
504
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
332
505
 
333
506
  El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
334
507
  gestión, los últimos treinta días), leído como log de uso con los mismos
@@ -435,7 +608,7 @@ ${bold('OPCIONES DE proactive')}
435
608
  tras un sí para ese elemento.
436
609
  off Quita exactamente las líneas que añadió. Nada más
437
610
  cambia en esos archivos.
438
- --only <item,...> Limita a statusline, watch o mcp.
611
+ --only <elemento,...> Limita a statusline, watch o mcp.
439
612
  --dry-run Imprime cada archivo y cada línea, no escribe nada.
440
613
  Es lo que hace hasta que alguien dice que sí: sin
441
614
  terminal y sin --yes es un simulacro.
@@ -473,6 +646,49 @@ ${bold('OPCIONES DE pulse')}
473
646
  contra la que ir tarde) ni por hasta dónde llegan las mediciones, que es un
474
647
  proveedor informando a su ritmo y no un trabajo que falló.
475
648
 
649
+ ${bold('OPCIONES DE session-guard')}
650
+ status Si el hook está en ~/.claude/settings.json, y con
651
+ qué cifras. Es lo predeterminado; no escribe nada.
652
+ install Añade el hook a los eventos UserPromptSubmit y
653
+ PreToolUse. Dice el archivo y cada línea antes, y
654
+ solo escribe tras un sí.
655
+ uninstall Quita exactamente el hook que añadió.
656
+ check Lo que ejecuta el hook: lee la transcripción de la
657
+ sesión, le pone precio con el catálogo incluido y
658
+ avisa una vez, detiene (código de salida 2) o
659
+ calla. No es para escribirlo a mano.
660
+ --warn <usd> Avisa una vez por sesión con este coste equivalente
661
+ en API.
662
+ --stop <usd> Detiene la sesión con este coste. Mayor que --warn.
663
+ --on-cannot-tell <política> fail-open o fail-closed: qué pasa cuando no se
664
+ puede saber el coste (sin transcripción, un modelo
665
+ sin precio). Nunca cuenta el coste como cero.
666
+ --dry-run, --yes Como en proactive.
667
+
668
+ No hay valor por defecto para los umbrales ni para la política: si falta uno,
669
+ el comando se niega y lo nombra. Toda cifra es coste equivalente en API, lo que
670
+ costaría el uso a los precios de lista de la API del proveedor, no lo que te
671
+ cobraron. Nada sale de esta máquina.
672
+
673
+ ${bold('OPCIONES DE waste')}
674
+ <transcripcion.jsonl> La transcripción de una sesión de Claude Code. Se
675
+ leen también las de sus subagentes, en la carpeta
676
+ de al lado.
677
+ --min-reads <n> Lista un fichero solo si se leyó al menos n veces
678
+ (2 o más; por defecto 3). Elige lo que se lista,
679
+ no lo que se cuenta.
680
+ --claude-md <fichero> El CLAUDE.md que medir. Sin él, el CLAUDE.md del
681
+ directorio donde corrió la sesión, si lo hay. Solo
682
+ se lee su tamaño en bytes, nunca su contenido.
683
+ --mcp-servers <a,b> Los servidores MCP que estaban cargados, cuando la
684
+ transcripción no lo dice. Solo nombres.
685
+
686
+ Nombra un coste y lo valora al catálogo incluido, con los recuentos de esta
687
+ sesión: un fichero leído otra vez, un servidor MCP cargado y nunca llamado, un
688
+ CLAUDE.md que se paga en cada turno. Recomienda y no edita ningún fichero. Un
689
+ coste que no se puede calcular con lo que registra la transcripción se nombra
690
+ y no se valora. Toda cifra es coste equivalente en API, no lo que te cobraron.
691
+
476
692
  ${bold('OPCIONES DE bench')}
477
693
  --workload <id> Ejecuta una sola carga estándar en vez de todas.
478
694
  Un id desconocido se rechaza nombrando los conocidos.
@@ -519,13 +735,13 @@ ${bold('OPCIONES DE rules')}
519
735
  ${bold('OPCIONES DE task')}
520
736
  --id <id> --type <tipo> Identifica una tarea y su tipo comparable.
521
737
  --criterion <texto> Declara el criterio de aceptación antes del cambio.
522
- --claude-code <archivo> Añade una sesión explícita de Claude Code; repetible.
523
- --codex <archivo> Añade una sesión explícita de Codex; repetible.
738
+ --claude-code <fichero> Añade una sesión explícita de Claude Code; repetible.
739
+ --codex <fichero> Añade una sesión explícita de Codex; repetible.
524
740
  --outcome <valor> accepted, rejected o unknown (por defecto unknown).
525
741
  --assessor <etiqueta> Obligatorio para un resultado accepted o rejected.
526
742
  --policy <id> baseline (por defecto) o repeat-review-v1.
527
- --instructions <archivo> Archivo local existente para apply o revert.
528
- -o, --out <archivo-nuevo> Crea un informe o política privados; no sobrescribe.
743
+ --instructions <fichero> Archivo local existente para apply o revert.
744
+ -o, --out <fichero-nuevo> Crea un informe o política privados; no sobrescribe.
529
745
  --json Los informes y comparaciones ya usan JSON por defecto.
530
746
  Consulta task --help para analyze, policy, apply, revert y compare.
531
747
  Máximo 400.000 caracteres entre fuentes. Nunca se infiere el éxito de la tarea.
@@ -553,6 +769,11 @@ ${bold('OPCIONES DE gateway')}
553
769
  juzgar una llamada: sin presupuesto, sin nada
554
770
  medido, un modelo sin precio.
555
771
  --port <n> | --socket <p> Dónde escuchar. Solo loopback, siempre.
772
+ --metrics-port <n> Sirve lo que la pasarela ha contado desde que
773
+ arrancó, en texto de Prometheus, en GET /metrics
774
+ de este segundo puerto loopback. Apagado si no se
775
+ da. Solo recuentos y coste a tarifa de lista,
776
+ nunca un prompt.
556
777
  --log <uso.jsonl> El log de uso contra el que se mide la política
557
778
  de limits, leído una vez al arrancar, el mismo
558
779
  flag que en serve, por la misma razón: el gasto
@@ -620,7 +841,7 @@ ${bold('OPCIONES DE commitment')}
620
841
  previsión.
621
842
 
622
843
  ${bold('OPCIONES DE report')}
623
- --year <yyyy> Obligatorio. Qué año montar.
844
+ --year <aaaa> Obligatorio. Qué año montar.
624
845
  --json El registro como datos.
625
846
 
626
847
  Todo sale del almacén y de los planes que ya guardas: no se calcula nada
@@ -725,7 +946,7 @@ ${bold('OPCIONES DE optimize')}
725
946
  el cambio, más los desajustes en ambos sentidos
726
947
  (prompts mapeados sin tráfico, tráfico sin
727
948
  prompt mapeado).
728
- --from-log <usage.jsonl> Mide las tres cifras de arriba desde un registro
949
+ --from-log <uso.jsonl> Mide las tres cifras de arriba desde un registro
729
950
  de uso en vez de teclearlas: llamadas reales,
730
951
  tamaño de salida real, cuota de caché real y el
731
952
  modelo al que fueron las llamadas. Rechaza los
@@ -794,6 +1015,16 @@ ${bold('OPCIONES DE check')}
794
1015
  comprobable pasa. Los presupuestos aplican por fichero como
795
1016
  siempre; el baseline necesita el repositorio entero y se
796
1017
  omite, diciéndolo.
1018
+ --base <ref> Pone además precio a cada prompt cambiado en ese commit y
1019
+ aquí: tokens, y su coste de entrada al mes con las
1020
+ llamadas al mes que "volumes" indica para su label, o por
1021
+ llamada si no indica ninguna. Cada cifra nombra su precio
1022
+ y el día en que se leyó. El commit se lee de esta copia
1023
+ con git y nunca se descarga; si no está, se dice.
1024
+ --max-monthly-increase-usd <usd>
1025
+ Con --base: falla si los prompts con volumen indicado
1026
+ cuestan al mes más de estos dólares por encima de la
1027
+ base. Desactivado salvo que se pase.
797
1028
 
798
1029
  Pensado para CI: sale con código 1 si el prompt supera el presupuesto,
799
1030
  así una plantilla que crece sin control rompe la build en vez de la factura.
@@ -934,6 +1165,13 @@ ${bold('OPCIONES DE plan')}
934
1165
  --min-usd <n> Deja fuera las acciones que valen menos de n
935
1166
  dólares. Cuántas quedaron fuera se dice, nunca
936
1167
  en silencio.
1168
+ --edits Añade una edición a cada fichero de prompt que
1169
+ "labels" en trazum.config.json asigna a un
1170
+ label: el texto de las reglas safe, guardado por
1171
+ hash, sin escribirse. Solo ficheros que git
1172
+ sigue. No se proyecta ningún ahorro.
1173
+ --reorder Con --edits: mueve los bloques estables delante
1174
+ del primer marcador antes de recortar.
937
1175
  -o, --out <fichero> Guarda el plan como JSON fechado, el fichero al
938
1176
  que "trazum verify" lo atará después.
939
1177
  --markdown-out <fichero> Escribe además el plan como Markdown, para un
@@ -1186,6 +1424,9 @@ ${bold('FICHERO DE CONFIGURACIÓN')}
1186
1424
  labels { "support-rag": "prompts/soporte.txt" }: qué fichero de prompt
1187
1425
  manda cada label del registro de uso, para que "trazum profile"
1188
1426
  lea el fichero y diga por qué falla una caché que falla
1427
+ volumes { "support-rag": 30000 }: llamadas al mes de una label que
1428
+ "labels" asocia, para que "check --base" ponga precio a ese
1429
+ prompt por meses. Un prompt sin volumen va por llamada, y se dice
1189
1430
  spend { "maxUsd": 200, "byLabel": { "chat": 40 } }: presupuestos en
1190
1431
  dólares para "trazum profile". Una etiqueta con presupuesto y sin
1191
1432
  llamadas se informa como no medida, nunca como aprobada
@@ -1340,7 +1581,7 @@ ${bold('EJEMPLOS')}
1340
1581
  `--${name} es una fracción entre 0 y 1 (recibido: ${raw}). La configuración rechaza el mismo valor de la misma forma.`,
1341
1582
  badLevel: (received) => `--level debe ser "safe" o "aggressive" (recibido: "${received}").`,
1342
1583
  allLabelsNeedsLog: () =>
1343
- '--all-labels ordena los prompts por tráfico medido, así que necesita --from-log <usage.jsonl>. Sin registro cada ahorro se multiplicaría por la misma suposición tecleada, lo que ordena los prompts por longitud y lo llama prioridad.',
1584
+ '--all-labels ordena los prompts por tráfico medido, así que necesita --from-log <uso.jsonl>. Sin registro cada ahorro se multiplicaría por la misma suposición tecleada, lo que ordena los prompts por longitud y lo llama prioridad.',
1344
1585
  allLabelsNeedsMap: () =>
1345
1586
  '--all-labels lee el mapa "labels" de trazum.config.json (etiqueta a fichero de prompt) y esta config no tiene ninguno. Mapea al menos una carga a su prompt.',
1346
1587
  fromLogConflict: (flag) =>
@@ -1497,9 +1738,9 @@ ${bold('EJEMPLOS')}
1497
1738
  windowUnmoved: (share, model, window) =>
1498
1739
  `${share} de la ventana de ${window} de ${model}, antes y después: este cambio es demasiado pequeño para moverla.`,
1499
1740
  beyondThisPromptTokensOnly: () =>
1500
- 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. Si alguno de tus prompts va a una API de pago por uso, "trazum profile <usage.jsonl>" lee lo que el proveedor cobró de verdad y calcula las palancas que no son el prompt. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1741
+ 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. Si alguno de tus prompts va a una API de pago por uso, "trazum profile <uso.jsonl>" lee lo que el proveedor cobró de verdad y calcula las palancas que no son el prompt. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1501
1742
  beyondThisPrompt: () =>
1502
- 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 60% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <usage.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1743
+ 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 60% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <uso.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1503
1744
  windowUse: (before, after, model, window) =>
1504
1745
  `Ventana de contexto: ${before} → ${after} de los ${window} tokens de ${model}, sitio que se lleva la conversación.`,
1505
1746
  tokensOnlyAskedFor: () =>
@@ -1884,6 +2125,9 @@ ${bold('EJEMPLOS')}
1884
2125
  },
1885
2126
  pointYourSdk: (where) =>
1886
2127
  `Apunta la URL base de tu SDK a ${where} y no cambies nada más. Habla el formato del propio proveedor, así que no hay cambios de código ni cliente nuevo.`,
2128
+ badMetricsPort: (given) => `--metrics-port es "${given}". Da un número entero de 0 a 65535: el puerto loopback del que lee Prometheus.`,
2129
+ metrics: (where) =>
2130
+ `Recuentos para Prometheus en ${where}/metrics, desde que arrancó este proceso: llamadas, tokens, coste a tarifa de lista, rechazos y lo que no se pudo medir. No se envía nada y no lleva ningún prompt.`,
1887
2131
  credential: () =>
1888
2132
  'Tu credencial se reenvía intacta y nunca se lee, ni se guarda, ni se registra, ni se pone en una URL. Trazum no tiene ninguna clave aquí y no puede hacer una llamada propia a través de esto.',
1889
2133
  neverSubstitutes: () =>
@@ -2030,6 +2274,39 @@ ${bold('EJEMPLOS')}
2030
2274
  `Nada de lo de arriba dice si el candidato puede hacer el trabajo. Eso es una evaluación, no aritmética: ${routeCommand}`,
2031
2275
  },
2032
2276
 
2277
+ modelPricing: {
2278
+ noFile: () =>
2279
+ 'Nombra el fichero de ajustes que contiene modelPricing: trazum model-pricing <managed-settings.json> --reviewed AAAA-MM-DD',
2280
+ noReviewed: () =>
2281
+ '--reviewed AAAA-MM-DD es obligatorio: la fecha en que alguien comprobó estas tarifas contra el contrato por última vez. Un overlay de edad desconocida es peor que el catálogo incluido, cuya edad imprime cada informe.',
2282
+ notFound: (file) => `${file} no es un fichero.`,
2283
+ tooLarge: (file, bytes) => `${file} pasa de ${bytes} bytes, más de lo que cabe en un fichero de ajustes.`,
2284
+ notJson: (file, detail) => `${file} no es JSON: ${detail}`,
2285
+ skipped: (key, reason, detail) => {
2286
+ switch (reason) {
2287
+ case 'invalid':
2288
+ return `"${key}" queda fuera: ${detail}. Claude Code también la descarta y conserva el resto.`;
2289
+ case 'zero':
2290
+ return `"${key}" queda fuera: tiene una tarifa de cero, y Trazum no tasa nada a cero. Sus llamadas siguen a precio de lista aquí.`;
2291
+ case 'unknown-model':
2292
+ return `"${key}" no es un modelo que el catálogo conozca, así que no se tasa nada con él. Si es un id de proveedor o de pasarela de un modelo Claude, añade la fila de ese modelo con el id del catálogo.`;
2293
+ case 'duplicate':
2294
+ return `"${key}" queda fuera: es el mismo modelo que "${detail}", cuya fila se usa. Trazum no puede tasar un modelo de dos maneras.`;
2295
+ }
2296
+ },
2297
+ empty: () => 'Nada de la tabla llega a un modelo que Trazum tase, así que no se escribió ningún overlay.',
2298
+ summary: (fromRows, fromMultiplier, multiplier) =>
2299
+ `${fromRows} modelo(s) a las tarifas de tu tabla${multiplier === undefined ? '' : `, por ${multiplier}`}` +
2300
+ (fromMultiplier > 0 ? `; ${fromMultiplier} modelo(s) Claude más a precio de lista por ${multiplier}.` : '.'),
2301
+ batch: (models) =>
2302
+ `Lotes: la tabla no tiene tarifa de lotes, así que ${models} modelo(s) conservan el descuento de lotes del catálogo sobre la nueva tarifa de entrada.`,
2303
+ fastKept: (models) =>
2304
+ `Modo rápido: un overlay no puede llevar una tarifa de modo rápido, así que estos conservan la publicada, sin tu tabla ni tu multiplicador: ${models}. Claude Code sí los aplica a los turnos rápidos.`,
2305
+ usOnly: (models) =>
2306
+ `Inferencia solo en EE. UU.: sin recargo sobre una fila, como lo aplica Claude Code: ${models}.`,
2307
+ written: (file, models) => `Escrito un overlay de ${models} modelo(s) en ${file}. Úsalo con --pricing ${file}.`,
2308
+ },
2309
+
2033
2310
  ownrate: {
2034
2311
  missing: () =>
2035
2312
  'Los dos números los declaras tú: trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]',
@@ -2256,6 +2533,18 @@ ${bold('EJEMPLOS')}
2256
2533
  periodHint: (since, until, unit) =>
2257
2534
  `${unit === 'day' ? 'Un día' : unit === 'week' ? 'Una semana' : 'Un mes'} por separado: --since ${since} --until ${until}.`,
2258
2535
  badBy: (value) => `--by admite day, week o month, no "${value}".`,
2536
+ badAgent: (value, known) => `--agent no conoce "${value}". Los agentes que nombra son ${known}.`,
2537
+ agentNoRecords: (name, known) =>
2538
+ `--agent ${name} no encontró ningún registro de ese agente entre lo leído. Los agentes que nombra son ${known}; un log suelto o una exportación de proveedor no pertenece a ninguno.`,
2539
+ agentOnly: (name, kept, leftOut) =>
2540
+ `--agent: solo se factura ${kept} registro(s) de ${name}; ${leftOut} registro(s) de otros agentes u orígenes quedan fuera.`,
2541
+ badTimezone: (value) => `--timezone no conoce "${value}". Indica una zona horaria IANA como Europe/Madrid o America/New_York.`,
2542
+ timezoneConflict: (flag) =>
2543
+ `--timezone corta los días del extracto en esa zona y ${flag} corta los suyos en UTC, así que los dos imprimirían días que no coinciden. Quita uno de los dos.`,
2544
+ zoneLine: (zone) => `Los días se cortan en ${zone}, no en UTC: un día suelto de --since/--until es un día de esa zona, y también cada fila de arriba.`,
2545
+ periodHintZone: (zone) => `Añade --timezone ${zone} para facturarlo con los mismos días.`,
2546
+ zoneReceiptNote: (zone) =>
2547
+ `--timezone ${zone}: el recibo guarda instantes y ningún día, así que la zona solo decide qué significa un día suelto de --since/--until.`,
2259
2548
  colCalls: () => 'llamadas',
2260
2549
  colShare: () => 'parte',
2261
2550
  moreRows: (count) => `… y ${count} más`,
@@ -2281,15 +2570,65 @@ ${bold('EJEMPLOS')}
2281
2570
  `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
2282
2571
  nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
2283
2572
  sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
2573
+ sendNeedsReceipt: () =>
2574
+ '--send envía el recibo, así que necesita --receipt: bill --receipt --send <url>. No se envía nada más.',
2575
+ badSendTarget: (reason, keyVariable) =>
2576
+ reason === 'credentials-in-url'
2577
+ ? '--send: esa URL lleva credenciales. Las URL acaban en registros, en el historial del shell y en mensajes de error, así que se rechaza. La clave va en la variable de entorno ' + keyVariable + ', y se envía como cabecera bearer.'
2578
+ : reason === 'insecure-scheme'
2579
+ ? '--send: la URL debe ser https, salvo en loopback. Un recibo lleva tus cifras de gasto, y enviarlas en claro por una red es una fuga que no pediste.'
2580
+ : reason === 'bad-key'
2581
+ ? `--send: ${keyVariable} contiene espacios, caracteres de control o bytes no ASCII, que no pueden enviarse como token bearer. Su valor no se muestra.`
2582
+ : '--send: eso no es una URL que esta herramienta pueda interpretar.',
2583
+ sendDelivered: (where, status) => `Recibo enviado a ${where} (HTTP ${status}). No se envió nada más.`,
2584
+ sendFailed: (where, status) =>
2585
+ status === null
2586
+ ? `El recibo no llegó a ${where}. Queda escrito aquí como siempre; esta ejecución sale con 3 porque el envío falló. El error va debajo, sin las cabeceras de la petición.`
2587
+ : `${where} respondió HTTP ${status}, así que el recibo no se entregó. Queda escrito aquí como siempre; esta ejecución sale con 3 porque el envío falló. El cuerpo de la respuesta va debajo, sin las cabeceras de la petición.`,
2284
2588
  pricingLiveHint: (count) =>
2285
2589
  `${count} id(s) de modelo sin precio llevan prefijo de proveedor, como nombran los modelos OpenRouter y LiteLLM, y el catálogo incluido no los trae. Vuelve a ejecutar con --pricing-live para cobrar los slugs de OpenRouter desde su propia lista.`,
2286
2590
  apiEquivalent: () =>
2287
2591
  'Las sesiones de agentes (Claude Code, Codex, Gemini CLI) se valoran a tarifas API del catálogo. Si pagas una suscripción, pagaste el plan, no esta estimación equivalente; los datos ausentes y las tarifas propias pueden cambiar el resultado.',
2592
+ partnerUnpriced: (ids) =>
2593
+ `Modelos Claude como los nombran Amazon Bedrock o Vertex AI: ${ids}. Esas plataformas fijan sus propios precios, que este catálogo no lleva, así que las llamadas quedan sin tasar en vez de cobrarse a las tarifas de Anthropic. Para tasarlas, da a cada id su propia fila en un overlay --pricing con las tarifas de la página de la plataforma.`,
2594
+ partnerModel: (platform, model) =>
2595
+ `${platform === 'bedrock' ? 'Amazon Bedrock' : 'Vertex AI'}, ${model ?? 'un modelo que este catálogo no conoce'}`,
2288
2596
  prefixedKnown: (ids) =>
2289
2597
  `${ids}: el modelo tras la barra tiene precio aquí con su propio nombre. El prefijo no se quita por ti, porque el mismo modelo a través de un router puede facturarse distinto. Si esas llamadas fueron directas al proveedor, registra el modelo sin el prefijo.`,
2290
2598
  windowMatchesNothing: (from, to) =>
2291
2599
  `Ninguna llamada cae dentro de este periodo. Lo leído cubre ${from} → ${to}. Un periodo sin nada dentro no es una factura de $0: revisa las fechas, o quita --since/--until para facturarlo todo.`,
2292
2600
  written: (file) => `Escrito ${file}.`,
2601
+ rangeConflict: (flag) =>
2602
+ `--git-range fija el periodo por sí mismo, a partir de los commits, e imprime su propio extracto: no se puede combinar con ${flag}.`,
2603
+ rangeNoGit: () => 'no se pudo ejecutar git, del que --git-range lee las horas de los commits.',
2604
+ rangeNoRepository: () => 'Este directorio no está dentro de un repositorio git, así que --git-range no tiene repositorio que leer.',
2605
+ rangeBad: (range) => `git no conoce el rango "${range}". Indica uno como main..HEAD.`,
2606
+ rangeEmpty: (range) => `El rango "${range}" no contiene ningún commit, así que no tiene periodo que sumar.`,
2607
+ rangeHeading: (range) => `Registrado en las sesiones de este repositorio mientras se escribía ${range}`,
2608
+ rangeWindow: (from, to, commits) =>
2609
+ `Periodo: ${from} a ${to}, según las horas de autor y de commit de ${commits} commit(s).`,
2610
+ rangeInside: (usd, calls, sessions) =>
2611
+ `${usd} en ${calls.toLocaleString('es-ES')} llamada(s) valorada(s) de ${sessions.toLocaleString('es-ES')} sesión(es) que empezaron y terminaron dentro del periodo.`,
2612
+ rangeNothingInside: () => 'Ninguna sesión de este proyecto empezó y terminó dentro del periodo.',
2613
+ rangeStraddleHeading: (count) =>
2614
+ `${count} sesión(es) empezaron antes del periodo o siguieron después. Contadas aparte, no en la cifra de arriba:`,
2615
+ rangeStraddleRow: (session, from, to, insideUsd, insideCalls, outsideUsd, outsideCalls) =>
2616
+ ` ${session} ${from} a ${to}: ${insideUsd} (${insideCalls} llamada(s)) dentro del periodo, ${outsideUsd} (${outsideCalls} llamada(s)) fuera.`,
2617
+ rangeNoStraddle: () => 'Ninguna sesión cruzó un extremo del periodo.',
2618
+ rangeMeaning: () =>
2619
+ 'Esto es todo lo registrado en este repositorio durante ese periodo. No es el coste del cambio: incluye otro trabajo del mismo repositorio, y no incluye el trabajo del cambio hecho en otro sitio.',
2620
+ rangeLeftOut: (outsideCalls, otherProjects, otherSources, undated) =>
2621
+ `Fuera: ${outsideCalls} llamada(s) de sesiones por completo fuera del periodo, ${otherProjects} registro(s) de otros proyectos, ${otherSources} registro(s) de fuentes sin carpeta de proyecto que comparar (Codex, Gemini CLI, logs), ${undated} llamada(s) sin marca de tiempo.`,
2622
+ rangeUnpriced: (calls) =>
2623
+ `No está en la cifra: ${calls} llamada(s) a modelos que el catálogo no valora. Nombradas, nunca contadas como $0.`,
2624
+ deliveryNeedsRange: () => '--delivery pone el gasto de un rango de commits junto a lo que git muestra que llegó en él, así que necesita --git-range.',
2625
+ rangeDelivered: (commits, merges, pullRequests, days) =>
2626
+ `Llegó en el mismo rango, según git local: ${commits.toLocaleString('es-ES')} commit(s), ${merges.toLocaleString('es-ES')} de ellos commits de fusión; ${pullRequests.toLocaleString('es-ES')} pull request(s) con número en un asunto; ${days.toLocaleString('es-ES')} día(s) UTC con un commit. Una pull request fusionada con rebase no lleva número, así que esa cuenta puede quedarse corta.`,
2627
+ rangeDividedBy: (perCommit, perPullRequest, perDay) =>
2628
+ `La cifra de arriba dividida por cada cuenta: ${perCommit ?? 'sin cifra'} por commit, ${perPullRequest ?? 'sin cifra (no se nombra ninguna pull request)'} por pull request, ${perDay ?? 'sin cifra'} por día. Dos números sobre un mismo periodo, no lo que costó un commit, una pull request o un día.`,
2629
+ rangeDividedNothing: () => 'Ninguna sesión empezó y terminó dentro del periodo, así que no hay cifra que dividir por estas cuentas.',
2630
+ rangeNoProject: () =>
2631
+ 'Ninguna sesión leída pertenece a la carpeta de proyecto de este repositorio. Claude Code nombra esa carpeta con la ruta absoluta del repositorio, así que lee la carpeta que la contiene (trazum bill ~/.claude/projects --git-range main..HEAD) desde la raíz del repositorio. Una sesión iniciada en un subdirectorio o en un worktree está en una carpeta de otro nombre y no se reconoce.',
2293
2632
  },
2294
2633
 
2295
2634
  fromOpenrouter: {
@@ -2567,6 +2906,97 @@ ${bold('EJEMPLOS')}
2567
2906
  crontab: () => 'tu crontab',
2568
2907
  },
2569
2908
 
2909
+ sessionGuard: {
2910
+ unknownAction: (given) => `Acción desconocida "${given}". Usa: trazum session-guard [status|install|uninstall].`,
2911
+ refusedMissing: (flags) =>
2912
+ `Falta: ${flags}. No hay valor por defecto para los dos umbrales en dólares ni para lo que se hace cuando no se puede saber el coste: cada uno es decisión tuya, y una guarda que eligiera uno lo habría decidido por ti. Ejemplo: trazum session-guard install --warn 5 --stop 15 --on-cannot-tell fail-open`,
2913
+ refusedAmount: (flag, given) => `${flag} necesita un importe en dólares mayor que cero, y "${given}" no lo es.`,
2914
+ refusedPolicy: (given, allowed) => `--on-cannot-tell es "${given}". Tiene que ser uno de: ${allowed}. fail-open deja seguir el trabajo cuando no se puede saber el coste, y fail-closed lo detiene.`,
2915
+ refusedWarnNotBelowStop: () => '--warn tiene que ser menor que --stop, o el aviso nunca se vería antes de la parada.',
2916
+ refusedFlag: (flag) =>
2917
+ `${flag} no se acepta aquí. La guarda pone precio a la sesión con el catálogo incluido en esta versión y solo lee archivos que ya están en esta máquina.`,
2918
+ warn: (usd, warnUsd, stopUsd, atLeast) =>
2919
+ `Trazum: esta sesión ha llegado a ${atLeast ? 'al menos ' : ''}${usd} de coste equivalente en API. Tu cifra de aviso es ${warnUsd} y se detiene en ${stopUsd}. Equivalente en API es lo que costaría este uso a los precios de lista de la API del proveedor, no lo que te cobraron.${atLeast ? ' Algunas llamadas son de un modelo para el que Trazum no tiene precio, así que la cifra real es mayor.' : ''} Esto se dice una vez por sesión.`,
2920
+ block: (usd, stopUsd, atLeast) =>
2921
+ `Trazum: detenida. Esta sesión ha llegado a ${atLeast ? 'al menos ' : ''}${usd} de coste equivalente en API, igual o por encima de tu cifra de parada de ${stopUsd}. Equivalente en API es lo que costaría este uso a los precios de lista de la API del proveedor, no lo que te cobraron. Para seguir, sube la cifra: trazum session-guard install --warn <usd> --stop <usd> --on-cannot-tell <fail-open|fail-closed>.`,
2922
+ cannotTellOpen: (why) =>
2923
+ `Trazum no pudo saber cuánto cuesta esta sesión: ${why}. Tu política es fail-open, así que el trabajo sigue y esta guarda no detiene nada. No contó el coste como cero. Esto se dice una vez por sesión.`,
2924
+ cannotTellClosed: (why) =>
2925
+ `Trazum: detenida, porque no pudo saber cuánto cuesta esta sesión: ${why}. Tu política es fail-closed. No contó el coste como cero. Para seguir, arregla la causa o cambia la política con trazum session-guard install.`,
2926
+ cause: {
2927
+ 'no-transcript': () => 'Claude Code no dio ninguna transcripción que leer',
2928
+ unreadable: () => 'no se pudo leer la transcripción',
2929
+ unparseable: () => 'la transcripción tiene líneas y ninguna se pudo leer como uso',
2930
+ skipped: () => 'una parte de la transcripción no se pudo leer como registro de uso',
2931
+ },
2932
+ unpriced: (models) => `el catálogo no tiene precio para ${models}`,
2933
+ settingsShape: (file, key) => `${file} tiene un "${key}" que no tiene la forma que lee Claude Code, así que se deja como está.`,
2934
+ wouldInstall: () => 'guarda de sesión: escribiría',
2935
+ wouldUninstall: () => 'guarda de sesión: quitaría',
2936
+ askInstall: (file) => `¿Escribir el hook de la guarda de sesión (${file})? [s/N] `,
2937
+ askUninstall: (file) => `¿Quitar el hook de la guarda de sesión (${file})? [s/N] `,
2938
+ didInstall: (file) => `guarda de sesión: escrito en ${file}`,
2939
+ didUninstall: (file) => `guarda de sesión: quitado de ${file}`,
2940
+ declined: () => 'guarda de sesión: no se escribió, dijiste que no.',
2941
+ nothingToUninstall: () => 'guarda de sesión: nada que quitar.',
2942
+ alreadyInstalled: (file) => `guarda de sesión: ya está como pediste en ${file}, nada que cambiar.`,
2943
+ dryRun: () => 'Simulacro: no se escribió nada.',
2944
+ dryRunNoTerminal: () =>
2945
+ 'Esto no es una terminal y no se pasó --yes, así que es un simulacro: no se escribió nada. Ejecútalo en una terminal para que te pregunte, o pasa --yes.',
2946
+ failed: (reason) => `guarda de sesión: no se escribió. ${reason}`,
2947
+ statusOn: (file, warnUsd, stopUsd, policy) =>
2948
+ `activa en ${file}: avisa en ${warnUsd}, detiene en ${stopUsd} de coste equivalente en API, y cuando no se puede saber el coste es ${policy}.`,
2949
+ statusOff: (file) => `desactivada: no hay hook de la guarda de sesión en ${file}.`,
2950
+ statusPartial: (file) => `activa a medias: ${file} tiene el hook en uno de los dos eventos y no en el otro. Ejecuta install otra vez para completarla.`,
2951
+ apiEquivalent: () => 'Toda cifra es coste equivalente en API: el uso a los precios de lista de la API del proveedor, no lo que te cobraron.',
2952
+ windows: () => 'El hook de la guarda de sesión se escribe como comando de shell y no está disponible en Windows.',
2953
+ noClaude: (dir) => `${dir} no existe, así que Claude Code no parece instalado para este usuario. No se escribió nada.`,
2954
+ },
2955
+
2956
+ waste: {
2957
+ refusedFlag: (flag) =>
2958
+ `${flag} no se acepta aquí. waste valora al catálogo incluido en esta versión y lee solo ficheros que ya están en esta máquina.`,
2959
+ noPath: () => 'Indica la transcripción de la sesión que leer. Ejemplo: trazum waste <sesion>.jsonl',
2960
+ notFound: (path) => `${path} no es un fichero.`,
2961
+ unreadable: (path) => `No se pudo leer ${path}, o una transcripción de sus subagentes.`,
2962
+ minReadsBad: (given) => `--min-reads necesita un número entero de 2 o más, y "${given}" no lo es: un fichero leído una vez no se ha leído otra vez.`,
2963
+ cannotTell: () =>
2964
+ 'No se puede saber: la transcripción no se pudo emparejar línea a línea con su uso, y emparejar una llamada a herramienta con el prompt equivocado valoraría lo que no es. No se calculó nada. Ejecuta trazum from-claude-code sobre ella para ver cómo se lee.',
2965
+ heading: (calls, threads) => `Desperdicio en esta sesión: ${plural(calls, 'llamada')} en ${plural(threads, 'hilo')}`,
2966
+ apiEquivalent: (reviewed) =>
2967
+ `Toda cifra es coste equivalente en API al catálogo incluido, revisado por última vez el ${reviewed}: no lo que te cobraron. Un ahorro es una cota inferior calculada con los recuentos de esta sesión.`,
2968
+ unpriced: (models) => `El catálogo no tiene precio para ${models}: esas llamadas quedan fuera de toda cifra, así que cada una es un mínimo.`,
2969
+ readsHeading: () => 'El mismo fichero leído otra vez',
2970
+ readsNone: (minReads) => `Ningún fichero se leyó ${minReads} o más veces sin que nada lo cambiara entre medias.`,
2971
+ readLine: (reads, repeats, measured, tokens, usd) =>
2972
+ `leído ${reads} veces, ${plural(repeats, 'repetición', 'repeticiones')} del mismo tramo sin edición entre medias. ${
2973
+ usd === null
2974
+ ? 'Sin valorar: las llamadas que lo repitieron hicieron también otras llamadas a herramientas, así que el crecimiento no se puede repartir.'
2975
+ : `${measured} medidas, ${tokens.toLocaleString('es-ES')} tokens añadidos al contexto y arrastrados en cada llamada posterior: ${usd}.`
2976
+ }`,
2977
+ readsOmitted: (count) => `${plural(count, 'fichero más', 'ficheros más')} leído${count === 1 ? '' : 's'} otra vez y sin listar (por debajo de --min-reads, o pasadas las 20 listadas).`,
2978
+ readsTotal: (usd, measured, repeats) =>
2979
+ `En conjunto: ${usd} por las ${measured} de ${repeats} repeticiones que se pudieron medir.`,
2980
+ readsUnmeasured: (repeats) => `${plural(repeats, 'repetición', 'repeticiones')} encontradas y ninguna se pudo valorar con los recuentos.`,
2981
+ mcpHeading: () => 'Servidores MCP cargados y nunca llamados',
2982
+ mcpNoList: () =>
2983
+ 'No se puede saber qué servidores estaban cargados: esta transcripción no registra una lista. Nómbralos con --mcp-servers <a,b> y dirá cuáles no se llamaron nunca.',
2984
+ mcpAllCalled: (loaded) => `${plural(loaded, 'servidor', 'servidores')} cargado${loaded === 1 ? '' : 's'}, y todos se llamaron al menos una vez.`,
2985
+ mcpSummary: (loaded, called, source) =>
2986
+ `${plural(loaded, 'servidor', 'servidores')} cargado${loaded === 1 ? '' : 's'}${source === 'flag' ? ' (como los nombraste)' : ''}, ${called} llamado${called === 1 ? '' : 's'}.`,
2987
+ mcpUnused: (server, tools) => `${server}: nunca llamado${tools === null ? '' : `, ${plural(tools, 'herramienta')} cargada${tools === 1 ? '' : 's'}`}`,
2988
+ mcpNotPriced: () =>
2989
+ 'Sin valorar: lo que cuestan las definiciones de herramientas de un servidor no está en la transcripción, y donde las herramientas se difieren sus definiciones no se envían hasta que se piden. Una cifra aquí sería inventada.',
2990
+ claudeHeading: () => 'Un CLAUDE.md que se paga en cada turno',
2991
+ claudeNone: (path) =>
2992
+ path === ''
2993
+ ? 'No hay CLAUDE.md que medir: la transcripción no nombra ningún directorio. Pasa --claude-md <fichero>.'
2994
+ : `No hay CLAUDE.md en ${path}. Pasa --claude-md <fichero> para medir otro.`,
2995
+ claudeLine: (bytes, tokens, calls, usd, low, high, bandPct) =>
2996
+ `${plural(bytes, 'byte')}, unos ${tokens.toLocaleString('es-ES')} tokens, en ${plural(calls, 'llamada')} del hilo principal: ${usd} (${low} a ${high}). Estimado: la transcripción no registra su tamaño, así que los tokens son los bytes entre el divisor del estimador, dentro de su banda publicada de ${bandPct}%. Solo se leyó el tamaño del fichero.`,
2997
+ nothingChanged: () => 'No se cambió nada. Este comando recomienda y no edita ningún fichero.',
2998
+ },
2999
+
2570
3000
  pulse: {
2571
3001
  heading: () => '¿Corrieron las cosas que tienen que correr?',
2572
3002
  kind: (kind) => {
@@ -3018,6 +3448,49 @@ ${bold('EJEMPLOS')}
3018
3448
  exactCountsCost: (files) =>
3019
3449
  `Contando ${files} ${files === 1 ? 'fichero' : 'ficheros'} con la API, una llamada por cada uno. Esto tarda un momento.`,
3020
3450
  },
3451
+ againstBase: {
3452
+ heading: (ref, sha) => `Frente a la base, ${ref} en ${sha}`,
3453
+ columnTokens: () => 'Tokens, base → cabeza',
3454
+ columnCalls: () => 'Llamadas al mes',
3455
+ columnBase: () => 'Base',
3456
+ columnHead: () => 'Cabeza',
3457
+ columnPrice: () => 'Precio',
3458
+ notStated: () => 'sin indicar',
3459
+ perMonth: (usd) => `${usd} al mes`,
3460
+ perCall: (usd) => `${usd} por llamada`,
3461
+ price: (perMTok, model, provider, readOn) =>
3462
+ `${perMTok} por millón de tokens de entrada, ${model}, precios de ${provider} leídos el ${readOn}`,
3463
+ priceOverlay: (perMTok, model, readOn) =>
3464
+ `${perMTok} por millón de tokens de entrada, ${model}, capa local de precios fechada el ${readOn}`,
3465
+ promo: (until) => `precio promocional hasta el ${until}`,
3466
+ totals: (base, head, change) =>
3467
+ `Los prompts con volumen indicado: ${base} al mes en la base, ${head} en la cabeza (${change}).`,
3468
+ perCallNote: (count) =>
3469
+ `${count} ${count === 1 ? 'prompt cambiado no tiene' : 'prompts cambiados no tienen'} volumen indicado, así que su coste es solo por llamada. Para ponerle precio a un mes, asocia el fichero del prompt en "labels" e indica sus llamadas al mes en "volumes" de trazum.config.json.`,
3470
+ inputOnly: () =>
3471
+ 'Tokens de entrada al precio de entrada, los dos lados a los mismos precios. La salida queda fuera: editar un prompt no fija cuánto escribe el modelo.',
3472
+ modelDefault: (model) =>
3473
+ `Con el modelo por defecto de Trazum, ${model}, porque la config no fija usage.model. Fíjalo para poner precio al modelo al que se envían los prompts.`,
3474
+ unchanged: (count) =>
3475
+ `${count} ${count === 1 ? 'prompt es igual' : 'prompts son iguales'} en los dos lados.`,
3476
+ nothingChanged: () => 'Ningún prompt de aquí cambió frente a la base.',
3477
+ gateWithin: (change, limit) => `El aumento mensual, ${change}, está dentro del límite de ${limit}.`,
3478
+ gateBreached: (change, limit) => `El aumento mensual, ${change}, supera el límite de ${limit}.`,
3479
+ gateNotJudged: (count) =>
3480
+ `El límite juzga solo los prompts con volumen indicado: ${count} ${count === 1 ? 'prompt cambiado no se juzgó' : 'prompts cambiados no se juzgaron'}.`,
3481
+ unavailable: (why, ref) =>
3482
+ why === 'no-commit'
3483
+ ? `La base, ${ref}, no está en esta copia, así que no se comparó nada. No se descarga nada para buscarla. En GitHub Actions, pon fetch-depth: 0 en actions/checkout.`
3484
+ : why === 'not-a-repository'
3485
+ ? `Esto no es un repositorio git, así que no hay base con la que comparar ${ref}.`
3486
+ : `No se pudo ejecutar git, así que la base, ${ref}, no se leyó.`,
3487
+ gateUnavailable: (limit) =>
3488
+ `El límite de aumento mensual de ${limit} no juzgó nada, porque la base no se pudo leer, y una puerta que no juzga nada falla.`,
3489
+ gateNeedsBase: () =>
3490
+ '--max-monthly-increase-usd limita lo que un cambio añade al coste mensual frente a una base, así que necesita --base <ref>.',
3491
+ noStdin: () =>
3492
+ '--base lee de git el lado base de un fichero, y la entrada estándar no tiene lado base. Nombra el fichero.',
3493
+ },
3021
3494
  profile: {
3022
3495
  noTarget: () =>
3023
3496
  'Apúntalo a un log de uso: trazum profile usage.jsonl: un objeto JSON por línea, cada uno con un "model" y el objeto "usage" que devolvió la API. Añade "label" (qué carga), "session" (qué conversación) y "ts" (cuándo) ya que estás: sin ellos todas las llamadas parecen iguales, y los hallazgos más grandes de este comando (el crecimiento de conversación, y si el TTL de la caché encaja con el ritmo de tus turnos) no se pueden hacer siquiera. Registrarlo son cuatro líneas en tu propio código, nunca contiene el texto del prompt, y la clave de sesión se agrupa y nunca se imprime.',
@@ -3471,7 +3944,9 @@ ${bold('EJEMPLOS')}
3471
3944
  ? 'Enruta y agrupa'
3472
3945
  : kind === 'fix-truncation'
3473
3946
  ? 'Arregla los reintentos por truncado de'
3474
- : 'Mira la caché de';
3947
+ : kind === 'edit-file'
3948
+ ? 'Edita el fichero de prompt de'
3949
+ : 'Mira la caché de';
3475
3950
  return `${verb} ${label} (${model})`;
3476
3951
  },
3477
3952
  routeTo: (model, withBatch) =>
@@ -3488,6 +3963,8 @@ ${bold('EJEMPLOS')}
3488
3963
  return 'supone que un max_tokens en el que quepan las respuestas elimina el par';
3489
3964
  case 'traffic-pattern-holds':
3490
3965
  return 'supone que el patrón de tráfico se mantiene: una caché que perdió dinero en este registro puede rendir con otro tráfico';
3966
+ case 'file-is-what-label-sends':
3967
+ return `supone que ${assumption.path} es lo que envía esta carga: trazum.config.json lo dice, el registro guarda tokens, no ficheros`;
3491
3968
  }
3492
3969
  },
3493
3970
  check: (command) => `compruébalo: ${command}`,
@@ -3499,6 +3976,25 @@ ${bold('EJEMPLOS')}
3499
3976
  'Ordenado por dinero, proyectado o ya gastado por igual. Los supuestos los respondes tú: este plan es aritmética sobre el registro, no conocimiento de tu producto.',
3500
3977
  wrote: (path) =>
3501
3978
  `Plan escrito en ${path}, con fecha. Guárdalo: una predicción que nadie apuntó es una predicción que no se le puede exigir a nadie.`,
3979
+ editsNeedLabels: () =>
3980
+ '--edits lee el fichero de prompt que envía cada label, y trazum.config.json no asigna ninguno: añade "labels", por ejemplo {"labels": {"soporte": "prompts/soporte.txt"}}.',
3981
+ reorderNeedsEdits: () => '--reorder es un paso de una edición: añade --edits.',
3982
+ editMeasured: (usd, calls, inputPerCall) =>
3983
+ `se espera contra ${usd} en ${calls} llamadas a ${inputPerCall} tokens de entrada por llamada, medido`,
3984
+ editChange: (path, reordered, tokensBefore, tokensAfter) =>
3985
+ `${path}: ${reordered ? 'bloques estables movidos delante del primer marcador, y luego recortado' : 'recortado'} por las reglas safe, ${tokensBefore} → ${tokensAfter} tokens según el estimador, estimado, no medido; no se proyecta ningún ahorro`,
3986
+ editCheck: () =>
3987
+ 'trazum verify lee el fichero, que debe tener el texto que este plan prometió, y el registro más nuevo, donde la entrada por llamada debe bajar de la cifra de arriba',
3988
+ editSkipped: (why, label, path) =>
3989
+ why === 'no-traffic'
3990
+ ? `Sin edición para ${label} (${path}): el registro no tiene ninguna llamada tasada con ese label, así que no hay cifra medida contra la que esperarla.`
3991
+ : why === 'unreadable'
3992
+ ? `Sin edición para ${label}: no se pudo leer ${path}.`
3993
+ : why === 'not-tracked'
3994
+ ? `Sin edición para ${label}: git no sigue ${path}, y una edición se propone al repositorio.`
3995
+ : why === 'source-file'
3996
+ ? `Sin edición para ${label}: ${path} es código fuente, y una edición reescribe el fichero entero.`
3997
+ : `Sin edición para ${label}: las reglas safe dejan ${path} como está.`,
3502
3998
  },
3503
3999
 
3504
4000
  serve: {
@@ -3681,7 +4177,9 @@ ${bold('EJEMPLOS')}
3681
4177
  ? `Enrutar y agrupar ${label} (${model})`
3682
4178
  : kind === 'fix-truncation'
3683
4179
  ? `Arreglar los reintentos por truncado de ${label} (${model})`
3684
- : `Arreglar la caché de ${label} (${model})`;
4180
+ : kind === 'edit-file'
4181
+ ? `Editar el fichero de prompt de ${label} (${model})`
4182
+ : `Arreglar la caché de ${label} (${model})`;
3685
4183
  const span = first !== null && last !== null ? ` (${first} → ${last})` : '';
3686
4184
  return `${what} se ha planificado ${appearances} veces${span} y sigue en el plan más reciente: una decisión que nadie está revisando.`;
3687
4185
  },
@@ -3762,7 +4260,9 @@ ${bold('EJEMPLOS')}
3762
4260
  ? `Enrutar y agrupar ${label} (${model})`
3763
4261
  : kind === 'fix-truncation'
3764
4262
  ? `Arreglar los reintentos por truncado de ${label} (${model})`
3765
- : `Arreglar la caché de ${label} (${model})`;
4263
+ : kind === 'edit-file'
4264
+ ? `Editar el fichero de prompt de ${label} (${model})`
4265
+ : `Arreglar la caché de ${label} (${model})`;
3766
4266
  const verdict =
3767
4267
  outcome === 'arrived' ? 'LLEGÓ' : outcome === 'not-arrived' ? 'NO LLEGÓ' : 'NO SE PUEDE SABER';
3768
4268
  return `${what}: ${verdict}`;
@@ -3772,7 +4272,11 @@ ${bold('EJEMPLOS')}
3772
4272
  ? 'el label no lleva tráfico tasado en este registro: una carga desaparecida no está arreglada, y tampoco rota'
3773
4273
  : reason === 'fields-stopped'
3774
4274
  ? 'los campos que la detección necesita no están en este registro: "no registrado" no puede leerse como "arreglado", así que con --gate esto suspende'
3775
- : 'el registro guarda tokens, y los tokens no dicen con qué tarifa se facturaron: el Batch API no se puede ver desde aquí',
4275
+ : reason === 'file-not-read'
4276
+ ? 'el fichero no se pudo leer desde aquí, así que no se puede saber si se hizo la edición'
4277
+ : reason === 'file-changed'
4278
+ ? 'el fichero no tiene ni el texto del que partió el plan ni el que prometió: siguió cambiando, y con --gate esto suspende'
4279
+ : 'el registro guarda tokens, y los tokens no dicen con qué tarifa se facturaron: el Batch API no se puede ver desde aquí',
3776
4280
  routeObserved: (dearestModel, onTargetUsd, onOldUsd) =>
3777
4281
  `el modelo más caro del label ahora es ${dearestModel} · ${onTargetUsd} en el destino, ${onOldUsd} todavía en el modelo antiguo`,
3778
4282
  batchUnobservable: () =>
@@ -3783,6 +4287,9 @@ ${bold('EJEMPLOS')}
3783
4287
  outcome === 'arrived'
3784
4288
  ? `la caché ahora se paga sola en esta porción (${deltaUsd} contra la factura sin caché)`
3785
4289
  : `la caché todavía añade ${deltaUsd} a la factura de esta porción`,
4290
+ editObserved: (before, after) =>
4291
+ `el fichero tiene el texto planeado; entrada por llamada ${before} → ${after} tokens, medido`,
4292
+ editNotMade: (path) => `${path} todavía tiene el texto del que partió el plan: la edición no se hizo`,
3786
4293
  attribution: (callsBefore, callsAfter, outBefore, outAfter) =>
3787
4294
  `el mundo también se movió: llamadas ${callsBefore} → ${callsAfter}, salida/llamada ${outBefore} → ${outAfter} tokens, dicho para que el veredicto no se lea como toda la historia`,
3788
4295
  gateFailed: (failures, total) =>