trackops 2.0.6 → 2.1.0

package/skills/trackops/skill.json

@@ -1,29 +1,29 @@
-{
-  "name": "trackops",
-  "shortDescription": "Global TrackOps skill that explains TrackOps, requires explicit runtime install, and guides per-repository activation.",
-  "description": "Explains what TrackOps does, installs the global skill layer, requires explicit runtime installation with npm, supports Spanish and English, activates TrackOps repository by repository, and routes OPERA onboarding into either direct bootstrap or agent-led discovery.",
-  "skillVersion": "2.0.6",
-  "trackopsVersion": "2.0.6",
-  "npmPackage": "trackops",
-  "bootstrapPolicy": "explicit_install",
-  "supportedAgentsV1": [
-    "antigravity",
-    "claude-code",
-    "codex",
-    "cursor",
-    "gemini-cli",
-    "github-copilot",
-    "kiro-cli"
-  ],
-  "distribution": {
-    "source": "Baxahaun/trackops",
-    "skill": "trackops",
-    "fullDepth": true
-  },
-  "repository": {
-    "provider": "github",
-    "owner": "Baxahaun",
-    "repo": "trackops",
-    "skillPath": "skills/trackops"
-  }
-}
+{
+  "name": "trackops",
+  "shortDescription": "Global TrackOps skill that explains TrackOps, requires explicit runtime install, and guides per-repository activation.",
+  "description": "Explains what TrackOps does, installs the global skill layer, requires explicit runtime installation with npm, supports Spanish and English, activates TrackOps repository by repository, and routes OPERA onboarding into either direct bootstrap or agent-led discovery.",
+  "skillVersion": "2.1.0",
+  "trackopsVersion": "2.1.0",
+  "npmPackage": "trackops",
+  "bootstrapPolicy": "explicit_install",
+  "supportedAgentsV1": [
+    "antigravity",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "github-copilot",
+    "kiro-cli"
+  ],
+  "distribution": {
+    "source": "Baxahaun/trackops",
+    "skill": "trackops",
+    "fullDepth": true
+  },
+  "repository": {
+    "provider": "github",
+    "owner": "Baxahaun",
+    "repo": "trackops",
+    "skillPath": "skills/trackops"
+  }
+}

package/templates/skills/opera-quality-guard/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: "opera-quality-guard"
+description: "Guardia local de calidad para proyectos OPERA. Obliga al agente a consultar estado de calidad, ejecutar verificaciones declaradas y comprobar readiness antes de release o recomendacion de despliegue."
+metadata:
+  version: "1.0"
+  type: "project"
+---
+
+# OPERA Quality Guard
+
+## Mision
+
+Complementar OPERA con una capa de calidad continua y readiness de salida.
+
+## Reglas
+
+- antes de cerrar una fase, ejecuta `trackops quality status`
+- tras cambios relevantes en codigo, entorno, build o smoke, ejecuta `trackops quality verify`
+- antes de `trackops release`, ejecuta `trackops quality release-readiness`
+- antes de recomendar produccion, ejecuta `trackops quality promote-readiness --target production`
+- si la readiness esta bloqueada, no inventes excepciones: explica el bloqueo real y los pasos para resolverlo
+- solo usa waivers si existe una aprobacion humana explicita y con caducidad
+
+## Prioridad
+
+La calidad complementa OPERA; no sustituye backlog, contrato ni politica.

package/templates/skills/opera-quality-guard/locales/en/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: "opera-quality-guard"
+description: "Local quality guard for OPERA projects. Forces the agent to inspect quality status, run declared verification, and check readiness before release or deployment recommendations."
+metadata:
+  version: "1.0"
+  type: "project"
+---
+
+# OPERA Quality Guard
+
+## Mission
+
+Complement OPERA with continuous quality and production-readiness checks.
+
+## Rules
+
+- before closing a phase, run `trackops quality status`
+- after relevant code, environment, build, or smoke changes, run `trackops quality verify`
+- before `trackops release`, run `trackops quality release-readiness`
+- before recommending production, run `trackops quality promote-readiness --target production`
+- if readiness is blocked, report the real blocker and the concrete remediation steps
+- only use waivers when there is explicit human approval and an expiry
+
+## Priority
+
+Quality complements OPERA; it does not replace backlog, contract, or policy.

