Skip to content

[P2][docs] Definir TechnicalSource como localizador de evidencia #45

Description

@ruzer

Especificación padre: #30

Ticket del desglose Project Brain Lite 0.3.1: 15/20.

Entrega

Definir la frontera entre una fuente técnica, un hecho observado y una detección heurística.

Bloqueado por

Acceptance criteria

  • TechnicalSource identifica una ubicación verificable del repositorio.
  • Una fuente no convierte por sí sola una inferencia en hecho.
  • TechnicalSource no representa una fuente de gestión.
  • Una referencia externa no transfiere autoridad ni provoca acceso de red.

Tests requeridos

  • Ejemplos válidos e inválidos.
  • Assertions sobre la distinción entre source, fact y detection.
  • Ausencia de semántica de gestión.
  • Scope guard que confirme que la documentación no introduce fetching.

Guardas de compatibilidad

  • Node.js 20+ y cero dependencias npm.
  • Comportamiento determinista, file-first y local-first.
  • API pública, rutas, tres comandos y cinco archivos canónicos preservados.
  • doctor permanece read-only e init permanece no destructivo.
  • No se ejecutan comandos detectados ni se utiliza la red.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ready-for-agentSpecification is complete and ready for an implementation agent

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions