trackops 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/README.md +341 -232
  2. package/bin/trackops.js +102 -70
  3. package/lib/config.js +260 -35
  4. package/lib/control.js +518 -475
  5. package/lib/env.js +227 -0
  6. package/lib/i18n.js +61 -53
  7. package/lib/init.js +146 -55
  8. package/lib/locale.js +63 -0
  9. package/lib/opera-bootstrap.js +523 -0
  10. package/lib/opera.js +319 -170
  11. package/lib/registry.js +27 -13
  12. package/lib/release.js +56 -0
  13. package/lib/resources.js +42 -0
  14. package/lib/server.js +912 -418
  15. package/lib/skills.js +148 -124
  16. package/lib/workspace.js +260 -0
  17. package/locales/en.json +331 -139
  18. package/locales/es.json +331 -139
  19. package/package.json +14 -3
  20. package/scripts/skills-marketplace-smoke.js +124 -0
  21. package/scripts/smoke-tests.js +445 -0
  22. package/scripts/sync-skill-version.js +21 -0
  23. package/scripts/validate-skill.js +88 -0
  24. package/skills/trackops/SKILL.md +64 -0
  25. package/skills/trackops/agents/openai.yaml +3 -0
  26. package/skills/trackops/references/activation.md +39 -0
  27. package/skills/trackops/references/troubleshooting.md +34 -0
  28. package/skills/trackops/references/workflow.md +20 -0
  29. package/skills/trackops/scripts/bootstrap-trackops.js +201 -0
  30. package/skills/trackops/skill.json +29 -0
  31. package/templates/etapa/agent.md +2 -2
  32. package/templates/etapa/references/etapa-cycle.md +1 -1
  33. package/templates/opera/agent.md +1 -1
  34. package/templates/opera/en/agent.md +26 -0
  35. package/templates/opera/en/genesis.md +79 -0
  36. package/templates/opera/en/references/autonomy-and-recovery.md +23 -0
  37. package/templates/opera/en/references/opera-cycle.md +62 -0
  38. package/templates/opera/en/registry.md +28 -0
  39. package/templates/opera/en/router.md +39 -0
  40. package/templates/opera/genesis.md +79 -94
  41. package/templates/skills/changelog-updater/locales/en/SKILL.md +11 -0
  42. package/templates/skills/commiter/locales/en/SKILL.md +11 -0
  43. package/templates/skills/project-starter-skill/SKILL.md +5 -3
  44. package/templates/skills/project-starter-skill/locales/en/SKILL.md +24 -0
  45. package/ui/css/base.css +266 -0
  46. package/ui/css/charts.css +327 -0
  47. package/ui/css/components.css +570 -0
  48. package/ui/css/panels.css +956 -0
  49. package/ui/css/tokens.css +227 -0
  50. package/ui/favicon.svg +5 -0
  51. package/ui/index.html +91 -351
  52. package/ui/js/api.js +220 -0
  53. package/ui/js/app.js +200 -0
  54. package/ui/js/console-logger.js +172 -0
  55. package/ui/js/i18n.js +14 -0
  56. package/ui/js/icons.js +104 -0
  57. package/ui/js/onboarding.js +439 -0
  58. package/ui/js/router.js +125 -0
  59. package/ui/js/state.js +130 -0
  60. package/ui/js/theme.js +100 -0
  61. package/ui/js/time-tracker.js +248 -0
  62. package/ui/js/utils.js +175 -0
  63. package/ui/js/views/board.js +255 -0
  64. package/ui/js/views/execution.js +256 -0
  65. package/ui/js/views/flash.js +47 -0
  66. package/ui/js/views/insights.js +340 -0
  67. package/ui/js/views/overview.js +365 -0
  68. package/ui/js/views/settings.js +381 -0
  69. package/ui/js/views/sidebar.js +131 -0
  70. package/ui/js/views/skills.js +163 -0
  71. package/ui/js/views/tasks.js +406 -0
  72. package/ui/js/views/topbar.js +239 -0
