Project Update

Última actualización: 2026-04-29

/project-update — Procedimiento formal

Procedimiento determinista, paralelo, reutilizable. Implementación: scripts/project-update.py.

Principios inmutables

1. F1 es 100% determinista — subprocesos Python paralelos, NO agentes LLM.
2. Agentes solo para digerir y consolidar (F2 meeting-digest, F3 análisis cruzado).
3. Confidencialidad por capa:
   • Nombres reales: ~/.azure/, ~/.savia/, projects/{slug}_main/ (gitignored).
   • Codenames: cualquier sitio (incluye repo público).
   • Outputs intermedios: ~/.savia/project-update-tmp/{slug}/ (N4, nunca a git).
4. Reutilización: cada source es un script existente; orquestador = despacho + agregación.
5. Read-only en sistemas externos (DevOps, Outlook, Teams, SharePoint, OneDrive).
6. Time-boxing: cada job tiene timeout. F1 entera < 15 min.

Configuración (fuera del repo)

~/.azure/
  ├── <real-name>-pat                      # PAT Azure DevOps
  └── projects/<real-project-name>.json    # {_codename, org, project, iteration, pat_file}

~/.savia/
  ├── mail-accounts.json                   # por cuenta: tenant, email, drive_id, ...
  ├── project-update-tmp/{slug}/           # outputs intermedios (efímero)
  ├── captured-vtt/{account}/              # VTTs descargados/extraídos
  └── pm-radar/state.json                  # historial runs

Si ~/.azure/projects/ tiene 1 fichero, auto-elige. Si varios, busca por _codename == slug.

Path resolution sin leaks: scripts F2/F3/F4 leen documents root vía scripts/savia_paths.py. Order: $SAVIA_DOCS_ROOT → ~/.savia/savia-paths.json → ConfigError. Ningún script bajo scripts/ debe contener nombres de organización ni rutas personales. Test: tests/scripts/test_project-update-confidentiality.py.

Invocación

python scripts/project-update.py --slug "{codename}"                  # completo
python scripts/project-update.py --slug "{codename}" --only refresh   # F1
python scripts/project-update.py --slug "{codename}" --only digest    # F2 (VTTs ya capturados)
python scripts/project-update.py --slug "{codename}" --skip teams-transcripts
python scripts/project-update.py --slug "{codename}" --dry-run        # plan-only
python scripts/project-update.py --slug "{codename}" --skip-auth      # daemons ya auth

Pipeline

F0 — Auth gate (graceful, per-source)

scripts/ensure-daemons-auth.sh re-auth si caducó. probe_auth_per_account() parsea check-daemon-auth.sh JSON. Cuentas con status != running → account_skip solo en jobs CDP-dependent (sp-recordings, onedrive, teams-transcripts); saved-session (mail, calendar, teams-chats) se intentan igual. NO aborta. Bypass: --skip-auth o --dry-run.

F1 — Refresh paralelo (ThreadPoolExecutor, 8 workers)

Outputs a ~/.savia/project-update-tmp/{slug}/ o ~/.savia/captured-vtt/{account}/. Orquestador captura rc + elapsed_s + stderr_tail + stdout_preview por job.

F2 — Digestión

Salida: projects/{slug}_main/{slug}-{username}/meetings/YYYYMMDD-{titulo}.md.

El digest determinista NO sustituye al agente meeting-digest. Workflow:

1. F2 genera esqueleto + recordatorio "Source file: X".
2. PM revisa y para reuniones críticas invoca: Task(meeting-digest, source=<file>).
3. Digest enriquecido sobreescribe el esqueleto.

F3 — Análisis determinista

scripts/project-update-analyze.py — pure Python, sin LLM. Lee F1 + F2. Produce radar consolidado:

• ## Sources status — auth + counts por fuente
• ## DevOps snapshot — raw md
• ## Calendario 72h — eventos por día
• ## Reuniones digeridas — counts action items / decisiones
• ## Action items abiertos (consolidado) — checkbox items vía regex agrupados

Idempotente. Salida: projects/{slug}_main/{slug}-{username}/reports/radar/YYYYMMDD-HHMM-radar.md.

F4 — Sync determinista (PENDING.md auto-update)

scripts/project-update-sync.py — lee radar más reciente, append action items a PENDING.md bajo ## Acciones esta semana. Dedup case-folded — idempotente. Actualiza **Última actualización**.

Confidencialidad por carpeta

Anti-patrones

• Lanzar agentes LLM por source en F1.
• Hardcodear nombres reales en scripts/ o .claude/.
• Usar sharepoint_transcripts.py (deprecated). Usar sp-recordings.py.
• Pushear a origin contenido de projects/.
• Confiar en que el Shield desenmascara args de tool-call.

Roadmap pendiente

1. F4 sync con Gitea machine-local.
2. Wrappers idénticos a project-update-devops.sh si firma de algún script cambia.
3. Fix proxy Shield: unmask de tool-args.