pumuki 6.3.7

package/scripts/sync-codex-skills.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+set -u
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DEST_DIR="$ROOT_DIR/docs/codex-skills"
+
+mkdir -p "$DEST_DIR"
+
+synced_count=0
+
+sync_one() {
+  local source_path="$1"
+  local dest_path="$2"
+
+  if [[ -f "$source_path" ]]; then
+    cp "$source_path" "$dest_path"
+    echo "synced: $source_path -> $dest_path"
+    synced_count=$((synced_count + 1))
+    return
+  fi
+
+  echo "warning: missing source: $source_path" >&2
+  printf 'TODO: sincronizar desde %s\n' "$source_path" > "$dest_path"
+}
+
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/public/windsurf-rules-android/SKILL.md" "$DEST_DIR/windsurf-rules-android.md"
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/public/windsurf-rules-backend/SKILL.md" "$DEST_DIR/windsurf-rules-backend.md"
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/public/windsurf-rules-frontend/SKILL.md" "$DEST_DIR/windsurf-rules-frontend.md"
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/public/windsurf-rules-ios/SKILL.md" "$DEST_DIR/windsurf-rules-ios.md"
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/swift-concurrency/SKILL.md" "$DEST_DIR/swift-concurrency.md"
+sync_one "/Users/juancarlosmerlosalbarracin/.codex/skills/swiftui-expert-skill/SKILL.md" "$DEST_DIR/swiftui-expert-skill.md"
+
+if [[ "$synced_count" -ge 1 ]]; then
+  echo "done: synchronized $synced_count skill file(s) into $DEST_DIR"
+  exit 0
+fi
+
+echo "error: no skill files synchronized" >&2
+exit 1

package/scripts/sync-phase5-latest-docs.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT_DIR="${1:-.audit-reports/phase5-latest}"
+SUPPORT_BUNDLE="${OUT_DIR}/consumer-startup-failure-support-bundle.md"
+BUNDLE_ARCHIVE="${OUT_DIR}/consumer-startup-escalation-bundle-latest.tgz"
+DOC_HANDOFF="docs/validation/consumer-startup-escalation-handoff-latest.md"
+DOC_ROLLOUT="docs/validation/phase8-external-rollout-pack.md"
+DOC_TODO="docs/TODO.md"
+
+require_file() {
+  local file="$1"
+  if [[ ! -f "${file}" ]]; then
+    echo "[phase5-sync-docs] ERROR: missing file: ${file}" >&2
+    exit 1
+  fi
+}
+
+extract_metric() {
+  local key="$1"
+  local value
+  value="$(sed -nE "s/^-[[:space:]]*${key}:[[:space:]]*([0-9]+).*/\1/p" "${SUPPORT_BUNDLE}" | head -n1)"
+  if [[ -z "${value}" ]]; then
+    echo "[phase5-sync-docs] ERROR: missing metric ${key} in ${SUPPORT_BUNDLE}" >&2
+    exit 1
+  fi
+  printf '%s' "${value}"
+}
+
+require_file "${SUPPORT_BUNDLE}"
+require_file "${BUNDLE_ARCHIVE}"
+require_file "${DOC_HANDOFF}"
+require_file "${DOC_ROLLOUT}"
+require_file "${DOC_TODO}"
+
+STARTUP_FAILURE_RUNS="$(extract_metric startup_failure_runs)"
+STARTUP_STALLED_RUNS="$(extract_metric startup_stalled_runs)"
+OLDEST_QUEUED_AGE="$(extract_metric oldest_queued_run_age_minutes)"
+
+LATEST_RUN_URL="$(grep -Eo 'https://github\.com/[^ ]+/actions/runs/[0-9]+' "${SUPPORT_BUNDLE}" | head -n1 || true)"
+RUN_URL_1="$(grep -Eo 'https://github\.com/[^ ]+/actions/runs/[0-9]+' "${SUPPORT_BUNDLE}" | sed -n '1p' || true)"
+RUN_URL_2="$(grep -Eo 'https://github\.com/[^ ]+/actions/runs/[0-9]+' "${SUPPORT_BUNDLE}" | sed -n '2p' || true)"
+RUN_URL_3="$(grep -Eo 'https://github\.com/[^ ]+/actions/runs/[0-9]+' "${SUPPORT_BUNDLE}" | sed -n '3p' || true)"
+LATEST_RUN_ID="$(printf '%s' "${LATEST_RUN_URL}" | sed -E 's#.*/##')"
+
+if [[ -z "${LATEST_RUN_URL}" || -z "${LATEST_RUN_ID}" ]]; then
+  echo "[phase5-sync-docs] ERROR: could not extract latest run URL from ${SUPPORT_BUNDLE}" >&2
+  exit 1
+fi
+
+BUNDLE_SIZE="$(du -h "${BUNDLE_ARCHIVE}" | awk '{print $1}')"
+BUNDLE_SHA256="$(shasum -a 256 "${BUNDLE_ARCHIVE}" | awk '{print $1}')"
+NOW_UTC="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+export NOW_UTC STARTUP_FAILURE_RUNS STARTUP_STALLED_RUNS OLDEST_QUEUED_AGE BUNDLE_SIZE BUNDLE_SHA256 LATEST_RUN_URL LATEST_RUN_ID
+
+perl -0pi -e 's/- generated_at: .*\n/"- generated_at: $ENV{NOW_UTC}\n"/e' "${DOC_HANDOFF}"
+perl -0pi -e "s/- \`startup_failure_runs: [0-9]+\`/- \`startup_failure_runs: ${STARTUP_FAILURE_RUNS}\`/g" "${DOC_HANDOFF}"
+perl -0pi -e "s/- \`startup_stalled_runs: [0-9]+\`/- \`startup_stalled_runs: ${STARTUP_STALLED_RUNS}\`/g" "${DOC_HANDOFF}"
+perl -0pi -e "s/- \`oldest_queued_run_age_minutes: [0-9]+\`/- \`oldest_queued_run_age_minutes: ${OLDEST_QUEUED_AGE}\`/g" "${DOC_HANDOFF}"
+perl -0pi -e "s/- size: \`[^\`]+\`/- size: \`${BUNDLE_SIZE}\`/g" "${DOC_HANDOFF}"
+perl -0pi -e "s/- sha256: \`[0-9a-f]{64}\`/- sha256: \`${BUNDLE_SHA256}\`/g" "${DOC_HANDOFF}"
+perl -0pi -e "s#- \`[0-9a-f]{64}  \\.audit-reports/phase5-latest/consumer-startup-escalation-bundle-latest\\.tgz\`#- \`${BUNDLE_SHA256}  .audit-reports/phase5-latest/consumer-startup-escalation-bundle-latest.tgz\`#g" "${DOC_HANDOFF}"
+perl -0pi -e "s#- \`https://github\\.com/[^\`]+/actions/runs/[0-9]+\`#- \`${LATEST_RUN_URL}\`#" "${DOC_ROLLOUT}"
+perl -0pi -e "s/- \`startup_failure_runs: [0-9]+\`/- \`startup_failure_runs: ${STARTUP_FAILURE_RUNS}\`/" "${DOC_ROLLOUT}"
+perl -0pi -e "s/- \`startup_stalled_runs: [0-9]+\`/- \`startup_stalled_runs: ${STARTUP_STALLED_RUNS}\`/" "${DOC_ROLLOUT}"
+perl -0pi -e "s/- \`oldest_queued_run_age_minutes: [0-9]+\`/- \`oldest_queued_run_age_minutes: ${OLDEST_QUEUED_AGE}\`/" "${DOC_ROLLOUT}"
+perl -0pi -e "s/- \`startup_failure_runs: [0-9]+\`/- \`startup_failure_runs: ${STARTUP_FAILURE_RUNS}\`/" "${DOC_TODO}"
+perl -0pi -e "s/- \`startup_stalled_runs: [0-9]+\`/- \`startup_stalled_runs: ${STARTUP_STALLED_RUNS}\`/" "${DOC_TODO}"
+perl -0pi -e "s/- \`oldest_queued_run_age_minutes: [0-9]+\`/- \`oldest_queued_run_age_minutes: ${OLDEST_QUEUED_AGE}\`/" "${DOC_TODO}"
+perl -0pi -e "s/- latest probe: \`[0-9]+\`/- latest probe: \`${LATEST_RUN_ID}\`/" "${DOC_TODO}"
+perl -0pi -e "s/sha256: [0-9a-f]{64}/sha256: ${BUNDLE_SHA256}/" "${DOC_TODO}"
+
+# Keep Support Ticket Payload and checklist values aligned to latest evidence.
+awk \
+  -v s1="${STARTUP_FAILURE_RUNS}" \
+  -v s2="${STARTUP_STALLED_RUNS}" \
+  -v s3="${OLDEST_QUEUED_AGE}" \
+  -v u1="${RUN_URL_1}" \
+  -v u2="${RUN_URL_2}" \
+  -v u3="${RUN_URL_3}" \
+  '
+  BEGIN {
+    in_payload=0;
+    in_checklist_urls=0;
+    url_count_payload=0;
+    url_count_checklist=0;
+  }
+  /^## Support Ticket Payload \(Ready To Paste\)/ { in_payload=1 }
+  in_payload && /^## Submission Tracking/ { in_payload=0 }
+
+  in_payload && /- startup_failure_runs:/ { print "- startup_failure_runs: " s1; next }
+  in_payload && /- startup_stalled_runs:/ { print "- startup_stalled_runs: " s2; next }
+  in_payload && /- oldest_queued_run_age_minutes:/ { print "- oldest_queued_run_age_minutes: " s3; next }
+  in_payload && /^- https:\/\/github\.com\/.*\/actions\/runs\/[0-9]+$/ {
+    url_count_payload++;
+    if (url_count_payload==1 && u1!="") { print "- " u1; next }
+    if (url_count_payload==2 && u2!="") { print "- " u2; next }
+    if (url_count_payload==3 && u3!="") { print "- " u3; next }
+  }
+
+  /^3\. Add latest run URLs \(minimum 2\) in the case body:/ { in_checklist_urls=1; print; next }
+  in_checklist_urls && /^4\. After pressing submit, update `Submission Tracking` in this file:/ { in_checklist_urls=0; print; next }
+  in_checklist_urls && /^   - `https:\/\/github\.com\/.*\/actions\/runs\/[0-9]+`$/ {
+    url_count_checklist++;
+    if (url_count_checklist==1 && u1!="") { print "   - `" u1 "`"; next }
+    if (url_count_checklist==2 && u2!="") { print "   - `" u2 "`"; next }
+  }
+
+  { print }
+  ' "${DOC_HANDOFF}" > "${DOC_HANDOFF}.tmp"
+mv "${DOC_HANDOFF}.tmp" "${DOC_HANDOFF}"
+
+echo "[phase5-sync-docs] out_dir=${OUT_DIR}"
+echo "[phase5-sync-docs] startup_failure_runs=${STARTUP_FAILURE_RUNS}"
+echo "[phase5-sync-docs] startup_stalled_runs=${STARTUP_STALLED_RUNS}"
+echo "[phase5-sync-docs] oldest_queued_run_age_minutes=${OLDEST_QUEUED_AGE}"
+echo "[phase5-sync-docs] latest_run=${LATEST_RUN_URL}"
+echo "[phase5-sync-docs] bundle_sha256=${BUNDLE_SHA256}"

