pumuki 6.3.250 → 6.3.252

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.252] - 2026-05-14
+
+### Fixed
+
+- **SDD tracking parser precision:** active tracking resolution now ignores operational bullets such as `- 🚧 Siguiente`, `- 🚧 next` or `- 🚧 delegable`; only real task identifiers are considered when realigning `pumuki sdd session --refresh`.
+
+## [6.3.251] - 2026-05-14
+
+### Fixed
+
+- **SDD session refresh tracking parity:** `pumuki sdd session --refresh` now realigns the session with the single active task in `docs/RURALGO_SEGUIMIENTO.md` when the matching OpenSpec change exists, and blocks with an actionable error instead of silently refreshing a stale task.
+
 ## [6.3.250] - 2026-05-14
 
 ### Fixed

package/docs/operations/RELEASE_NOTES.md

@@ -6,6 +6,17 @@ This file keeps only the operational highlights and rollout notes that matter wh
 
 ## 2026-04 (CLI stability and macOS notifications)
 
+### 2026-05-14 (v6.3.252)
+
+- **Parser de tracking estricto:** el refresh SDD ya no interpreta bullets operativos (`Siguiente`, `next`, `delegable`) como IDs de task activa.
+- **Rollout recomendado:** sustituir `6.3.251` por `6.3.252` en RuralGo y repetir `pumuki sdd session --refresh --ttl-minutes=90`.
+
+### 2026-05-14 (v6.3.251)
+
+- **Refresh SDD alineado con tracking activo:** `pumuki sdd session --refresh` deja de reutilizar silenciosamente una sesión antigua cuando `docs/RURALGO_SEGUIMIENTO.md` ya marca otra task activa.
+- **Bloqueo accionable si falta OpenSpec:** si el tracking activo no existe en `openspec/changes`, el refresh falla con causa concreta en vez de producir una sesión válida pero semánticamente stale.
+- **Rollout recomendado:** publicar `pumuki@6.3.251`, repinear RuralGo y revalidar `pumuki sdd session --refresh --ttl-minutes=90` sobre el slice Android activo.
+
 ### 2026-05-14 (v6.3.250)
 
 - **Normalización iOS mode-aware:** la línea activa conserva reglas iOS automatizables con evidencia concreta y deja como declarativas las reglas greenfield/brownfield que requieren contexto de adopción, baseline o migración.

package/integrations/lifecycle/update.ts

@@ -8,6 +8,7 @@ import {
   type OpenSpecCompatibilityMigrationResult,
 } from './openSpecBootstrap';
 import { getCurrentPumukiPackageName } from './packageInfo';
