Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

[workshop-sync] workshop/20-persistent-memory.md: `ttl` is not a valid cache-memory field, and the "loaded N items" log message is fabricated

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#4,243 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github-actions, markdown
Área
documentation

Línea de trabajo

Lee workshop/20-persistent-memory.md y workshop/side-quest-20-01-memory-patterns.md y luego compara sus indicaciones sobre la memoria caché con la documentación referenciada sobre la memoria caché. Actualiza las descripciones no válidas de ttl y elimina las comprobaciones inventadas de mensajes de registro en favor de las indicaciones reales sobre el paso de restauración. La tarea estará terminada cuando ambos archivos del workshop describan correctamente la retención y la verificación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

documentation

Workshop file reviewed

workshop/20-persistent-memory.md

Problem 1: ttl field does not exist

The step tells learners to configure cache-memory like this:

tools:
  cache-memory:
    key: daily-status-seen-issues
    ttl: 7d

And documents the field:

ttl: 7d | How long to keep cached data without a refresh. After 7 days of no runs the cache expires and the agent starts fresh.

This is incorrect. The live gh-aw reference docs (docs/src/content/docs/reference/cache-memory.md in github/gh-aw) show the real advanced-configuration schema is:

tools:
  cache-memory:
    key: custom-memory-${{ github.repository_owner }}
    retention-days: 30  # 1-90 days; controls uploaded artifact retention only
    allowed-extensions: [".json", ".txt", ".md"]

There is no ttl field anywhere in the docs (confirmed via grep -i ttl against the fetched reference, zero matches). The closest real field is retention-days, and the docs explicitly warn it "controls only uploaded artifact retention; it does not extend cache lifetime." GitHub Actions cache natively evicts unused entries after 7 days — that eviction isn't configurable per-workflow via a ttl-style key at all.

Problem 2: fabricated log message format

The step tells learners to verify behavior by looking for specific log lines:

confirm it contains cache-memory: loaded 0 items
find cache-memory: loaded N items

No such log string exists. Inspecting this repo's own compiled workflows (e.g. .github/workflows/curriculum-evaluator.lock.yml), the actual generated steps are named things like "Restore cache-memory file share data", "Setup cache-memory git repository", and "Commit cache-memory changes" — there is no "loaded N items" message anywhere in the gh-aw reference docs or compiled lock files.

Current correct syntax

Per https://github.github.com/gh-aw/reference/cache-memory/:

tools:
  cache-memory:
    key: daily-status-seen-issues
    retention-days: 30

(retention-days affects uploaded artifact retention only, 1–90 days; it is not a TTL/expiry control.)

Suggested fix

  1. Replace ttl: 7d with retention-days: <n> (and rewrite the "What each field does" table row to correctly describe it as controlling artifact retention, not cache expiry).
  2. Remove or replace the "cache-memory: loaded 0 items" / "loaded N items" verification instructions with guidance to inspect the actual "Restore cache-memory file share data" step output in the Actions run log, since no such literal string is produced by gh-aw.

This also affects the identical cache-memory field table duplicated in workshop/side-quest-20-01-memory-patterns.md, which should be checked/fixed in the same pass since it shares the same incorrect ttl field and table.

gh-aw release referenced: v0.89.21 (unchanged). Reference: https://github.github.com/gh-aw/reference/cache-memory/.

Generated by 🔍 Workshop Sync Check · copilot · auto · 151.5 AIC · ⌖ 5.52 AIC · ⊞ 9.2K · ◷

  • expires on Oct 7, 2026, 4:50 AM UTC
Lenguaje dominante
JavaScript
Estrellas
52
Forks
26
Merge medio
11 h 32 min
PR fusionados (30 d)
22

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

  • Sin Dockerfile ni archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de githubnext/gh-aw-workshop

Todos los issues de githubnext/gh-aw-workshop

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.