package/templates/skills/opera-skill/SKILL.md

@@ -51,6 +51,12 @@ Antes de asumir nada, ejecuta:
 trackops status
 ```
 
+Y antes de cerrar una fase, release o recomendacion de despliegue, ejecuta:
+
+```bash
+trackops quality status
+```
+
 - si `trackops status` falla, no sigas
 - si no existe TrackOps activo, redirige a la skill global `trackops`
 - si OPERA no esta instalado, indica `trackops opera install`
@@ -202,6 +208,8 @@ Formalizar release, despliegue y automatizacion operativa con seguridad.
 - `trackops status`
 - `trackops workspace status`
 - `trackops env status`
+- `trackops quality release-readiness`
+- `trackops quality promote-readiness --target production`
 - `trackops sync`
 
 ### Skills delegables

package/templates/skills/opera-skill/locales/en/SKILL.md

@@ -51,6 +51,12 @@ Before assuming anything, run:
 trackops status
 ```
 
+And before closing a phase, a release, or a deployment recommendation, run:
+
+```bash
+trackops quality status
+```
+
 - if `trackops status` fails, stop
 - if there is no active TrackOps, redirect to the global `trackops` skill
 - if OPERA is not installed, indicate `trackops opera install`
@@ -202,6 +208,8 @@ Formalize release, deployment, and operational automation with safety.
 - `trackops status`
 - `trackops workspace status`
 - `trackops env status`
+- `trackops quality release-readiness`
+- `trackops quality promote-readiness --target production`
 - `trackops sync`
 
 ### Delegable skills

package/ui/js/api.js

@@ -142,12 +142,12 @@ export async function createTask(payload) {
  * @param {string} taskId
  * @param {Object} payload
  */
-export async function updateTask(taskId, payload) {
-  return call(`/api/tasks/${encodeURIComponent(taskId)}`, {
-    method: 'PUT',
-    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload }),
-  });
-}
+export async function updateTask(taskId, payload, meta = {}) {
+  return call(`/api/tasks/${encodeURIComponent(taskId)}`, {
+    method: 'PUT',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload, ...meta }),
+  });
+}
 
 /**
  * Ejecuta una acción sobre una tarea (start, review, complete, block, pending, cancel)
@@ -155,14 +155,81 @@ export async function updateTask(taskId, payload) {
  * @param {string} action
  * @param {string} [note]
  */
-export async function taskAction(taskId, action, note = '') {
-  return call(`/api/tasks/${encodeURIComponent(taskId)}/action`, {
-    method: 'POST',
-    body: JSON.stringify({ projectId: state.get('currentProjectId'), action, note }),
-  });
-}
-
-// ─────────────────────────────── SYNC ───────────────────────────────────────
+export async function taskAction(taskId, action, note = '', meta = {}) {
+  return call(`/api/tasks/${encodeURIComponent(taskId)}/action`, {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), action, note, ...meta }),
+  });
+}
+
+// ─────────────────────────────── PLANS ──────────────────────────────────────
+
+export async function getPlans() {
+  return call('/api/plans');
+}
+
+export async function getPlan(sourceId) {
+  return call(`/api/plans/${encodeURIComponent(sourceId)}`);
+}
+
+export async function scanPlans(scanPath = '') {
+  return call('/api/plans/scan', {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), path: scanPath || undefined }),
+  });
+}
+
+export async function importPlan(payload) {
+  return call('/api/plans/import', {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload }),
+  });
+}
+
+export async function applyPlan(sourceId, payload = {}) {
+  return call(`/api/plans/${encodeURIComponent(sourceId)}/apply`, {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload }),
+  });
+}
+
+export async function unlinkPlan(sourceId, payload = {}) {
+  return call(`/api/plans/${encodeURIComponent(sourceId)}/unlink`, {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload }),
+  });
+}
+
+// ─────────────────────────────── QUALITY ────────────────────────────────────
+
+export async function getQuality() {
+  return call('/api/quality');
+}
+
+export async function verifyQuality(payload = {}) {
+  return call('/api/quality/verify', {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), ...payload }),
+  });
+}
+
+export async function getPhaseReadiness(phase = 'current') {
+  return call(`/api/quality/phase-readiness?phase=${encodeURIComponent(phase)}`);
+}
+
+export async function getReleaseReadiness() {
+  return call('/api/quality/release-readiness');
+}
+
+export async function getPromotionReadiness(target = 'production') {
+  return call(`/api/quality/promotion-readiness?target=${encodeURIComponent(target)}`);
+}
+
+export async function getQualityWaivers() {
+  return call('/api/quality/waivers');
+}
+
+// ─────────────────────────────── SYNC ───────────────────────────────────────
 
 /**
  * Sincroniza los docs del proyecto (task_plan.md, progress.md, findings.md)
@@ -180,12 +247,12 @@ export async function syncDocs() {
  * Ejecuta un comando en el shell del proyecto
  * @param {string} command
  */