@@ -0,0 +1,381 @@
1
+ /**
2
+ * settings.js — Vista de configuración del proyecto
3
+ */
4
+
5
+ import { icon } from '../icons.js';
6
+ import * as state from '../state.js';
7
+ import * as api from '../api.js';
8
+ import { flash } from './flash.js';
9
+ import { esc, formatDate } from '../utils.js';
10
+ import { t } from '../i18n.js';
11
+
12
+ function applyLocaleState(payload) {
13
+ if (!payload) return;
14
+ state.update('payload', payload);
15
+ if (payload.i18n) {
16
+ state.update({
17
+ phases: payload.i18n.phases || [],
18
+ statusLabels: payload.i18n.statusLabels || {},
19
+ locale: payload.i18n.locale || 'es',
20
+ messages: payload.i18n.messages || {},
21
+ });
22
+ }
23
+ }
24
+
25
+ function renderWorkspacePanel(payload) {
26
+ const project = payload?.project;
27
+ if (!project) return '';
28
+
29
+ return `
30
+ <div class="panel">
31
+ <div class="panel-header">
32
+ <p class="panel-title">${t('ui.settings.workspaceTitle', {}, 'Workspace')}</p>
33
+ <span class="badge badge-muted">${esc(project.layout || 'legacy')}</span>
34
+ </div>
35
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
36
+ <div class="info-row">
37
+ <p class="label-sm">${t('ui.settings.workspaceRoot', {}, 'Workspace root')}</p>
38
+ <p class="value">${esc(project.workspaceRoot || project.root || '—')}</p>
39
+ </div>
40
+ <div class="info-row">
41
+ <p class="label-sm">${t('ui.settings.appRoot', {}, 'App root')}</p>
42
+ <p class="value">${esc(project.appRoot || project.root || '—')}</p>
43
+ </div>
44
+ <div class="info-row">
45
+ <p class="label-sm">${t('ui.settings.opsRoot', {}, 'Ops root')}</p>
46
+ <p class="value">${esc(project.opsRoot || project.root || '—')}</p>
47
+ </div>
48
+ </div>
49
+ </div>
50
+ `;
51
+ }
52
+
53
+ function renderEnvPanel(envState) {
54
+ if (!envState) return '';
55
+
56
+ const required = Array.isArray(envState.requiredKeys) ? envState.requiredKeys : [];
57
+ const present = Array.isArray(envState.presentKeys) ? envState.presentKeys : [];
58
+ const missing = Array.isArray(envState.missingKeys) ? envState.missingKeys : [];
59
+ const files = envState.files || {};
60
+
61
+ return `
62
+ <div class="panel">
63
+ <div class="panel-header">
64
+ <p class="panel-title">${t('ui.settings.envTitle', {}, 'Environment')}</p>
65
+ <span class="badge badge-${missing.length ? 'warning' : 'success'}">${missing.length ? t('ui.settings.envMissingBadge', { count: missing.length }, `${missing.length} missing`) : t('ui.settings.envHealthyBadge', {}, 'Ready')}</span>
66
+ </div>
67
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
68
+ <div class="info-row">
69
+ <p class="label-sm">${t('ui.settings.envBridgeMode', {}, 'Bridge mode')}</p>
70
+ <p class="value">${esc(envState.bridgeMode || 'none')}</p>
71
+ </div>
72
+ <div class="info-row">
73
+ <p class="label-sm">${t('ui.settings.envRootFile', {}, 'Root .env')}</p>
74
+ <p class="value">${esc(files.rootEnv || '—')}</p>
75
+ </div>
76
+ <div class="info-row">
77
+ <p class="label-sm">${t('ui.settings.envExampleFile', {}, '.env.example')}</p>
78
+ <p class="value">${esc(files.rootExample || '—')}</p>
79
+ </div>
80
+ <div class="info-row">
81
+ <p class="label-sm">${t('ui.settings.envAppBridge', {}, 'App bridge')}</p>
82
+ <p class="value">${esc(files.appBridge || '—')}</p>
83
+ </div>
84
+ <div class="info-row">
85
+ <p class="label-sm">${t('ui.settings.envRequiredKeys', {}, 'Required keys')}</p>
86
+ <p class="value">${required.length ? esc(required.join(', ')) : '—'}</p>
87
+ </div>
88
+ <div class="info-row">
89
+ <p class="label-sm">${t('ui.settings.envPresentKeys', {}, 'Present keys')}</p>
90
+ <p class="value">${present.length ? esc(present.join(', ')) : '—'}</p>
91
+ </div>
92
+ <div class="info-row">
93
+ <p class="label-sm">${t('ui.settings.envMissingKeys', {}, 'Missing keys')}</p>
94
+ <p class="value">${missing.length ? esc(missing.join(', ')) : t('ui.settings.envNoMissing', {}, 'None')}</p>
95
+ </div>
96
+ <div class="info-row">
97
+ <p class="label-sm">${t('ui.settings.envLastAudit', {}, 'Last audit')}</p>
98
+ <p class="value">${envState.lastAuditAt ? formatDate(envState.lastAuditAt, 'date') : '—'}</p>
99
+ </div>
100
+ <button class="btn btn-ghost btn-sm" type="button" id="sync-env-btn">
101
+ ${icon('sync', 14)} ${t('ui.settings.envSync', {}, 'Sync env')}
102
+ </button>
103
+ </div>
104
+ </div>
105
+ `;
106
+ }
107
+
108
+ export async function render() {
109
+ const payload = state.getPayload();
110
+ const projects = state.get('projects');
111
+ const currentId = state.get('currentProjectId');
112
+ const control = payload?.control;
113
+ const runtime = payload?.runtime;
114
+ const docsDirty = payload?.docsDirty || [];
115
+ const envState = payload?.env;
116
+
117
+ return `
118
+ <div class="view-enter">
119
+ <div class="section-header">
120
+ <div class="section-header-left">
121
+ <p class="eyebrow">${t('ui.settings.eyebrow', {}, 'Settings')}</p>
122
+ <h2>${t('ui.settings.title', {}, 'Project settings')}</h2>
123
+ </div>
124
+ </div>
125
+
126
+ <div class="grid-2" style="align-items:start">
127
+
128
+ <!-- Col izquierda -->
129
+ <div style="display:flex;flex-direction:column;gap:var(--space-4)">
130
+
131
+ <!-- Info del proyecto activo -->
132
+ ${control ? `
133
+ <div class="panel">
134
+ <div class="panel-header">
135
+ <p class="panel-title">Proyecto Activo</p>
136
+ <span class="badge badge-success">Activo</span>
137
+ </div>
138
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
139
+ <div class="info-row">
140
+ <p class="label-sm">Nombre</p>
141
+ <p class="value">${esc(control.meta?.projectName || '—')}</p>
142
+ </div>
143
+ <div class="info-row">
144
+ <p class="label-sm">Ruta</p>
145
+ <p class="value">${esc(payload?.project?.root || '—')}</p>
146
+ </div>
147
+ <div class="info-row">
148
+ <p class="label-sm">Fase activa</p>
149
+ <p class="value">${esc(payload?.derived?.activePhase?.id || '—')} — ${esc(payload?.derived?.activePhase?.label || '')}</p>
150
+ </div>
151
+ <div class="info-row">
152
+ <p class="label-sm">Foco actual</p>
153
+ <p class="value">${esc(control.meta?.currentFocus || '—')}</p>
154
+ </div>
155
+ <div class="info-row">
156
+ <p class="label-sm">Entrega objetivo</p>
157
+ <p class="value">${esc(control.meta?.deliveryTarget || '—')}</p>
158
+ </div>
159
+ <div class="info-row">
160
+ <p class="label-sm">Última actualización</p>
161
+ <p class="value">${formatDate(control.meta?.updatedAt || '', 'date')}</p>
162
+ </div>
163
+ <div class="info-row">
164
+ <p class="label-sm">${t('ui.topbar.language', {}, 'Language')}</p>
165
+ <div class="project-select-wrapper locale-select-wrapper">
166
+ <select id="settings-locale-select" aria-label="${t('ui.topbar.languageAria', {}, 'Select dashboard language')}">
167
+ <option value="es" ${(payload?.i18n?.locale || 'es') === 'es' ? 'selected' : ''}>${t('ui.topbar.languageEs', {}, 'ES')}</option>
168
+ <option value="en" ${(payload?.i18n?.locale || 'es') === 'en' ? 'selected' : ''}>${t('ui.topbar.languageEn', {}, 'EN')}</option>
169
+ </select>
170
+ </div>
171
+ </div>
172
+ </div>
173
+ </div>
174
+ ` : `<p class="text-muted">${t('ui.settings.noProject', {}, 'No project loaded.')}</p>`}
175
+
176
+ ${renderWorkspacePanel(payload)}
177
+
178
+ <!-- Estado del Repo -->
179
+ ${runtime ? `
180
+ <div class="panel">
181
+ <div class="panel-header">
182
+ <p class="panel-title">Repositorio</p>
183
+ <span class="badge badge-${runtime.clean ? 'success' : 'warning'}">${runtime.clean ? 'Limpio' : 'Con cambios'}</span>
184
+ </div>
185
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
186
+ <div class="info-row">
187
+ <p class="label-sm">Rama</p>
188
+ <p class="value">${esc(runtime.branch || '—')}</p>
189
+ </div>
190
+ <div class="info-row">
191
+ <p class="label-sm">Estado</p>
192
+ <p class="value">${runtime.staged}s ${runtime.unstaged}u ${runtime.untracked}?</p>
193
+ </div>
194
+ ${runtime.lastCommit ? `
195
+ <div class="info-row">
196
+ <p class="label-sm">Último commit</p>
197
+ <p class="value">${esc(runtime.lastCommit.shortHash)} · ${esc(runtime.lastCommit.subject)}</p>
198
+ </div>
199
+ <div class="info-row">
200
+ <p class="label-sm">Fecha commit</p>
201
+ <p class="value">${formatDate(runtime.lastCommit.date, 'date')}</p>
202
+ </div>
203
+ ` : ''}
204
+ <div class="info-row">
205
+ <p class="label-sm">Divergencia</p>
206
+ <p class="value">↑ ${runtime.ahead || 0} por delante · ↓ ${runtime.behind || 0} por detrás</p>
207
+ </div>
208
+ </div>
209
+ </div>
210
+ ` : ''}
211
+
212
+ </div>
213
+
214
+ <!-- Col derecha -->
215
+ <div style="display:flex;flex-direction:column;gap:var(--space-4)">
216
+
217
+ <!-- Portfolio -->
218
+ <div class="panel">
219
+ <div class="panel-header">
220
+ <p class="panel-title">Portfolio de Proyectos</p>
221
+ <span class="badge badge-muted">${projects.length}</span>
222
+ </div>
223
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
224
+ ${projects.length === 0
225
+ ? '<div class="empty-state">Sin proyectos registrados.</div>'
226
+ : projects.map(p => `
227
+ <div class="project-row ${p.id === currentId ? 'is-active' : ''}">
228
+ <div class="project-row-info">
229
+ <p class="project-name">${esc(p.name)}</p>
230
+ <p class="project-path">${esc(p.root)}</p>
231
+ </div>
232
+ <div class="project-row-actions">
233
+ ${p.available
234
+ ? `<span class="badge badge-success">Disponible</span>`
235
+ : `<span class="badge badge-warning" title="No se puede cargar el control">No disponible</span>`}
236
+ ${p.id === currentId
237
+ ? `<span class="badge badge-accent">Activo</span>`
238
+ : p.available ? `<button class="btn btn-ghost btn-sm" type="button" data-switch="${esc(p.id)}">Abrir</button>` : ''
239
+ }
240
+ </div>
241
+ </div>
242
+ `).join('')
243
+ }
244
+
245
+ <!-- Registrar nuevo -->
246
+ <div style="margin-top:var(--space-2)">
247
+ <div class="field">
248
+ <label for="new-project-path">Registrar proyecto existente</label>
249
+ <input id="new-project-path" type="text" placeholder="/ruta/al/proyecto" />
250
+ </div>
251
+ <div class="form-actions" style="margin-top:var(--space-2)">
252
+ <button class="btn btn-ghost btn-sm" type="button" id="register-project-btn">
253
+ ${icon('plus', 14)} Registrar
254
+ </button>
255
+ </div>
256
+ </div>
257
+ </div>
258
+ </div>
259
+
260
+ <!-- Docs Drift -->
261
+ <div class="panel">
262
+ <div class="panel-header">
263
+ <p class="panel-title">Documentación</p>
264
+ <span class="badge badge-${docsDirty.length ? 'warning' : 'success'}">${docsDirty.length ? `${docsDirty.length} desfasados` : 'Sincronizados'}</span>
265
+ </div>
266
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
267
+ ${docsDirty.length > 0 ? `
268
+ <p style="font-size:var(--text-sm);color:var(--text-secondary)">Los siguientes archivos de documentación están desactualizados:</p>
269
+ <div class="stack stack-sm">
270
+ ${docsDirty.map(d => `
271
+ <div class="info-row"><p class="value">${esc(d)}</p></div>
272
+ `).join('')}
273
+ </div>
274
+ ` : `
275
+ <p style="font-size:var(--text-sm);color:var(--success)">✓ Todos los archivos de documentación están sincronizados.</p>
276
+ `}
277
+ <button class="btn btn-ghost btn-sm" type="button" id="sync-docs-btn">
278
+ ${icon('sync', 14)} Sincronizar ahora
279
+ </button>
280
+ </div>
281
+ </div>
282
+
283
+ ${renderEnvPanel(envState)}
284
+
285
+ <!-- Milestones -->
286
+ ${control?.milestones?.length ? `
287
+ <div class="panel">
288
+ <div class="panel-header">
289
+ <p class="panel-title">Milestones</p>
290
+ <span class="badge badge-accent">${control.milestones.length}</span>
291
+ </div>
292
+ <div class="panel-body" style="display:flex;flex-direction:column;gap:var(--space-3)">
293
+ ${control.milestones.map(m => `
294
+ <div class="finding-item" style="border-left-color:var(--accent)">
295
+ <p style="font-weight:700;font-size:var(--text-sm)">${esc(m.title)}</p>
296
+ <p style="font-size:var(--text-xs);color:var(--text-muted)">${esc(m.date)}</p>
297
+ <ul style="margin-top:var(--space-2);padding-left:1rem">
298
+ ${(m.items || []).map(item => `<li style="font-size:var(--text-xs);color:var(--text-secondary)">${esc(item)}</li>`).join('')}
299
+ </ul>
300
+ </div>
301
+ `).join('')}
302
+ </div>
303
+ </div>
304
+ ` : ''}
305
+
306
+ </div>
307
+ </div>
308
+ </div>
309
+ `;
310
+ }
311
+
312
+ export function bindEvents() {
313
+ // Switch project
314
+ document.querySelectorAll('[data-switch]').forEach(btn => {
315
+ btn.addEventListener('click', () => {
316
+ const id = btn.dataset.switch;
317
+ state.update('currentProjectId', id);
318
+ localStorage.setItem('ops-dashboard-project', id);
319
+ window.dispatchEvent(new CustomEvent('ops:refresh'));
320
+ });
321
+ });
322
+
323
+ // Registrar proyecto
324
+ document.getElementById('register-project-btn')?.addEventListener('click', async () => {
325
+ const input = document.getElementById('new-project-path');
326
+ const root = input?.value.trim();
327
+ if (!root) { flash(t('ui.settings.enterPath', {}, 'Enter the project path.'), 'warning'); return; }
328
+ try {
329
+ await api.registerProject(root);
330
+ flash('Proyecto registrado.', 'success');
331
+ if (input) input.value = '';
332
+ window.dispatchEvent(new CustomEvent('ops:refresh'));
333
+ } catch (err) {
334
+ flash(err.message, 'error');
335
+ }
336
+ });
337
+
338
+ // Sync docs
339
+ document.getElementById('sync-docs-btn')?.addEventListener('click', async () => {
340
+ try {
341
+ await api.syncDocs();
342
+ flash('Documentación sincronizada.', 'success');
343
+ window.dispatchEvent(new CustomEvent('ops:refresh'));
344
+ } catch (err) {
345
+ flash(err.message, 'error');
346
+ }
347
+ });
348
+
349
+ document.getElementById('sync-env-btn')?.addEventListener('click', async () => {
350
+ try {
351
+ await api.syncEnv();
352
+ flash(t('ui.settings.envSynced', {}, 'Environment synced.'), 'success');
353
+ window.dispatchEvent(new CustomEvent('ops:refresh'));
354
+ } catch (err) {
355
+ flash(err.message, 'error');
356
+ }
357
+ });
358
+
359
+ document.getElementById('settings-locale-select')?.addEventListener('change', async e => {
360
+ const select = e.target;
361
+ const previousLocale = state.get('locale') || 'es';
362
+ const nextLocale = select.value;
363
+
364
+ if (nextLocale === previousLocale) return;
365
+
366
+ select.disabled = true;
367
+ try {
368
+ const result = await api.updateProjectLocale(nextLocale);
369
+ applyLocaleState(result.state);
370
+ flash(t('ui.topbar.localeUpdated', {}, 'Language updated.'), 'success');
371
+ window.dispatchEvent(new CustomEvent('ops:refresh'));
372
+ } catch (err) {
373
+ select.value = previousLocale;
374
+ flash(err.message, 'error');
375
+ } finally {
376
+ select.disabled = false;
377
+ }
378
+ });
379
+ }
380
+
381
+ export { bindEvents as bind };
@@ -0,0 +1,131 @@
1
+ /**
2
+ * sidebar.js — Sidebar de navegación lateral
3
+ */
4
+
5
+ import { icon } from '../icons.js';
6
+ import * as state from '../state.js';
7
+ import * as consoleLogger from '../console-logger.js';
8
+ import * as onboarding from '../onboarding.js';
9
+ import { t } from '../i18n.js';
10
+
11
+ /** Renderiza el sidebar completo */
12
+ export function render() {
13
+ const el = document.getElementById('sidebar');
14
+ if (!el) return;
15
+ const navItems = [
16
+ { id: 'overview', label: t('ui.nav.overview', {}, 'Overview'), icon: 'dashboard', section: 'menu' },
17
+ { id: 'tasks', label: t('ui.nav.tasks', {}, 'Tasks'), icon: 'tasks', section: 'menu', badge: true },
18
+ { id: 'board', label: t('ui.nav.board', {}, 'Board'), icon: 'board', section: 'menu' },
19
+ { id: 'execution', label: t('ui.nav.execution', {}, 'Execution'), icon: 'execution', section: 'menu' },
20
+ { id: 'skills', label: t('ui.nav.skills', {}, 'Skills'), icon: 'zap', section: 'menu' },
21
+ { id: 'insights', label: t('ui.nav.insights', {}, 'Insights'), icon: 'insights', section: 'menu' },
22
+ ];
23
+ const generalItems = [
24
+ { id: 'settings', label: t('ui.nav.settings', {}, 'Settings'), icon: 'settings' },
25
+ { id: 'help', label: t('ui.nav.help', {}, 'Help & Tour'), icon: 'help', action: 'tour' },
26
+ { id: 'console', label: t('ui.nav.logs', {}, 'Logs'), icon: 'console', action: 'console', badge: 'error' },
27
+ ];
28
+
29
+ el.innerHTML = `
30
+ <nav class="sidebar" aria-label="${t('ui.sidebar.aria', {}, 'Main navigation')}">
31
+ <!-- Logo -->
32
+ <a href="#" class="sidebar-logo" aria-label="${t('ui.sidebar.home', {}, 'TrackOps — Go home')}">
33
+ <div class="sidebar-logo-icon" aria-hidden="true">
34
+ ${icon('infinity', 20)}
35
+ </div>
36
+ <span class="sidebar-logo-name">TrackOps</span>
37
+ </a>
38
+
39
+ <!-- MENU -->
40
+ <div class="sidebar-section">
41
+ <p class="sidebar-section-label">${t('ui.sidebar.menu', {}, 'Menu')}</p>
42
+ <ul class="sidebar-nav" role="list">
43
+ ${navItems.map(item => _renderNavItem(item)).join('')}
44
+ </ul>
45
+ </div>
46
+
47
+ <!-- GENERAL -->
48
+ <div class="sidebar-footer">
49
+ <p class="sidebar-section-label" style="padding-bottom:var(--space-2)">${t('ui.sidebar.general', {}, 'General')}</p>
50
+ ${generalItems.map(item => _renderGeneralItem(item)).join('')}
51
+ </div>
52
+ </nav>
53
+ `;
54
+
55
+ _bindEvents(el);
56
+ }
57
+
58
+ function _renderNavItem(item) {
59
+ const activeView = state.get('activeView');
60
+ const isActive = activeView === item.id;
61
+ const pendingCount = _getPendingCount(item);
62
+
63
+ return `
64
+ <li role="listitem">
65
+ <button
66
+ class="nav-item ${isActive ? 'is-active' : ''}"
67
+ data-view="${item.id}"
68
+ type="button"
69
+ aria-current="${isActive ? 'page' : 'false'}"
70
+ aria-label="${item.label}${pendingCount ? `, ${t('ui.sidebar.pendingCount', { count: pendingCount }, `${pendingCount} pending`)}` : ''}"
71
+ >
72
+ <span class="nav-item-icon" aria-hidden="true">${icon(item.icon, 18)}</span>
73
+ <span class="nav-item-label">${item.label}</span>
74
+ ${pendingCount ? `<span class="nav-item-badge" aria-label="${t('ui.sidebar.tasksBadge', { count: pendingCount }, `${pendingCount} tasks`)}">${pendingCount}</span>` : ''}
75
+ </button>
76
+ </li>
77
+ `;
78
+ }
79
+
80
+ function _renderGeneralItem(item) {
81
+ return `
82
+ <button
83
+ class="nav-item"
84
+ data-action="${item.action || ''}"
85
+ data-view="${item.action ? '' : item.id}"
86
+ type="button"
87
+ aria-label="${item.label}"
88
+ ${item.action === 'console' ? 'id="sidebar-console-btn"' : ''}
89
+ >
90
+ <span class="nav-item-icon" aria-hidden="true">${icon(item.icon, 18)}</span>
91
+ <span class="nav-item-label">${item.label}</span>
92
+ ${item.badge === 'error' ? `<span class="nav-item-badge danger" id="sidebar-console-badge" aria-label="${t('ui.sidebar.errors', {}, 'errors')}" style="display:none">0</span>` : ''}
93
+ </button>
94
+ `;
95
+ }
96
+
97
+ function _getPendingCount(item) {
98
+ if (!item.badge) return 0;
99
+ const payload = state.getPayload();
100
+ if (!payload) return 0;
101
+ if (item.id === 'tasks') return payload.derived?.totals?.pending || 0;
102
+ return 0;
103
+ }
104
+
105
+ function _bindEvents(el) {
106
+ // Acciones especiales (no nav-view)
107
+ el.addEventListener('click', e => {
108
+ const btn = e.target.closest('[data-action]');
109
+ if (!btn) return;
110
+ const action = btn.dataset.action;
111
+ if (action === 'tour') {
112
+ onboarding.reset();
113
+ onboarding.show();
114
+ } else if (action === 'console') {
115
+ consoleLogger.toggle();
116
+ }
117
+ });
118
+ }
119
+
120
+ /** Refresca solo los badges sin re-renderizar todo */
121
+ export function updateBadges() {
122
+ const payload = state.getPayload();
123
+ if (!payload) return;
124
+
125
+ const pending = payload.derived?.totals?.pending || 0;
126
+ const tasksBtn = document.querySelector('[data-view="tasks"] .nav-item-badge');
127
+ if (tasksBtn) {
128
+ tasksBtn.textContent = pending;
129
+ tasksBtn.style.display = pending ? '' : 'none';
130
+ }
131
+ }