package/scripts/validation-docs-hygiene-lib.ts

@@ -0,0 +1,46 @@
+export type ValidationDocsHygieneResult = {
+  violations: ReadonlyArray<string>;
+};
+
+const ALLOWED_ROOT_DOCS = new Set<string>([
+  'docs/validation/README.md',
+  'docs/validation/consumer-ci-startup-failure-playbook.md',
+  'docs/validation/consumer-startup-escalation-handoff-latest.md',
+  'docs/validation/github-support-ticket-template-startup-failure.md',
+  'docs/validation/phase5-execution-closure.md',
+  'docs/validation/phase8-external-rollout-pack.md',
+  'docs/validation/phase8-post-billing-reactivation-runbook.md',
+  'docs/validation/skills-rollout-consumer-repositories.md',
+  'docs/validation/adapter-hook-runtime-local-report.md',
+  'docs/validation/adapter-hook-runtime-validation.md',
+  'docs/validation/adapter-real-session-report-template.md',
+  'docs/validation/enterprise-consumer-isolation-policy.md',
+  'docs/validation/mock-consumer-integration-runbook.md',
+]);
+
+const ARCHIVE_PREFIX = 'docs/validation/archive/';
+
+const isAllowedTrackedValidationDoc = (trackedPath: string): boolean => {
+  if (ALLOWED_ROOT_DOCS.has(trackedPath)) {
+    return true;
+  }
+
+  if (trackedPath.startsWith(ARCHIVE_PREFIX)) {
+    return true;
+  }
+
+  return false;
+};
+
+export const checkValidationDocsHygiene = (
+  trackedPaths: ReadonlyArray<string>
+): ValidationDocsHygieneResult => {
+  const violations = trackedPaths
+    .filter((trackedPath) => trackedPath.startsWith('docs/validation/'))
+    .filter((trackedPath) => !isAllowedTrackedValidationDoc(trackedPath))
+    .sort((left, right) => left.localeCompare(right));
+
+  return {
+    violations,
+  };
+};

package/skills.lock.json

@@ -0,0 +1,178 @@
+{
+  "version": "1.0",
+  "compilerVersion": "1.0.0",
+  "generatedAt": "2026-02-15T01:30:26.023Z",
+  "bundles": [
+    {
+      "name": "android-guidelines",
+      "version": "1.0.0",
+      "source": "file:docs/codex-skills/windsurf-rules-android.md",
+      "hash": "2f3551b6025083e315365d139f37d59e748991bcab43aae3e92b103e7eb6fb98",
+      "rules": [
+        {
+          "id": "skills.android.no-globalscope",
+          "description": "Disallow GlobalScope in Android production code.",
+          "severity": "ERROR",
+          "platform": "android",
+          "confidence": "HIGH",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "android-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-android.md"
+        },
+        {
+          "id": "skills.android.no-runblocking",
+          "description": "Disallow runBlocking in Android production code.",
+          "severity": "WARN",
+          "platform": "android",
+          "confidence": "MEDIUM",
+          "stage": "PRE_COMMIT",
+          "locked": true,
+          "sourceSkill": "android-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-android.md"
+        },
+        {
+          "id": "skills.android.no-thread-sleep",
+          "description": "Disallow Thread.sleep in Android production code.",
+          "severity": "ERROR",
+          "platform": "android",
+          "confidence": "HIGH",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "android-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-android.md"
+        }
+      ]
+    },
+    {
+      "name": "backend-guidelines",
+      "version": "1.0.0",
+      "source": "file:docs/codex-skills/windsurf-rules-backend.md",
+      "hash": "bcd62ff3299d89d6796b079b74c317b80e6bdcfb231c7b308e191a32a4e667dd",
+      "rules": [
+        {
+          "id": "skills.backend.avoid-explicit-any",
+          "description": "Avoid explicit any in backend runtime code.",
+          "severity": "WARN",
+          "platform": "backend",
+          "confidence": "MEDIUM",
+          "stage": "PRE_COMMIT",
+          "locked": true,
+          "sourceSkill": "backend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-backend.md"
+        },
+        {
+          "id": "skills.backend.no-console-log",
+          "description": "Disallow console.log in backend runtime code.",
+          "severity": "ERROR",
+          "platform": "backend",
+          "confidence": "HIGH",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "backend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-backend.md"
+        },
+        {
+          "id": "skills.backend.no-empty-catch",
+          "description": "Disallow empty catch blocks in backend runtime code.",
+          "severity": "CRITICAL",
+          "platform": "backend",
+          "confidence": "HIGH",
+          "locked": true,
+          "sourceSkill": "backend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-backend.md"
+        }
+      ]
+    },
+    {
+      "name": "frontend-guidelines",
+      "version": "1.0.0",
+      "source": "file:docs/codex-skills/windsurf-rules-frontend.md",
+      "hash": "0387b8713c9e4e147d84ed90f8b5ebcae0733adbaeba50dc12f00cf0047687b9",
+      "rules": [
+        {
+          "id": "skills.frontend.avoid-explicit-any",
+          "description": "Avoid explicit any in frontend runtime code.",
+          "severity": "WARN",
+          "platform": "frontend",
+          "confidence": "MEDIUM",
+          "stage": "PRE_COMMIT",
+          "locked": true,
+          "sourceSkill": "frontend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-frontend.md"
+        },
+        {
+          "id": "skills.frontend.no-console-log",
+          "description": "Disallow console.log in frontend production code.",
+          "severity": "ERROR",
+          "platform": "frontend",
+          "confidence": "HIGH",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "frontend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-frontend.md"
+        },
+        {
+          "id": "skills.frontend.no-empty-catch",
+          "description": "Disallow empty catch blocks in frontend runtime code.",
+          "severity": "ERROR",
+          "platform": "frontend",
+          "confidence": "HIGH",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "frontend-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-frontend.md"
+        }
+      ]
+    },
+    {
+      "name": "ios-guidelines",
+      "version": "1.0.0",
+      "source": "file:docs/codex-skills/windsurf-rules-ios.md",
+      "hash": "023de46b9b30224cbf7d76472c6f7cfd809d1baff09a64b5a93b716171d2566a",
+      "rules": [
+        {
+          "id": "skills.ios.no-anyview",
+          "description": "Disallow AnyView in production iOS code.",
+          "severity": "ERROR",
+          "platform": "ios",
+          "confidence": "HIGH",
+          "locked": true,
+          "sourceSkill": "ios-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-ios.md"
+        },
+        {
+          "id": "skills.ios.no-callback-style-outside-bridges",
+          "description": "Disallow callback-style signatures outside approved iOS bridge layers.",
+          "severity": "WARN",
+          "platform": "ios",
+          "confidence": "MEDIUM",
+          "stage": "PRE_PUSH",
+          "locked": true,
+          "sourceSkill": "ios-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-ios.md"
+        },
+        {
+          "id": "skills.ios.no-force-try",
+          "description": "Disallow force try in production iOS code.",
+          "severity": "ERROR",
+          "platform": "ios",
+          "confidence": "HIGH",
+          "locked": true,
+          "sourceSkill": "ios-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-ios.md"
+        },
+        {
+          "id": "skills.ios.no-force-unwrap",
+          "description": "Disallow force unwrap in production iOS code.",
+          "severity": "ERROR",
+          "platform": "ios",
+          "confidence": "HIGH",
+          "locked": true,
+          "sourceSkill": "ios-guidelines",
+          "sourcePath": "docs/codex-skills/windsurf-rules-ios.md"
+        }
+      ]
+    }
+  ]
+}