-export async function runCommand(command) {
-  return call('/api/commands', {
-    method: 'POST',
-    body: JSON.stringify({ projectId: state.get('currentProjectId'), command }),
-  });
-}
+export async function runCommand(command, meta = {}) {
+  return call('/api/commands', {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), command, ...meta }),
+  });
+}
 
 /**
  * Crea un EventSource para hacer streaming de salida de una sesión
@@ -203,12 +270,12 @@ export function streamSession(sessionId) {
  * @param {string} taskId
  * @param {string} taskTitle
  */
-export async function startTimeEntry(taskId, taskTitle) {
-  return call('/api/time/start', {
-    method: 'POST',
-    body: JSON.stringify({ projectId: state.get('currentProjectId'), taskId, taskTitle }),
-  });
-}
+export async function startTimeEntry(taskId, taskTitle, meta = {}) {
+  return call('/api/time/start', {
+    method: 'POST',
+    body: JSON.stringify({ projectId: state.get('currentProjectId'), taskId, taskTitle, ...meta }),
+  });
+}
 
 /**
  * Detiene el time entry activo

package/ui/js/app.js

@@ -15,8 +15,9 @@ import * as keyboard from './keyboard.js';
 // Vistas
 import { render as renderSidebar } from './views/sidebar.js';
 import { render as renderTopbar  } from './views/topbar.js';
-import * as dashboardView from './views/dashboard.js';
-import * as tasksView from './views/tasks.js';
+import * as dashboardView from './views/dashboard.js';
+import * as plansView from './views/plans.js';
+import * as tasksView from './views/tasks.js';
 import * as executionView from './views/execution.js';
 import * as projectsView from './views/projects.js';
 import { render as renderTimeline } from './views/timeline.js';
@@ -37,11 +38,16 @@ async function init() {
     setTimeout(() => dashboardView.bindEvents?.(), 50);
     return html;
   });
-  router.register('tasks', async () => {
-    const html = await tasksView.render();
-    setTimeout(() => tasksView.bindEvents?.(), 50);
-    return html;
-  });
+  router.register('tasks', async () => {
+    const html = await tasksView.render();
+    setTimeout(() => tasksView.bindEvents?.(), 50);
+    return html;
+  });
+  router.register('plans', async () => {
+    const html = await plansView.render();
+    setTimeout(() => plansView.bindEvents?.(), 50);
+    return html;
+  });
   router.register('terminal', async () => {
     const html = await executionView.render();
     setTimeout(() => executionView.bindEvents(), 50);

package/ui/js/filters.js

@@ -11,7 +11,7 @@ import { t } from './i18n.js';
 const STORAGE_PREFIX = 'ops-filters-';
 
 /** Claves de filtro soportadas */
-const FILTER_KEYS = ['status', 'priority', 'phase', 'stream', 'search'];
+const FILTER_KEYS = ['status', 'priority', 'phase', 'stream', 'sourceId', 'rootId', 'search'];
 
 // ─────────────────────────────── PERSISTENCE ─────────────────────────────────
 
