chore(openspec): state the index symlink refusal in the index-resolution spec

Abierto Apto para principiantes
#377 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
74/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
go

Línea de trabajo

Lee openspec/specs/index-resolution/spec.md y compara su recorrido de primera coincidencia con el comportamiento de rechazo descrito en el issue e incluido en #374. Usa /opsx:propose para añadir requisitos y escenarios para destinos externos, enlaces rotos, la alternativa del linked worktree y el ancla estricta; añade la línea Issue: a proposal.md. La tarea estará completa cuando la especificación cubra todos los comandos que leen o crean el índice y el error de inicio de codegraph serve, en consonancia con #374.

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

Descripción

area:query chore needs-triage spec-needed
What kind of chore?

Documentation

What needs doing?

Add requirements and scenarios to openspec/specs/index-resolution/spec.md for the index symlink refusal that #374 ships. This is an OpenSpec proposal with no code change. Run /opsx:propose and add the Issue: line to proposal.md with this issue's number.

The spec still says to use the first .codegraph found on the upward walk. It has no requirement or scenario for these cases:

  • the refusal of a .codegraph or .codegraph/store that resolves outside the directory holding .codegraph
  • the dangling-link case
  • the linked-worktree fallback case
  • the strict anchor: a subdirectory .codegraph that links to the repository root's index is refused

The new requirement must match the behavior in #374. Every command that reads or builds the index refuses such a path. The error names the link, its target and the next step. codegraph serve stops at startup with that error.

Why now?

PR #374 refuses some index links, but the spec still describes the old first-match walk. Without a scenario, no test can trace the refusal to the spec. The impact lane of the suite review of #374 found this gap as IMPACT-1.

Related: #372, #374, #297.

Does this touch anything load-bearing?
  • The release pipeline (release.yml, .goreleaser.yaml, signing)
  • The upgrade identity (internal/upgrade/verify.go)
  • The perf baseline (tools/bench/baseline.json)
  • The graph schema / meta-key layout
  • None of these
Before submitting
  • I searched existing issues and this is not a duplicate
Lenguaje dominante
Go
Estrellas
0
Forks
0
Merge medio
7 h 42 min
PR fusionados (30 d)
111

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 seanb4t/codegraph-go

Todos los issues de seanb4t/codegraph-go

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.