+import { emitGateBlockedNotification } from '../notifications/emitAuditSummaryNotification';
 
 export type LifecycleUpdateResult = {
   repoRoot: string;
@@ -28,6 +29,7 @@ export const runLifecycleUpdate = (params?: {
   targetSpec?: string;
   git?: ILifecycleGitService;
   npm?: ILifecycleNpmService;
+  notifyGateBlocked?: typeof emitGateBlockedNotification;
 }): LifecycleUpdateResult => {
   const git = params?.git ?? new LifecycleGitService();
   const npm = params?.npm ?? new LifecycleNpmService();
@@ -61,6 +63,7 @@ export const runLifecycleUpdate = (params?: {
       cwd: doctorReport.repoRoot,
       git,
       bootstrapOpenSpec: false,
+      notifyGateBlocked: params?.notifyGateBlocked,
     });
     return {
       repoRoot: installResult.repoRoot,

package/integrations/sdd/sessionStore.ts

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { resolve } from 'node:path';
 import {
   LifecycleGitService,
@@ -16,6 +16,11 @@ const SDD_KEYS = {
 
 const DEFAULT_TTL_MINUTES = 45;
 
+const TRACKING_CANDIDATE_FILES = [
+  'docs/RURALGO_SEGUIMIENTO.md',
+  'RURALGO_SEGUIMIENTO.md',
+] as const;
+
 const resolveRepoRoot = (cwd: string, git: ILifecycleGitService): string =>
   git.resolveRepoRoot(cwd);
 
@@ -32,6 +37,51 @@ const parsePositiveMinutes = (value?: number): number =>
 const normalizeChangeId = (value: string): string =>
   value.trim().toLowerCase();
 
+const collectActiveTrackingChangeIds = (markdown: string): ReadonlyArray<string> => {
+  const changeIds: string[] = [];
+  const lines = markdown.split(/\r?\n/u);
+  for (const line of lines) {
+    const boardRowMatch = line.match(/^\|\s*🚧\s*\|\s*([A-Z0-9-]+)\s*\|/u);
+    if (boardRowMatch?.[1]) {
+      changeIds.push(normalizeChangeId(boardRowMatch[1]));
+      continue;
+    }
+    const tableMatch = line.match(
+      /^\|\s*\d+\s*\|\s*`([^`]+)`\s*\|.*\|\s*🚧(?:\s+reported\s+activo|\s+En construcción|\s+En construccion)?\s*\|/u
+    );
+    if (tableMatch?.[1]) {
+      changeIds.push(normalizeChangeId(tableMatch[1]));
+      continue;
+    }
+    const bulletMatch = line.match(/^- 🚧 (`?(?:P[A-Z0-9.-]*|RGO-\d[0-9.-]*)`?)/u);
+    if (bulletMatch?.[1]) {
+      changeIds.push(normalizeChangeId(bulletMatch[1].replace(/`/gu, '')));
+    }
+  }
+  return changeIds.filter((changeId) => changeId.length > 0);
+};
+
+const resolveSingleActiveTrackingChangeId = (repoRoot: string): string | undefined => {
+  for (const candidate of TRACKING_CANDIDATE_FILES) {
+    const candidatePath = resolve(repoRoot, candidate);
+    if (!existsSync(candidatePath)) {
+      continue;
+    }
+    const changeIds = collectActiveTrackingChangeIds(readFileSync(candidatePath, 'utf8'));
+    const uniqueChangeIds = [...new Set(changeIds)];
+    if (uniqueChangeIds.length === 1) {
+      return uniqueChangeIds[0];
+    }
+    if (uniqueChangeIds.length > 1) {
+      throw new Error(
+        `Multiple active tracking changes found in ${candidate}: ${uniqueChangeIds.join(', ')}. ` +
+        'Keep exactly one active task before refreshing the SDD session.'
+      );
+    }
+  }
+  return undefined;
+};
+
 export const listActiveOpenSpecChangeIds = (repoRoot: string): ReadonlyArray<string> => {
   const changesRoot = resolve(repoRoot, 'openspec', 'changes');
   if (!existsSync(changesRoot)) {
@@ -178,6 +228,24 @@ export const refreshSddSession = (params?: {
   if (!current.changeId) {
     throw new Error('No active SDD session to refresh. Run `pumuki sdd session --open --change=<id>` first.');
   }
+  const trackingChangeId = resolveSingleActiveTrackingChangeId(repoRoot);
+  if (trackingChangeId && trackingChangeId !== current.changeId) {
+    const trackingChangeState = ensureChangePath(repoRoot, trackingChangeId);
+    if (!trackingChangeState.exists) {
+      throw new Error(
+        `Active tracking change "${trackingChangeId}" does not exist in openspec/changes. ` +
+        `Current SDD session points to "${current.changeId}". ` +
+        `Create openspec/changes/${trackingChangeId} or run ` +
+        `\`pumuki sdd session --open --change=${trackingChangeId}\` after creating it.`
+      );
+    }
+    if (trackingChangeState.archived) {
+      throw new Error(
+        `Active tracking change "${trackingChangeId}" is archived and cannot refresh the SDD session.`
+      );
+    }
+    git.applyLocalConfig(repoRoot, SDD_KEYS.change, trackingChangeId);
+  }
   const ttlMinutes = parsePositiveMinutes(params?.ttlMinutes ?? current.ttlMinutes);
   git.applyLocalConfig(repoRoot, SDD_KEYS.updatedAt, nowIso());
   git.applyLocalConfig(repoRoot, SDD_KEYS.expiresAt, addMinutesIso(ttlMinutes));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.250",
+  "version": "6.3.252",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {