pumuki 6.3.35 → 6.3.36

package/VERSION

@@ -1 +1 @@
-v6.3.24
+v6.3.36

package/docs/CONFIGURATION.md

@@ -191,6 +191,7 @@ Behavior:
 - non dry-run: persists `learning.json` deterministically and reports digest/path in output.
 - `rule_updates`: deterministic recommendations derived from evidence/gate signals (`missing`, `invalid`, `blocked`, `allowed`).
 - dedicated command: `pumuki sdd learn --change=<id> [--stage=<stage>] [--task=<task>] [--dry-run] [--json]` generates/persists the same artifact without requiring `sync-docs`.
+- orchestration command: `pumuki sdd auto-sync --change=<id> [--stage=<stage>] [--task=<task>] [--dry-run] [--json]` executes deterministic docs sync plus learning generation in one step.
 
 ## Gate telemetry export (optional)
 

package/docs/RELEASE_NOTES.md

@@ -5,6 +5,22 @@ Detailed commit history remains available through Git history (`git log` / `git
 
 ## 2026-03 (enterprise hardening updates)
 
+### 2026-03-04 (v6.3.36)
+
+- SDD orchestration hardening shipped:
+  - New enterprise command `pumuki sdd auto-sync` with `--change`, optional `--stage/--task`, `--dry-run`, and `--json`.
+  - `auto-sync` orchestrates deterministic docs sync plus learning generation in one step.
+  - Fail-safe behavior preserved through the existing transactional `sync-docs` path (no partial writes on conflict).
+- Traceability:
+  - implementation issue: `#600`
+  - implementation PR: `#602`
+  - tracking sync PR: `#604`
+- Consumer quick verification:
+  - `npx --yes --package pumuki@latest pumuki sdd auto-sync --change=rgo-quickstart-02 --stage=PRE_WRITE --task=P12.F2.T70 --dry-run --json`
+  - expected signal:
+    - `command=pumuki sdd auto-sync` available in CLI help.
+    - JSON payload includes `syncDocs.updated` and `learning.path`.
+
 ### 2026-03-04 (v6.3.35)
 
 - SDD enterprise incremental hardening shipped:

package/docs/registro-maestro-de-seguimiento.md

@@ -7,8 +7,8 @@
 ## Estado actual
 - Plan activo: `docs/seguimiento-completo-validacion-ruralgo-03-03-2026.md`
 - Estado del plan: EN CURSO
-- Última task cerrada (`✅`): `P12.F2.T68` (nuevo comando `pumuki sdd learn`, issue `#597`, PR `#599`).
-- Task activa (`🚧`): `P12.F2.T69` (publicar release `6.3.35` con cierre SDD incremental en npm).
+- Última task cerrada (`✅`): `P12.F2.T70` (comando orquestador `pumuki sdd auto-sync`, issue `#600`, PR `#602`, commit `2be34c5`).
+- Task activa (`🚧`): `P12.F2.T71` (publicar release `6.3.36` con `auto-sync`, issue `#603`).
 
 ## Historial resumido
 - No se mantienen MDs históricos de seguimiento en este repositorio.

package/docs/seguimiento-completo-validacion-ruralgo-03-03-2026.md

@@ -1942,11 +1942,37 @@ Criterio de salida F5:
     - `npx --yes tsx@4.21.0 --test integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` => `38 passed, 0 failed`.
     - `npm run -s typecheck` => `exit 0`.
 
-- 🚧 `P12.F2.T69` Publicar release `6.3.35` con cierre SDD incremental.
+- ✅ `P12.F2.T69` Publicar release `6.3.35` con cierre SDD incremental.
+  - cierre ejecutado:
+    - versión incrementada a `6.3.35` en `package.json` y `package-lock.json`.
+    - release notes actualizadas con entrada `2026-03-04 (v6.3.35)` en `docs/RELEASE_NOTES.md`.
+    - publicación npm ejecutada con éxito (`npm publish --access public`).
+    - propagación validada:
+      - `npm view pumuki dist-tags --json` => `"latest": "6.3.35"`.
+      - smoke `@latest` en carpeta temporal mostrando `pumuki sdd learn ...` en `--help`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/sdd/__tests__/syncDocs.test.ts integrations/lifecycle/__tests__/cli.test.ts` => `38 passed, 0 failed`.
+    - `npm run -s typecheck` => `exit 0`.
+    - `npm publish --access public` => `+ pumuki@6.3.35`.
+    - `npm view pumuki@6.3.35 version` => `6.3.35`.
+
+- ✅ `P12.F2.T70` Siguiente SDD pendiente enterprise: comando orquestador `pumuki sdd auto-sync` (`#600`).
+  - cierre ejecutado:
+    - nuevo runtime `runSddAutoSync` en capa SDD para orquestar `sync-docs` + `learning` en un único paso determinista.
+    - CLI ampliada con:
+      - `pumuki sdd auto-sync --change=<id> --stage=<stage> --task=<task-id> [--dry-run] [--json]`.
+    - cobertura de regresión añadida en `syncDocs`/`index`/`cli` y documentación actualizada en `docs/CONFIGURATION.md`.
+    - issue cerrada: `#600`.
+    - PR mergeada: `#602` (`commit 2be34c5`).
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/sdd/__tests__/syncDocs.test.ts integrations/sdd/__tests__/index.test.ts integrations/lifecycle/__tests__/cli.test.ts` => `44 passed, 0 failed`.
+    - `npm run -s typecheck` => `exit 0`.
+
+- 🚧 `P12.F2.T71` Publicar release `6.3.36` con `pumuki sdd auto-sync` (`#603`).
   - salida esperada:
-    - bump de versión (`package.json`, `package-lock.json`) + nota de release.
-    - publicación npm exitosa y verificación `npm view pumuki version`.
-    - smoke mínimo con `npx --yes --package pumuki@latest pumuki --help`.
+    - versionado a `6.3.36` en `package.json`, `package-lock.json` y `VERSION`.
+    - release notes actualizadas con entrada `v6.3.36`.
+    - publicación npm validada (`latest=6.3.36`) + smoke de `--help` mostrando `auto-sync`.
 
 Criterio de salida F6:
 - veredicto final trazable y cierre administrativo completo.

package/integrations/lifecycle/cli.ts

@@ -27,6 +27,7 @@ import {
   openSddSession,
   readSddStatus,
   refreshSddSession,
+  runSddAutoSync,
   runSddLearn,
   runSddSyncDocs,
   type SddStage,
@@ -63,7 +64,7 @@ type LifecycleCommand =
   | 'adapter'
   | 'analytics';
 
-type SddCommand = 'status' | 'validate' | 'session' | 'sync-docs' | 'learn';
+type SddCommand = 'status' | 'validate' | 'session' | 'sync-docs' | 'learn' | 'auto-sync';
 type LoopCommand = 'run' | 'status' | 'stop' | 'resume' | 'list' | 'export';
 type AnalyticsCommand = 'hotspots';
 type AnalyticsHotspotsCommand = 'report' | 'diagnose';
@@ -95,6 +96,10 @@ type ParsedArgs = {
   sddLearnChange?: string;
   sddLearnStage?: SddStage;
   sddLearnTask?: string;
+  sddAutoSyncDryRun?: boolean;
+  sddAutoSyncChange?: string;
+  sddAutoSyncStage?: SddStage;
+  sddAutoSyncTask?: string;
   adapterCommand?: 'install';
   adapterAgent?: AdapterAgent;
   adapterDryRun?: boolean;
@@ -130,6 +135,7 @@ Pumuki lifecycle commands:
   pumuki sdd session --close [--json]
   pumuki sdd sync-docs [--change=<change-id>] [--stage=PRE_WRITE|PRE_COMMIT|PRE_PUSH|CI] [--task=<task-id>] [--dry-run] [--json]
   pumuki sdd learn --change=<change-id> [--stage=PRE_WRITE|PRE_COMMIT|PRE_PUSH|CI] [--task=<task-id>] [--dry-run] [--json]
+  pumuki sdd auto-sync --change=<change-id> [--stage=PRE_WRITE|PRE_COMMIT|PRE_PUSH|CI] [--task=<task-id>] [--dry-run] [--json]
 `.trim();
 
 const LOOP_RUN_POLICY: GatePolicy = {
@@ -436,6 +442,10 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
   let sddLearnChange: ParsedArgs['sddLearnChange'];
   let sddLearnStage: ParsedArgs['sddLearnStage'];
   let sddLearnTask: ParsedArgs['sddLearnTask'];
+  let sddAutoSyncDryRun = false;
+  let sddAutoSyncChange: ParsedArgs['sddAutoSyncChange'];
+  let sddAutoSyncStage: ParsedArgs['sddAutoSyncStage'];
+  let sddAutoSyncTask: ParsedArgs['sddAutoSyncTask'];
   let adapterCommand: ParsedArgs['adapterCommand'];
   let adapterAgent: ParsedArgs['adapterAgent'];
   let adapterDryRun = false;
@@ -615,7 +625,8 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
       subcommandRaw !== 'validate' &&
       subcommandRaw !== 'session' &&
       subcommandRaw !== 'sync-docs' &&
-      subcommandRaw !== 'learn'
+      subcommandRaw !== 'learn' &&
+      subcommandRaw !== 'auto-sync'
     ) {
       throw new Error(`Unsupported SDD subcommand "${subcommandRaw}".\n\n${HELP_TEXT}`);
     }
@@ -635,7 +646,11 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
           sddLearnDryRun = true;
           continue;
         }
-        throw new Error(`--dry-run is only supported with "pumuki sdd sync-docs" or "pumuki sdd learn".\n\n${HELP_TEXT}`);
+        if (sddCommand === 'auto-sync') {
+          sddAutoSyncDryRun = true;
+          continue;
+        }
+        throw new Error(`--dry-run is only supported with "pumuki sdd sync-docs", "pumuki sdd learn" or "pumuki sdd auto-sync".\n\n${HELP_TEXT}`);
       }
       if (arg.startsWith('--stage=')) {
         if (sddCommand === 'validate') {
@@ -650,7 +665,11 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
           sddLearnStage = parseSddStage(arg.slice('--stage='.length));
           continue;
         }
-        throw new Error(`--stage is only supported with "pumuki sdd validate", "pumuki sdd sync-docs" or "pumuki sdd learn".\n\n${HELP_TEXT}`);
+        if (sddCommand === 'auto-sync') {
+          sddAutoSyncStage = parseSddStage(arg.slice('--stage='.length));
+          continue;
+        }
+        throw new Error(`--stage is only supported with "pumuki sdd validate", "pumuki sdd sync-docs", "pumuki sdd learn" or "pumuki sdd auto-sync".\n\n${HELP_TEXT}`);
       }
       if (arg === '--open') {
         if (sddCommand !== 'session') {
@@ -694,7 +713,15 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
           sddLearnChange = changeValue;
           continue;
         }
-        throw new Error(`--change is only supported with "pumuki sdd session", "pumuki sdd sync-docs" or "pumuki sdd learn".\n\n${HELP_TEXT}`);
+        if (sddCommand === 'auto-sync') {
+          const changeValue = arg.slice('--change='.length).trim();
+          if (changeValue.length === 0) {
+            throw new Error(`Invalid --change value "${arg}".`);
+          }
+          sddAutoSyncChange = changeValue;
+          continue;
+        }
+        throw new Error(`--change is only supported with "pumuki sdd session", "pumuki sdd sync-docs", "pumuki sdd learn" or "pumuki sdd auto-sync".\n\n${HELP_TEXT}`);
       }
       if (arg.startsWith('--task=')) {
         if (sddCommand === 'sync-docs') {
@@ -713,7 +740,15 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
           sddLearnTask = taskValue;
           continue;
         }
-        throw new Error(`--task is only supported with "pumuki sdd sync-docs" or "pumuki sdd learn".\n\n${HELP_TEXT}`);
+        if (sddCommand === 'auto-sync') {
+          const taskValue = arg.slice('--task='.length).trim();
+          if (taskValue.length === 0) {
+            throw new Error(`Invalid --task value "${arg}".`);
+          }
+          sddAutoSyncTask = taskValue;
+          continue;
+        }
+        throw new Error(`--task is only supported with "pumuki sdd sync-docs", "pumuki sdd learn" or "pumuki sdd auto-sync".\n\n${HELP_TEXT}`);
       }
       if (arg.startsWith('--ttl-minutes=')) {
         if (sddCommand !== 'session') {
@@ -783,6 +818,26 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
         ...(sddLearnTask ? { sddLearnTask } : {}),
       };
     }
+    if (sddCommand === 'auto-sync') {
+      if (sddSessionAction || sddChangeId || typeof sddTtlMinutes === 'number') {
+        throw new Error(
+          `"pumuki sdd auto-sync" only supports --change=<change-id> [--stage=PRE_WRITE|PRE_COMMIT|PRE_PUSH|CI] [--task=<task-id>] [--dry-run] [--json].\n\n${HELP_TEXT}`
+        );
+      }
+      if (!sddAutoSyncChange || sddAutoSyncChange.length === 0) {
+        throw new Error(`Missing --change=<change-id> for "pumuki sdd auto-sync".\n\n${HELP_TEXT}`);
+      }
+      return {
+        command: commandRaw,
+        purgeArtifacts: false,
+        json,
+        sddCommand,
+        sddAutoSyncDryRun,
+        sddAutoSyncChange,
+        ...(sddAutoSyncStage ? { sddAutoSyncStage } : {}),
+        ...(sddAutoSyncTask ? { sddAutoSyncTask } : {}),
+      };
+    }
 
     if (!sddSessionAction) {
       throw new Error(
@@ -1824,6 +1879,31 @@ export const runLifecycleCli = async (
           }
           return 0;
         }
+        if (parsed.sddCommand === 'auto-sync') {
+          const autoSyncResult = runSddAutoSync({
+            repoRoot: process.cwd(),
+            dryRun: parsed.sddAutoSyncDryRun === true,
+            change: parsed.sddAutoSyncChange,
+            stage: parsed.sddAutoSyncStage,
+            task: parsed.sddAutoSyncTask,
+          });
+          if (parsed.json) {
+            writeInfo(JSON.stringify(autoSyncResult, null, 2));
+          } else {
+            writeInfo(
+              `[pumuki][sdd] auto-sync dry_run=${autoSyncResult.dryRun ? 'yes' : 'no'} change=${autoSyncResult.context.change} stage=${autoSyncResult.context.stage ?? 'none'} task=${autoSyncResult.context.task ?? 'none'} updated=${autoSyncResult.syncDocs.updated ? 'yes' : 'no'} files=${autoSyncResult.syncDocs.files.length} learning_written=${autoSyncResult.learning.written ? 'yes' : 'no'}`
+            );
+            writeInfo(
+              `[pumuki][sdd] learning_path=${autoSyncResult.learning.path} digest=${autoSyncResult.learning.digest}`
+            );
+            for (const file of autoSyncResult.syncDocs.files) {
+              writeInfo(
+                `[pumuki][sdd] file=${file.path} updated=${file.updated ? 'yes' : 'no'} before=${file.beforeDigest} after=${file.afterDigest}`
+              );
+            }
+          }
+          return 0;
+        }
         return 0;
       }
       case 'adapter': {

package/integrations/sdd/index.ts

@@ -9,4 +9,4 @@ export type {
 } from './types';
 export { evaluateSddPolicy, readSddStatus } from './policy';
 export { closeSddSession, openSddSession, readSddSession, refreshSddSession } from './sessionStore';
-export { runSddLearn, runSddSyncDocs } from './syncDocs';
+export { runSddAutoSync, runSddLearn, runSddSyncDocs } from './syncDocs';

package/integrations/sdd/syncDocs.ts

@@ -85,6 +85,22 @@ export type SddLearnResult = {
   learning: NonNullable<SddSyncDocsResult['learning']>;
 };
 
+export type SddAutoSyncResult = {
+  command: 'pumuki sdd auto-sync';
+  dryRun: boolean;
+  repoRoot: string;
+  context: {
+    change: string;
+    stage: SddStage | null;
+    task: string | null;
+  };
+  syncDocs: {
+    updated: boolean;
+    files: ReadonlyArray<SddSyncDocsFileResult>;
+  };
+  learning: NonNullable<SddSyncDocsResult['learning']>;
+};
+
 const normalizeSectionBody = (value: string): string => value.trim().replace(/\r\n/g, '\n');
 
 const computeDigest = (value: string): string =>
@@ -433,3 +449,50 @@ export const runSddLearn = (params?: {
     learning: result.learning,
   };
 };
+
+export const runSddAutoSync = (params?: {
+  repoRoot?: string;
+  dryRun?: boolean;
+  change?: string;
+  stage?: SddStage;
+  task?: string;
+  now?: () => Date;
+  evidenceReader?: (repoRoot: string) => EvidenceReadResult;
+  targets?: ReadonlyArray<SddSyncDocsTarget>;
+}): SddAutoSyncResult => {
+  const change = params?.change?.trim();
+  if (!change) {
+    throw new Error('[pumuki][sdd] auto-sync requires --change=<change-id>.');
+  }
+
+  const syncResult = runSddSyncDocs({
+    repoRoot: params?.repoRoot,
+    dryRun: params?.dryRun,
+    change,
+    stage: params?.stage,
+    task: params?.task,
+    now: params?.now,
+    evidenceReader: params?.evidenceReader,
+    targets: params?.targets,
+  });
+
+  if (!syncResult.learning) {
+    throw new Error('[pumuki][sdd] auto-sync could not generate learning artifact.');
+  }
+
+  return {
+    command: 'pumuki sdd auto-sync',
+    dryRun: syncResult.dryRun,
+    repoRoot: syncResult.repoRoot,
+    context: {
+      change,
+      stage: syncResult.context.stage,
+      task: syncResult.context.task,
+    },
+    syncDocs: {
+      updated: syncResult.updated,
+      files: syncResult.files,
+    },
+    learning: syncResult.learning,
+  };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.35",
+  "version": "6.3.36",
   "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": {