package/skills.sources.json

@@ -0,0 +1,33 @@
+{
+  "version": "1.0",
+  "bundles": [
+    {
+      "name": "ios-guidelines",
+      "version": "1.0.0",
+      "template": "ios-guidelines",
+      "sourcePath": "docs/codex-skills/windsurf-rules-ios.md",
+      "enabled": true
+    },
+    {
+      "name": "backend-guidelines",
+      "version": "1.0.0",
+      "template": "backend-guidelines",
+      "sourcePath": "docs/codex-skills/windsurf-rules-backend.md",
+      "enabled": true
+    },
+    {
+      "name": "frontend-guidelines",
+      "version": "1.0.0",
+      "template": "frontend-guidelines",
+      "sourcePath": "docs/codex-skills/windsurf-rules-frontend.md",
+      "enabled": true
+    },
+    {
+      "name": "android-guidelines",
+      "version": "1.0.0",
+      "template": "android-guidelines",
+      "sourcePath": "docs/codex-skills/windsurf-rules-android.md",
+      "enabled": true
+    }
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,39 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "commonjs",
+        "lib": [
+            "ES2020"
+        ],
+        "outDir": "./dist",
+        "rootDir": ".",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "moduleResolution": "node",
+        "allowSyntheticDefaultImports": true,
+        "noImplicitAny": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "noImplicitReturns": true,
+        "noFallthroughCasesInSwitch": true,
+        "noUnusedLocals": false,
+        "noUnusedParameters": false
+    },
+    "include": [
+        "core/**/*.ts",
+        "integrations/**/*.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/__tests__/**",
+        "**/*.spec.ts",
+        "**/*.test.ts"
+    ]
+}