@@ -67,15 +67,17 @@ export function apply(tasks, filters) {
   return tasks.filter(task => {
     if (filters.status && task.status !== filters.status) return false;
     if (filters.priority && task.priority !== filters.priority) return false;
-    if (filters.phase && task.phase !== filters.phase) return false;
-    if (filters.stream && task.stream !== filters.stream) return false;
-    if (filters.search) {
-      const q = filters.search.toLowerCase();
-      const haystack = `${task.title} ${task.id} ${task.summary || ''} ${task.stream || ''}`.toLowerCase();
-      if (!haystack.includes(q)) return false;
-    }
-    return true;
-  });
+    if (filters.phase && task.phase !== filters.phase) return false;
+    if (filters.stream && task.stream !== filters.stream) return false;
+    if (filters.sourceId && (task.sourceId || task.origin?.sourceId || '') !== filters.sourceId) return false;
+    if (filters.rootId && (task.rootId || task.id) !== filters.rootId) return false;
+    if (filters.search) {
+      const q = filters.search.toLowerCase();
+      const haystack = `${task.title} ${task.id} ${task.summary || ''} ${task.stream || ''} ${task.sourceId || task.origin?.sourceId || ''} ${task.rootTitle || ''}`.toLowerCase();
+      if (!haystack.includes(q)) return false;
+    }
+    return true;
+  });
 }
 
 // ─────────────────────────────── CONTEO ──────────────────────────────────────
