@trazum/cli 3.0.1 → 3.0.2
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.
- package/README.md +4 -1
- package/assets/trazum-statusline.sh +45 -0
- package/dist/base-cost.d.ts +173 -0
- package/dist/base-cost.d.ts.map +1 -0
- package/dist/base-cost.js +244 -0
- package/dist/base-cost.js.map +1 -0
- package/dist/bill-range.d.ts +118 -0
- package/dist/bill-range.d.ts.map +1 -0
- package/dist/bill-range.js +122 -0
- package/dist/bill-range.js.map +1 -0
- package/dist/command-help.d.ts +17 -0
- package/dist/command-help.d.ts.map +1 -0
- package/dist/command-help.js +69 -0
- package/dist/command-help.js.map +1 -0
- package/dist/filter.d.ts +7 -1
- package/dist/filter.d.ts.map +1 -1
- package/dist/filter.js +10 -18
- package/dist/filter.js.map +1 -1
- package/dist/gateway-metrics.d.ts +83 -0
- package/dist/gateway-metrics.d.ts.map +1 -0
- package/dist/gateway-metrics.js +181 -0
- package/dist/gateway-metrics.js.map +1 -0
- package/dist/gateway-server.d.ts +23 -5
- package/dist/gateway-server.d.ts.map +1 -1
- package/dist/gateway-server.js +26 -1
- package/dist/gateway-server.js.map +1 -1
- package/dist/gateway-spend.d.ts +11 -1
- package/dist/gateway-spend.d.ts.map +1 -1
- package/dist/gateway-spend.js +44 -32
- package/dist/gateway-spend.js.map +1 -1
- package/dist/git.d.ts +70 -0
- package/dist/git.d.ts.map +1 -1
- package/dist/git.js +145 -0
- package/dist/git.js.map +1 -1
- package/dist/i18n/en.d.ts.map +1 -1
- package/dist/i18n/en.js +358 -6
- package/dist/i18n/en.js.map +1 -1
- package/dist/i18n/es.d.ts +0 -1
- package/dist/i18n/es.d.ts.map +1 -1
- package/dist/i18n/es.js +456 -35
- package/dist/i18n/es.js.map +1 -1
- package/dist/i18n/types.d.ts +205 -0
- package/dist/i18n/types.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +942 -59
- package/dist/index.js.map +1 -1
- package/dist/loopback-guard.d.ts +37 -0
- package/dist/loopback-guard.d.ts.map +1 -0
- package/dist/loopback-guard.js +65 -0
- package/dist/loopback-guard.js.map +1 -0
- package/dist/markdown.d.ts +23 -0
- package/dist/markdown.d.ts.map +1 -1
- package/dist/markdown.js +105 -0
- package/dist/markdown.js.map +1 -1
- package/dist/plan-edits.d.ts +63 -0
- package/dist/plan-edits.d.ts.map +1 -0
- package/dist/plan-edits.js +96 -0
- package/dist/plan-edits.js.map +1 -0
- package/dist/proactive.d.ts +17 -2
- package/dist/proactive.d.ts.map +1 -1
- package/dist/proactive.js +16 -9
- package/dist/proactive.js.map +1 -1
- package/dist/receipt-send.d.ts +44 -0
- package/dist/receipt-send.d.ts.map +1 -0
- package/dist/receipt-send.js +71 -0
- package/dist/receipt-send.js.map +1 -0
- package/dist/serve.d.ts +7 -0
- package/dist/serve.d.ts.map +1 -1
- package/dist/serve.js +22 -1
- package/dist/serve.js.map +1 -1
- package/dist/session-guard.d.ts +210 -0
- package/dist/session-guard.d.ts.map +1 -0
- package/dist/session-guard.js +463 -0
- package/dist/session-guard.js.map +1 -0
- package/dist/task.d.ts +7 -1
- package/dist/task.d.ts.map +1 -1
- package/dist/task.js +7 -26
- package/dist/task.js.map +1 -1
- package/dist/waste.d.ts +25 -0
- package/dist/waste.d.ts.map +1 -0
- package/dist/waste.js +39 -0
- package/dist/waste.js.map +1 -0
- package/dist/zone.d.ts +27 -0
- package/dist/zone.d.ts.map +1 -0
- package/dist/zone.js +96 -0
- package/dist/zone.js.map +1 -0
- package/package.json +2 -2
- package/src/base-cost.ts +384 -0
- package/src/bill-range.ts +206 -0
- package/src/command-help.ts +65 -0
- package/src/filter.ts +11 -18
- package/src/gateway-metrics.ts +209 -0
- package/src/gateway-server.ts +43 -6
- package/src/gateway-spend.ts +45 -33
- package/src/git.ts +158 -0
- package/src/i18n/en.ts +424 -6
- package/src/i18n/es.ts +542 -35
- package/src/i18n/types.ts +208 -0
- package/src/index.ts +952 -58
- package/src/loopback-guard.ts +74 -0
- package/src/markdown.ts +117 -0
- package/src/plan-edits.ts +120 -0
- package/src/proactive.ts +22 -13
- package/src/receipt-send.ts +89 -0
- package/src/serve.ts +23 -1
- package/src/session-guard.ts +541 -0
- package/src/task.ts +8 -26
- package/src/waste.ts +42 -0
- 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 <
|
|
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 <
|
|
65
|
-
trazum from-openai <usage.json> [--label <
|
|
66
|
-
trazum from-openrouter <activity.json> [--label <
|
|
67
|
-
trazum reconcile <receipt.json> --against <cost.json> [-o <
|
|
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 <
|
|
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 <
|
|
79
|
-
trazum experiment <log> --a <
|
|
80
|
-
trazum quality <log> --label <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
523
|
-
--codex <
|
|
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 <
|
|
528
|
-
-o, --out <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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 <
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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
|
-
:
|
|
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) =>
|