sweaConnector

Herramienta para conectar tu repositorio de estudio de algoritmos a Claude y compilarlo como un visor de Android de solo lectura.

Claude lee y escribe directamente en tu repositorio de estudio: elige el próximo problema a resolver, ajusta el calendario y registra notas de solución. El resultado se puede consultar en cualquier momento como una app en formato de libro electrónico adaptada a los plegables.

   ┌──────────────┐   MCP    ┌──────────────┐  빌드 시 주입  ┌──────────────┐
   │  당신의 학습   │ ───────► │    Claude    │              │  안드로이드    │
   │  저장소        │ ◄─────── │              │              │  뷰어 (APK)   │
   │  (private)    │  기록     └──────────────┘              └──────────────┘
   └──────────────┘                                                ▲
          └─────────────────────────────────────────────────────────┘

Lo que no está en este repositorio

Ni el enunciado de los problemas, ni sus números, ni el código de las soluciones están aquí. Todo está únicamente en tu repositorio privado.

Muchas plataformas de estudio de algoritmos prohíben en sus términos de servicio la publicación y el intercambio de problemas y soluciones. Por eso sweaConnector es deliberadamente un recipiente vacío — solo contiene herramientas, convenciones y explicaciones de conceptos generales de CS; el contenido se inyecta desde tu repositorio en el momento de la compilación. Los problemas de ejemplo en fixtures/ son todos ficticios.

Estructura

Comenzar

git clone https://github.com/rleaderjoon/sweaConnector
cd sweaConnector
npm install
npm test                              # 13개 자체 검증 (MCP 핸드셰이크 포함)

# 1. 내 저장소가 규약에 맞는지 확인
node pipeline/extract.mjs --repo /path/to/my-study-repo --out content.json

# 2. 일정 설정 — 내 학습 저장소 루트에 .sweaconnector.json
echo '{"startDate":"2026-08-15","examDate":"2026-09-19"}' > /path/to/my-study-repo/.sweaconnector.json

# 3. Claude 에 붙이기
claude mcp add swea -- node ./mcp/index.mjs --repo /path/to/my-study-repo

# 4. 내 APK 굽기 — 콘텐츠 추출부터 서명까지 한 번에
bash pipeline/build-apk.sh /path/to/my-study-repo release

El APK se genera en app/reader/build/outputs/apk/release/. Si prefieres delegarlo a GitHub Actions, ejecuta manualmente .github/workflows/apk.yml (al ser un repositorio público, se compila con contenido de demostración).

Instalarlo en el teléfono

1. Sube el APK a un Release de tu repositorio privado — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. Abre ese Release en el navegador del teléfono y descarga el APK (debes haber iniciado sesión en GitHub)

3. Permite una vez la instalación de "aplicaciones de origen desconocido" para el navegador

No subas tu APK a un repositorio público — dentro del APK están los problemas y las soluciones.

Pantallas

Al plegar y desplegar se mantiene la posición de lectura (la actividad no se recrea gracias a configChanges).

Herramientas MCP

schedule_status no es una herramienta que te lee el plan, sino una que lo corrige asumiendo que el plan ya se ha desviado. Mira primero slackDays — son los días de margen restantes hasta la fecha del examen; si es negativo, hay que subir el ritmo.

Requisitos

• Node 20+

• JDK 17+ · Android SDK (platform 35) — solo para compilaciones locales. Si compilas con Actions, no es necesario.

Principios de diseño

• Visor de solo lectura. No se edita en la app. La escritura va al repositorio a través de Claude (MCP).

• Sin red en tiempo de ejecución. El contenido se incrusta en el APK en el momento de la compilación. Si no hay nada que parsear al pulsar, se abre al instante.

• Prioridad plegable. Plegado, una página; desplegado, doble página. Tanto en vertical como en horizontal.

• Los diagramas son vectoriales. Los diagramas de algoritmos son SVG dibujados a mano → VectorDrawable. Las imágenes generadas por IA se equivocan de forma convincente.

Licencia

MIT (solo para herramientas y explicaciones de conceptos). El cumplimiento de los derechos y los términos del contenido que tú inyectas es tu responsabilidad.