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

Split the oversized files — pure file moves, no behavior change

Abierto
  • ¿Algo no está bien?
#1,584 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
4/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
18/100
Tipo de issue
Refactorización
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
go
Área
backend, cli

Línea de trabajo

Start with one bounded target, such as core/plugins/inferenceparser/plugin.go and its existing anthropic.go and responses.go siblings, and move the OpenAI dialect into openai.go without changing signatures. Run the existing package tests before and after each move to confirm no behavior change. Scope covers nine large files, so the issue is better split into one PR per file; done means the original file shrinks and the same tests pass unchanged.

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

Descripción

What

Several files have outgrown their packages' own discipline. In each case the seams are already clean function boundaries, so these are pure same-package file moves — no signature changes, tests untouched:

  • core/listener/forwardproxy/server.go (2954 lines) — five jobs: relay core, CONNECT tunneling, bridged-tunnel TLS (+CA/handshake helpers), session identity/attribution (~430 lines, the densest cluster), SSE relay. Split into tunnel.go, bridging.go, identity.go, record.go, stream.go; server.go lands ~600. The package already proved this style with process.go/sniff.go/transparent.go.
  • cmd/agentop/tui/app.go (3089) — model state, a ~900-line update() type switch (~55 case types), view dispatch, yank file I/O, subprocess plumbing. Move yank I/O and exec wrappers out; split update() by message family to match the per-pane files.
  • core/observe/claude/harvest.go (2040) — orchestration, filesystem scan, transcript parsing, and ~800 lines of pure text scrubbing (scrubRunes, stripANSI, stripHarnessSpans, …). Extract scrub.go + prompt.go.
  • core/session/store.go (1472) — append/trim engine, pub/sub, views, summary/money (~365 lines), lifecycle. Extract summary.go + subscribe.go.
  • core/cost/usage/usage.go (1846) + snapshot.go (1584) — extract window.go (pure time math, ~500 lines), labels.go, series.go.
  • core/plugins/cpex/cmf_body.go (1128) — three separable jobs: JSON-presentability heuristics, extension→CMF part mapping, MCP body mutation. Extract three files.
  • core/plugins/inferenceparser/plugin.go (1075) — the entire OpenAI dialect lives inline (~450 lines: parse, frame fold, SSE, wire types) though anthropic.go and responses.go exist as the per-dialect pattern. Extract openai.go.
  • cmd/agentop/cmd_bob.go (2159) — contains a hidden ~400-line byte-level JSON editor (bobSetKey/bobFindMember/bobSpliceOut/…, :620-1028) with nothing to do with Bob semantics. Extract bob_settings_json.go with its own test surface.
  • cmd/cortex/main.go — main() is ~900 lines of assembly (:322-1220): session store + ledger + archive wiring, TLS-bridge assembly (~130 lines), shutdown choreography. The package already has local.go, archive.go, listeners.go, supervise.go — drain the three blocks into them.

Lower priority, same pattern: cmd/agentop/tui/keys.go (1549 — layout() and handleEditKey have nothing to do with keys) and tui/sessions_pane.go (1769 — the ~500-line title/grapheme block is self-contained and owns a 3,322-line test file).

Found in the 2026-10-29 structural audit of code organization.

Lenguaje dominante
Go
Estrellas
21
Forks
43
Merge medio
13 h 8 min
PR fusionados (30 d)
267

Preparar el entorno

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 rossoctl/cortex

Todos los issues de rossoctl/cortex

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.