@@ -99,16 +101,20 @@ export function count(filters) {
  * @param {Object} options — Opciones de renderizado
  * @param {Array} [options.statuses] — Estados disponibles
  * @param {Array} [options.priorities] — Prioridades disponibles
- * @param {Array} [options.phases] — Fases disponibles
- * @param {Array} [options.streams] — Streams disponibles
- * @returns {string} HTML
- */
-export function renderBar(viewId, filters, options = {}) {
-  const statusLabels = state.getStatusLabels?.() || {};
-  const phases = options.phases || state.getPhases?.() || [];
-  const statuses = options.statuses || ['pending', 'in_progress', 'in_review', 'blocked', 'completed', 'cancelled'];
-  const priorities = options.priorities || ['P0', 'P1', 'P2', 'P3'];
-  const streams = options.streams || [];
+ * @param {Array} [options.phases] — Fases disponibles
+ * @param {Array} [options.streams] — Streams disponibles
+ * @param {Array} [options.sources] — Source ids disponibles
+ * @param {Array} [options.roots] — Root tasks disponibles
+ * @returns {string} HTML
+ */
+export function renderBar(viewId, filters, options = {}) {
+  const statusLabels = state.getStatusLabels?.() || {};
+  const phases = options.phases || state.getPhases?.() || [];
+  const statuses = options.statuses || ['pending', 'in_progress', 'in_review', 'blocked', 'completed', 'cancelled'];
+  const priorities = options.priorities || ['P0', 'P1', 'P2', 'P3'];
+  const streams = options.streams || [];
+  const sources = options.sources || [];
+  const roots = options.roots || [];
 
   return `
     <div class="filter-bar" role="search" aria-label="${t('ui.filters.label', {}, 'Filter tasks')}">
@@ -125,9 +131,17 @@ export function renderBar(viewId, filters, options = {}) {
           value: p.id, label: `${p.id} · ${p.label}`
         })), t('ui.filters.phase', {}, 'Phase')) : ''}
 
-        ${streams.length ? _renderSelect('stream', filters.stream, streams.map(s => ({
-          value: s, label: s
-        })), t('ui.filters.stream', {}, 'Stream')) : ''}
+        ${streams.length ? _renderSelect('stream', filters.stream, streams.map(s => ({
+          value: s, label: s
+        })), t('ui.filters.stream', {}, 'Stream')) : ''}
+
+        ${sources.length ? _renderSelect('sourceId', filters.sourceId, sources.map(source => ({
+          value: source, label: source
+        })), t('ui.filters.source', {}, 'Source')) : ''}
+
+        ${roots.length ? _renderSelect('rootId', filters.rootId, roots.map(root => ({
+          value: root.id, label: root.title
+        })), t('ui.filters.root', {}, 'Root')) : ''}
 
         <div class="filter-search">
           <input
@@ -177,12 +191,18 @@ function _renderActiveChips(filters, statusLabels, phases) {
     const phase = phases.find(p => p.id === filters.phase);
     chips.push({ key: 'phase', label: phase ? `${phase.id} · ${phase.label}` : filters.phase });
   }
-  if (filters.stream) {
-    chips.push({ key: 'stream', label: filters.stream });
-  }
-  if (filters.search) {
-    chips.push({ key: 'search', label: `"${filters.search}"` });
-  }
+  if (filters.stream) {
+    chips.push({ key: 'stream', label: filters.stream });
+  }
+  if (filters.sourceId) {
+    chips.push({ key: 'sourceId', label: filters.sourceId });
+  }
+  if (filters.rootId) {
+    chips.push({ key: 'rootId', label: filters.rootId });
+  }
+  if (filters.search) {
+    chips.push({ key: 'search', label: `"${filters.search}"` });
+  }
 
   return chips.map(c => `
     <span class="chip chip-active" data-filter-remove="${c.key}">

package/ui/js/time-tracker.js

@@ -18,32 +18,40 @@ let _startMs  = null;
  * @param {string} taskId
  * @param {string} taskTitle
  */
-export async function start(taskId, taskTitle) {
-  // Si hay uno en curso, detenerlo primero
-  if (state.get('activeEntry')) {
-    await stop();
-  }
+export async function start(taskId, taskTitle) {
+  // Si hay uno en curso, detenerlo primero
+  if (state.get('activeEntry')) {
+    await stop();
+  }
 
-  try {
-    const result = await api.startTimeEntry(taskId, taskTitle);
+  try {
+    const result = await api.startTimeEntry(taskId, taskTitle, {
+      actor: 'user',
+      source: 'time_tracker',
+    });
     const entry = {
       id:        result.entry?.id || `local-${Date.now()}`,
       taskId,
       taskTitle,
       startedAt: result.entry?.startedAt || new Date().toISOString(),
     };
-    state.update('activeEntry', entry);
-    _startMs = Date.now() - (result.entry?.elapsedMs || 0);
-    _startInterval();
-    _updateTopbarTimer();
-    flash(`Timer iniciado: ${taskTitle}`, 'success');
-  } catch (err) {
-    // Fallback local si el backend no tiene el endpoint todavía
-    const entry = {
-      id:        `local-${Date.now()}`,
-      taskId,
-      taskTitle,
-      startedAt: new Date().toISOString(),
+    state.update('activeEntry', entry);
+    _startMs = Date.now() - (result.entry?.elapsedMs || 0);
+    _startInterval();
+    _updateTopbarTimer();
+    flash(`Timer iniciado: ${taskTitle}`, 'success');
+    window.dispatchEvent(new CustomEvent('ops:refresh'));
+  } catch (err) {
+    if (!_shouldUseLocalFallback(err)) {
+      flash(err.message || 'No se pudo iniciar el timer.', 'error');
+      return;
+    }
+    // Fallback local si el backend no tiene el endpoint todavía
+    const entry = {
+      id:        `local-${Date.now()}`,
+      taskId,
+      taskTitle,
+      startedAt: new Date().toISOString(),
     };
     state.update('activeEntry', entry);
     _startMs = Date.now();
@@ -72,9 +80,9 @@ export function resume() {
 /**
  * Detiene el timer y persiste en el backend
  */
-export async function stop() {
-  const entry = state.get('activeEntry');
-  if (!entry) return;
+export async function stop() {
+  const entry = state.get('activeEntry');
+  if (!entry) return;
 
   _stopInterval();
   const elapsed = _startMs ? Date.now() - _startMs : 0;
@@ -99,10 +107,11 @@ export async function stop() {
     state.update('timeEntries', timeEntries.slice(0, 50));
   }
 
-  state.update('activeEntry', null);
-  _startMs = null;
-  _updateTopbarTimer();
-}
+  state.update('activeEntry', null);
+  _startMs = null;
+  _updateTopbarTimer();
+  window.dispatchEvent(new CustomEvent('ops:refresh'));
+}
 
 /**
  * Obtiene el tiempo transcurrido actual en ms
@@ -144,13 +153,17 @@ function _startInterval() {
   }, 1000);
 }
 
-function _stopInterval() {
+function _stopInterval() {
   if (_interval) {
     clearInterval(_interval);
     _interval = null;
   }
   state.update('timerInterval', null);
-}
+}
+
+function _shouldUseLocalFallback(err) {
+  return err?.status === 404 || err?.status === 405 || err?.status === 501;
+}
 
 function _updateTimerDisplays() {
   const elapsed = getElapsed();

package/ui/js/views/board.js

@@ -145,15 +145,20 @@ function _renderCard(task, phases) {
       <strong class="task-card-title">${esc(task.title)}</strong>
       <span class="task-card-id">${esc(task.id)}</span>
       <p class="task-card-summary">${esc(task.summary || t('ui.board.noDescription', {}, 'No description.'))}</p>
-      <div class="task-card-meta">
-        <span class="badge badge-${priorityVariant[task.priority] || 'muted'}">${esc(task.priority)}</span>
-        <span class="badge badge-muted">${esc(phaseInfo?.label || task.phase)}</span>
-        ${task.stream ? `<span class="badge badge-muted">${esc(task.stream)}</span>` : ''}
-        ${task.blocker ? `<span class="badge badge-danger" title="${esc(task.blocker)}">${icon('alertTriangle', 10)} ${t('status.blocked', {}, 'Blocked')}</span>` : ''}
-      </div>
-    </article>
-  `;
-}
+      <div class="task-card-meta">
+        <span class="badge badge-${priorityVariant[task.priority] || 'muted'}">${esc(task.priority)}</span>
+        <span class="badge badge-muted">${esc(phaseInfo?.label || task.phase)}</span>
+        ${task.stream ? `<span class="badge badge-muted">${esc(task.stream)}</span>` : ''}
+        ${task.executionOwner ? `<span class="badge badge-muted">${esc(`exec:${task.executionOwner}`)}</span>` : ''}
+        ${task.sourceId ? `<span class="badge badge-muted">${esc(`plan:${task.sourceId}`)}</span>` : ''}
+        ${task.rootId && task.rootId !== task.id ? `<span class="badge badge-muted">${esc(`root:${task.rootTitle}`)}</span>` : ''}
+        ${task.awaitingUserConfirmation ? `<span class="badge badge-warning">${t('ui.tasks.awaitingUser', {}, 'Awaiting user')}</span>` : ''}
+        ${task.verificationPending ? `<span class="badge badge-accent">${t('ui.tasks.verifyPending', {}, 'Verify state')}</span>` : ''}
+        ${task.blocker ? `<span class="badge badge-danger" title="${esc(task.blocker)}">${icon('alertTriangle', 10)} ${t('status.blocked', {}, 'Blocked')}</span>` : ''}
+      </div>
+    </article>
+  `;
+}
 
 function _bindDragDrop(board) {
   board.addEventListener('dragstart', e => {
@@ -214,11 +219,14 @@ function _bindDragDrop(board) {
     const action = statusToAction[newStatus];
     if (!action) return;
 
-    try {
-      await api.taskAction(taskId, action, t('ui.board.movedFromBoard', { status: newStatus }, `Moved to ${newStatus} from the board.`));
-      flash(t('ui.board.movedSuccess', { status: newStatus }, `Task moved to ${newStatus}.`), 'success');
-      window.dispatchEvent(new CustomEvent('ops:refresh'));
-    } catch (err) {
+    try {
+      await api.taskAction(taskId, action, t('ui.board.movedFromBoard', { status: newStatus }, `Moved to ${newStatus} from the board.`), {
+        actor: 'user',
+        source: 'board',
+      });
+      flash(t('ui.board.movedSuccess', { status: newStatus }, `Task moved to ${newStatus}.`), 'success');
+      window.dispatchEvent(new CustomEvent('ops:refresh'));
+    } catch (err) {
       flash(err.message, 'error');
     }
   });