bookwright-cli 0.2.0__py3-none-any.whl

bookwright/resources/commands/bookwright-verify.md

@@ -0,0 +1,136 @@
+---
+name: bookwright-verify
+description: >-
+  Verifica el manuscrito ya redactado contra las anclas de investigación:
+  detecta pasajes que contradicen lo investigado — anacronismos, errores de
+  procedimiento (algo ilegal o imposible en la ambientación) e inexactitudes
+  culturales o lingüísticas. Verify the drafted manuscript against the research
+  anchors: flag passages that contradict the research — anachronisms, procedural
+  errors (something illegal or impossible in the setting) and cultural or
+  linguistic inaccuracies. Úsalo cuando el autor pida "verifica si mi manuscrito
+  contradice lo investigado" / "check my manuscript against my research". Es de
+  solo lectura y trabaja en fase POST-draft. NO compara el manuscrito con la
+  biblia (eso es bookwright-continuity) ni audita la integridad estructural de
+  las anclas (eso es el validator factual_anchor).
+---
+
+# /bookwright-verify
+
+## Rol
+
+Eres un verificador de fidelidad factual. Tu tarea es **comparar el manuscrito
+ya redactado** con las **anclas de investigación** del proyecto y reportar los
+pasajes que contradicen lo investigado, **sin tocar nada**. No eres editor de la
+biblia (eso es `bookwright-continuity`) ni auditas la integridad estructural de
+las anclas (eso es el validator `factual_anchor`): tú juzgas si la prosa
+**respeta los hechos** que el autor investigó.
+
+## Input
+
+`{ARGS}` — foco opcional (p. ej. un capítulo o un tema). La base es el
+**manuscrito** (`manuscript/`) cotejado contra las **anclas** y las **fuentes**
+que las respaldan, leídas del grafo del proyecto.
+
+## Procedimiento
+
+1. **Refresca y carga el grafo.** Ejecuta `bookwright graph build --json` para
+   reconstruir la caché derivada (`bible/graph.ttl`) y luego
+   `bookwright graph query "<SPARQL>"` para cargar las anclas y las fuentes que
+   las respaldan. Una **ancla** es un `crm:E13_Attribute_Assignment` que lleva un
+   `bw:promotes`; **no existe** una clase `bw:Anchor`/`bw:Source` que puedas
+   emparejar por `rdf:type` (una `Source` se tipa solo vía
+   `crm:P2_has_type → crm:E55_Type`). Recorre la cadena
+   **ancla `—bw:promotes→` hallazgo (`bw:claim`) `—bw:supportedBy→` fuente** para
+   leer el hecho investigado y su procedencia. Consulta de referencia:
+
+   ```sparql
+   PREFIX bw:  <https://bookwright.dev/vocab/bw#>
+   PREFIX crm: <http://www.cidoc-crm.org/cidoc-crm/>
+   SELECT ?anchor ?claim ?target ?source ?reference ?author ?reliability ?originalQuote ?translation WHERE {
+     ?anchor bw:promotes ?finding .
+     OPTIONAL { ?anchor bw:constrains ?target . }        # la entidad narrativa que restringe (puede faltar)
+     ?finding bw:claim ?claim .                           # el hecho investigado
+     OPTIONAL {
+       ?finding bw:supportedBy ?source .                 # procedencia detrás del ancla
+       OPTIONAL { ?source bw:reference     ?reference . }
+       OPTIONAL { ?source bw:author        ?author . }
+       OPTIONAL { ?source bw:reliability   ?reliability . }
+       OPTIONAL { ?source bw:originalQuote ?originalQuote . }
+       OPTIONAL { ?source bw:translation   ?translation . }   # presente si la lengua de la fuente ≠ la del libro
+     }
+   }
+   ```
+
+2. **Lee el manuscrito** (`manuscript/`), acotado a `{ARGS}` si se indicó.
+3. **Caza las contradicciones.** Busca pasajes que **contradigan** un ancla en
+   los tres ejes de § 20.6:
+   - **anacronismos** (algo presente fuera de su época),
+   - **errores de procedimiento** (algo ilegal o imposible en la ambientación),
+   - **inexactitudes culturales o lingüísticas**.
+   Un pasaje puede romper varias anclas: regístralas todas.
+4. **Maneja los prerrequisitos ausentes** (→ "Información faltante"): sin
+   manuscrito, o sin anclas / con `[research].enabled = false`, repórtalo y no
+   inventes contradicciones.
+5. **Redacta el reporte** con la forma de la sección "Output". No edites ni
+   corrijas nada: el autor decide qué arreglar.
+
+Reutiliza el vocabulario `bw:`/CIDOC existente; no añadas clases ni predicados.
+
+## Output
+
+Un **reporte en prosa** legible por humanos (no un envoltorio JSON), **agrupado
+por capítulo/escena**. Bajo cada escena, cero o más hallazgos. Cada hallazgo
+lleva cuatro partes más su localización:
+
+- **(a) pasaje citado** — la prosa infractora del manuscrito, entre comillas.
+- **(b) ancla violada** — el hecho investigado (`bw:claim`) que el pasaje rompe;
+  si rompe N anclas, lístalas todas.
+- **(c) fuente** — la procedencia detrás del ancla (alcanzada vía
+  `bw:supportedBy`): `bw:reference` / `bw:author` / `bw:reliability` /
+  `bw:originalQuote`, citada **tal como la registra el grafo** (incluidas las
+  referencias en lengua original).
+- **(d) gravedad** — una de `error` / `warning` / `info` (`error > warning >
+  info`), el vocabulario `Severity` del sistema de validación.
+- **localización** — `file:line` cuando se conoce; si no, el capítulo/escena
+  **sin inventar un número de línea**.
+
+**Rúbrica de gravedad:** contradicción factual definida (anacronismo duro;
+procedimiento ilegal o imposible) → `error`; matiz cultural o estilístico blando
+→ `warning`/`info`. Una contradicción discutible se registra con **menor
+gravedad**, nunca suprimida ni exagerada. Un manuscrito limpio produce **cero
+hallazgos**: no fabriques problemas para llenar el reporte.
+
+## Archivos a leer
+
+- `manuscript/` (acotado por `{ARGS}` si se indicó).
+- El **grafo** del proyecto: anclas y fuentes vía `bookwright graph query`
+  (cadena `bw:promotes` → `bw:supportedBy`).
+- El bloque `[research]` de `manifest.toml` (para detectar `enabled = false`).
+
+## Archivos a escribir
+
+- Ninguno. Este comando es de **solo lectura**: **no escribe nada** en el
+  proyecto; solo emite un reporte (incluido el grafo que `graph build`
+  reconstruye como caché derivada).
+
+## Información faltante
+
+- **Sin manuscrito que verificar** → repórtalo como "prerrequisito ausente"
+  (nada que verificar) e indica que primero hay que redactar con
+  `bookwright-draft`. No falles de forma opaca.
+- **Sin anclas** (no hay `bible/research/`, ninguna ancla promovida, o
+  `[research].enabled = false`) → repórtalo como "nada que verificar", con
+  **cero** contradicciones.
+- No marques `[PENDING: …]`: este comando no escribe archivos.
+
+## Qué NO hacer
+
+- No edites ni corrijas el manuscrito ni ningún otro archivo: solo reporta.
+- No reaudites la **integridad estructural** de las anclas: eso es el validator
+  `factual_anchor`.
+- No busques en internet, no descargues fuentes ni añadas dependencias: razona
+  con el grafo y el manuscrito que ya tienes.
+- No inventes contradicciones para "llenar" el reporte: un manuscrito coherente
+  da cero hallazgos.
+- No compares el manuscrito con la **biblia**: eso es `bookwright-continuity`.
+- No omitas el `bookwright graph build --json` previo a la consulta.

bookwright/resources/commands/references/golem-character.md

@@ -0,0 +1,65 @@
+# GOLEM — El personaje (`G1_Character`)
+
+Referencia de dominio para escribir y leer las fichas de personaje
+(`bible/characters/<slug>.md`). El indexador las ingiere como instancias de
+`G1_Character` del modelo GOLEM. Consúltala desde `bookwright-bible` (al estampar
+las fichas) y desde `bookwright-draft` (para mantener la voz constante).
+
+## Lo platónico vs. lo narrativo
+
+GOLEM distingue dos planos del personaje:
+
+- **El personaje platónico** (`G0_Character-Stoff`): la identidad estable y
+  reconocible que persiste a través de toda la obra y, en teoría, a través de
+  distintas versiones de la historia. Es "quién es" con independencia de la
+  escena: su nombre, su biografía, su voz.
+- **El personaje narrativo** (manifestaciones en `G5_Narrative_Event` y estados
+  `G3_Psychological_State`): cómo aparece y cambia en momentos concretos de la
+  trama. Es "cómo está aquí y ahora".
+
+La ficha de `bible/characters/` captura sobre todo el plano **platónico**
+(identidad estable). La evolución por escena vive en el manuscrito, en
+`timeline.md` (eventos) y en los arcos del outline. No metas en la ficha datos
+que solo son ciertos en un capítulo concreto: márcalos donde correspondan.
+
+## Contrato del frontmatter
+
+El frontmatter de una ficha de personaje admite **únicamente** estas claves de
+nivel superior; cualquier otra genera un aviso del indexador:
+
+```yaml
+name: "Ana Soler"          # cadena obligatoria
+born: 1990                 # año entero, o se omite la línea
+died: 2031                 # año entero, o se omite si sigue viva
+features: ["zurda", "cicatriz en la ceja"]   # lista de cadenas
+narrative_roles: ["protagonista", "heroína"] # lista de cadenas
+```
+
+- **`name`** — obligatoria, cadena no vacía. Si falta el dato, escribe el
+  marcador **entre comillas**: `name: "[PENDING: ¿Cómo se llama?]"` (sin
+  comillas, los corchetes se parsean como lista y la ficha se descarta — ver
+  `references/pending-protocol.md`).
+- **`born` / `died`** — año entero o **omitidas**. Nunca un texto ni un
+  `[PENDING]`: un valor no entero hace que el indexador descarte el archivo. La
+  edad se deriva de `born`/`died` o se cuenta en prosa, jamás como cadena en el
+  frontmatter.
+- **`features`** — rasgos distintivos estables (físicos o de carácter), lista de
+  cadenas.
+- **`narrative_roles`** — etiquetas de función narrativa (protagonista,
+  antagonista, aliado, mentor…), lista de cadenas. Conectan con los vocabularios
+  de Propp/Greimas si la constitución los activó.
+
+## El slug
+
+El *slug* de un personaje se deriva de su `name` (p. ej. `name: "Ana Soler"` →
+`ana-soler`), **no** del nombre del archivo. Nombra cada
+`bible/characters/<slug>.md` con ese mismo slug para que las referencias desde
+`timeline.md` y `relationships.md` (que listan slugs en `participants`)
+resuelvan correctamente.
+
+## Secciones de cuerpo (de la plantilla)
+
+La ficha estampada trae secciones en prosa que **no** se indexan pero anclan al
+personaje: rasgos biográficos, rasgos psicológicos, rasgos físicos, rol
+narrativo, un diálogo de muestra (clave para la voz) y patrones de lenguaje
+corporal. Rellénalas con material del brief; marca `[PENDING: …]` lo que falte.

bookwright/resources/commands/references/golem-events-timeline.md

@@ -0,0 +1,56 @@
+# GOLEM — Eventos y línea de tiempo (`G5_Narrative_Event` vs. `G3_Psychological_State`)
+
+Referencia de dominio para `bible/timeline.md`. La consultan `bookwright-bible`
+(al poblar la cronología) y `bookwright-continuity` (al verificar la coherencia
+temporal del manuscrito frente a la biblia).
+
+## Evento vs. estado psicológico
+
+GOLEM separa dos cosas que es fácil confundir:
+
+- **`G5_Narrative_Event`** — un **hecho** discreto que ocurre en la historia y
+  hace avanzar la trama: "la caída del puente de Ardía", "el pacto en la torre".
+  Tiene participantes y ocupa un punto (o tramo) en la cronología. Es lo que se
+  registra en `timeline.md`.
+- **`G3_Psychological_State`** — el **estado interior** de un personaje en un
+  momento dado: "Ana, paralizada por la culpa tras el pacto". No es un hecho del
+  mundo, es una condición de la mente. **No** va en `timeline.md`: vive en la
+  ficha del personaje (rasgos psicológicos), en los arcos del outline y en el
+  manuscrito.
+
+Regla práctica al poblar la cronología: si la frase responde a "¿qué **pasó**?",
+es un evento → `timeline.md`. Si responde a "¿cómo **se sentía** alguien?", es un
+estado → ficha/arco, no la cronología.
+
+## Contrato del contenedor `timeline.md`
+
+`bible/timeline.md` es un archivo **contenedor indexado**. Su frontmatter lleva
+una única clave de nivel superior, `events:`, una lista de mapas en **orden
+cronológico interno** de la historia:
+
+```yaml
+events:
+  - name: "Caída del puente de Ardía"
+    participants: ["ana-soler", "marco-vega"]
+  - name: "Pacto en la torre"
+    participants: ["ana-soler"]
+```
+
+- `name` — obligatorio, cadena no vacía; nombra el hecho.
+- `participants` — opcional; lista de *slugs* de personaje. Cada slug debe
+  corresponder a un `bible/characters/<slug>.md` real o aparecerá como referencia
+  sin resolver.
+- El **orden de la lista** refleja el orden cronológico interno (no
+  necesariamente el orden de narración, que puede saltar).
+- **Mantén `events:` como única clave de nivel superior** del frontmatter; otra
+  clave dispara un aviso del indexador.
+- El cuerpo en prosa ("notas de cronología") ancla el marco temporal global
+  (época, duración, saltos); no se indexa.
+
+## Cronología interna vs. orden de narración
+
+`timeline.md` ordena los hechos según ocurren **dentro** del mundo de la obra.
+El orden en que el lector los descubre (analepsis, estructura no lineal) se
+decide en `outline/structure.md`. No fuerces el orden de narración sobre la
+cronología: son dos ejes distintos y `bookwright-continuity` los compara por
+separado.

bookwright/resources/commands/references/golem-relationships.md

@@ -0,0 +1,53 @@
+# GOLEM — Relaciones sociales (`G4_Social_Relationship`, `G6_Relationship_Role`)
+
+Referencia de dominio para `bible/relationships.md`. La consultan
+`bookwright-bible` (al poblar los vínculos) y `bookwright-continuity` (al razonar
+sobre la coherencia de las relaciones frente al manuscrito).
+
+## Modelado reificado del vínculo
+
+En GOLEM una relación social **no** es una arista simple "A quiere a B". Se
+*reifica*: la relación es una entidad de pleno derecho (`G4_Social_Relationship`)
+que conecta a dos o más participantes, y cada participante entra en ella a través
+de un **rol** (`G6_Relationship_Role`). Esto permite que una misma relación
+tenga roles asimétricos (mentor ↔ aprendiz, acreedor ↔ deudor) y que evolucione
+sin perder identidad.
+
+- **`G4_Social_Relationship`** — el vínculo en sí: "lealtad fracturada",
+  "rivalidad heredada". Tiene nombre y participantes.
+- **`G6_Relationship_Role`** — la posición que ocupa cada participante dentro de
+  ese vínculo. Captura la asimetría: en una relación de deuda, uno es acreedor y
+  otro deudor.
+
+Lo que importa al escribir la biblia: nombra el **vínculo** por su naturaleza
+("Lealtad fracturada"), no por las personas, y deja que los participantes y sus
+roles se expresen por separado.
+
+## Contrato del contenedor `relationships.md`
+
+`bible/relationships.md` es un archivo **contenedor indexado**. Su frontmatter
+lleva una única clave de nivel superior, `relationships:`, una lista de mapas:
+
+```yaml
+relationships:
+  - name: "Lealtad fracturada"
+    participants: ["ana-soler", "marco-vega"]
+  - name: "Rivalidad heredada"
+    participants: ["marco-vega", "elsa-roan"]
+```
+
+- `name` — obligatorio; nombra la **naturaleza** del vínculo, no a las personas.
+- `participants` — lista de *slugs* de personaje; cada slug debe existir como
+  `bible/characters/<slug>.md` o aparecerá como referencia sin resolver.
+- **Mantén `relationships:` como única clave de nivel superior** del
+  frontmatter. Cualquier otra clave dispara un aviso del indexador.
+- El cuerpo en prosa ("mapa de tensiones") describe cómo evolucionan las
+  alianzas y conflictos; no se indexa.
+
+## Roles asimétricos en prosa
+
+El frontmatter v0 captura el vínculo y sus participantes; la asimetría de roles
+(quién es mentor, quién aprendiz) y su evolución se narran en el cuerpo en prosa
+de `relationships.md` y en los arcos del outline, hasta que un manejador de roles
+explícito llegue en una iteración posterior. No inventes claves de frontmatter
+para los roles: descríbelos en prosa.

bookwright/resources/commands/references/greimas-actants.md

@@ -0,0 +1,57 @@
+# Greimas — El modelo actancial
+
+Referencia de dominio para la estructura. La consultan `bookwright-outline` (al
+articular el motor del conflicto) y `bookwright-scenes` (al ubicar cada escena en
+el eje de fuerzas). Úsala **solo** si la constitución activó el vocabulario de
+Greimas en "Vocabularios activos"; si no, es material de consulta opcional.
+
+## Qué aporta Greimas
+
+Algirdas Julien Greimas abstrajo las esferas de acción de Propp en un modelo más
+general y aplicable a cualquier relato: el **modelo actancial**. Un *actante* no
+es un personaje, es una **función estructural** dentro de la dinámica del relato.
+Un personaje puede encarnar varios actantes; un actante puede repartirse entre
+varios personajes, una colectividad, un objeto o una idea abstracta (la
+justicia, el deber).
+
+Su valor para Bookwright: revela el **motor del conflicto** de un vistazo y
+expone desequilibrios (un Sujeto sin Oponente real, un Objeto que a nadie le
+importa de verdad).
+
+## Los seis actantes en tres ejes
+
+El modelo organiza seis actantes en tres parejas de oposición:
+
+### Eje del deseo (Sujeto → Objeto)
+
+- **Sujeto** — quien desea y persigue una meta (a menudo el protagonista).
+- **Objeto** — lo deseado: una persona, una cosa, un estado del mundo, un valor.
+  Es el motor de la acción: define qué quiere el Sujeto.
+
+### Eje de la comunicación (Destinador → Destinatario)
+
+- **Destinador (sender)** — la fuerza que motiva o encomienda la búsqueda y, al
+  final, sanciona el resultado: un personaje, una institución, una ley moral, el
+  destino.
+- **Destinatario (receiver)** — quien se beneficia de que el Objeto se alcance
+  (a veces coincide con el propio Sujeto).
+
+### Eje del poder (Ayudante ↔ Oponente)
+
+- **Ayudante (helper)** — lo que facilita la obtención del Objeto: aliados,
+  recursos, cualidades del Sujeto.
+- **Oponente (opponent)** — lo que la obstaculiza: el antagonista, pero también
+  miedos internos, circunstancias, el tiempo.
+
+## Cómo usarlo al escribir
+
+Para una obra o un arco, completa el esquema: *¿Quién es el Sujeto? ¿Qué Objeto
+persigue? ¿Quién/qué se lo encarga y para quién? ¿Qué lo ayuda y qué se le
+opone?* Si una casilla queda vacía o difusa, suele señalar un problema
+estructural antes de escribir una sola escena. A nivel de escena, identifica qué
+fuerzas actanciales están en juego: una escena nítida casi siempre enfrenta a un
+Sujeto con un Oponente respecto a un Objeto concreto.
+
+El modelo dialoga con las esferas de Propp (ver `references/propp-functions.md`):
+el Sujeto ≈ héroe, el Oponente ≈ villano, el Ayudante ≈ auxiliar/donante, el
+Destinador ≈ mandatario. Greimas es la lectura abstracta; Propp, la concreta.

bookwright/resources/commands/references/pending-protocol.md

@@ -0,0 +1,72 @@
+# Protocolo `[PENDING: …]` — marcar y continuar vs. detenerse y preguntar
+
+Esta es la regla compartida que todos los comandos generativos
+(`bookwright-constitution`, `bookwright-bible`, `bookwright-outline`,
+`bookwright-scenes`, `bookwright-draft`, `bookwright-synopsis`,
+`bookwright-research`) siguen al encontrar información que el brief o los
+artefactos existentes no proporcionan.
+Es la única fuente de verdad de esta decisión: los cuerpos de los comandos
+enlazan aquí en lugar de repetir la regla.
+
+## El token
+
+El marcador de relleno es exactamente `[PENDING: <pregunta en español>]`:
+
+- El token `PENDING` se escribe **en inglés** y en mayúsculas.
+- La pregunta que sigue se escribe **en español**, redactada como una pregunta
+  concreta dirigida al autor (no una etiqueta genérica como `[PENDING]` a secas).
+- Ejemplo: `[PENDING: ¿Desde qué distancia narrativa se cuenta la obra?]`.
+
+Este es el mismo marcador que estampan las plantillas de la iteración 7, que
+busca el barrido de centinelas y que evalúa `bookwright-checklist`. No inventes
+variantes (`[PENDIENTE]`, `TODO`, `???`): romperían ese acuerdo.
+
+## Marcar y continuar (caso por defecto)
+
+Cuando el material disponible simplemente **carece** de un dato, escribe el
+`[PENDING: …]` en su sitio y **continúa** con el resto del trabajo. No te
+detengas a preguntar. Ejemplos de "carece de un dato":
+
+- El brief no menciona el año de nacimiento de un personaje secundario.
+- No se indica el tono exacto del registro coloquial.
+- Falta el nombre de un lugar que aún no es relevante para la trama.
+
+La obra puede avanzar con estos huecos marcados; el autor los resolverá después,
+y una nueva invocación del comando los rellenará (regla de actualización en
+sitio).
+
+## Detenerse y preguntar (excepción)
+
+Detente y consulta al autor **solo** cuando continuar exigiría inventar *canon
+estructural* (load-bearing): un dato del que dependen otras decisiones y que no
+puede derivarse de los artefactos existentes, o que **contradiría** algo ya
+escrito. Ejemplos:
+
+- La motivación central del protagonista (de ella cuelgan arco, escenas y
+  desenlace).
+- El modelo estructural de la obra cuando el outline depende por completo de él.
+- Un hecho nuevo que chocaría con la constitución o con una ficha ya resuelta.
+
+En estos casos, inventar sería peor que un hueco: propagaría una decisión
+arbitraria por toda la obra. Formula una pregunta breve y precisa, y espera la
+respuesta antes de escribir ese fragmento.
+
+Regla mnemónica: **si el hueco solo te falta, márcalo; si rellenarlo te obliga a
+decidir el rumbo de la obra, pregunta.**
+
+## Comillas en YAML (campos de tipo cadena)
+
+Cuando un `[PENDING: …]` cae dentro de un campo de frontmatter **de tipo
+cadena** —el caso típico es `name:` en una ficha de personaje o de escenario—
+debe ir **entre comillas**:
+
+```yaml
+name: "[PENDING: ¿Cómo se llama el personaje?]"
+```
+
+Sin comillas, los corchetes `[ … ]` se interpretan como una **lista YAML**: el
+valor deja de ser una cadena, el indexador descarta la ficha y el dato se
+pierde silenciosamente. Esto **solo** aplica a campos de cadena del frontmatter;
+en el cuerpo en prosa el marcador se escribe sin comillas
+(`[PENDING: ¿…?]`). Nunca pongas un `[PENDING]` en un campo numérico (`born`,
+`died`): déjalo omitido en su lugar.

bookwright/resources/commands/references/propp-functions.md

@@ -0,0 +1,54 @@
+# Propp — Funciones narrativas y dramatis personae
+
+Referencia de dominio para la estructura. La consultan `bookwright-outline` (al
+montar arcos y estructura) y `bookwright-scenes` (al asignar a cada escena su
+función narrativa). Úsala **solo** si la constitución activó el vocabulario de
+Propp en "Vocabularios activos"; si no, es material de consulta opcional.
+
+## Qué aporta Propp
+
+Vladimir Propp analizó el cuento maravilloso y observó que, bajo la variedad
+superficial, las historias reutilizan un repertorio limitado de **funciones**:
+unidades de acción definidas por su papel en el desarrollo de la trama, no por
+quién las ejecuta. Su valor para Bookwright es doble: dar a cada escena una
+**función** identificable (que justifica su existencia) y detectar huecos
+estructurales (una promesa sin pago, un villano sin fechoría).
+
+## Las funciones (repertorio condensado)
+
+Propp enumera 31 funciones que tienden a aparecer en orden. Condensadas en sus
+movimientos esenciales:
+
+1. **Preparación** — alejamiento, prohibición, transgresión, primer daño o
+   carencia que pone la historia en marcha (la *fechoría* o la *carencia*).
+2. **Complicación** — el héroe se entera, decide actuar y parte; aparece el
+   donante, que lo somete a una prueba.
+3. **Transferencia** — el héroe recibe un auxiliar mágico u objeto y se traslada
+   al lugar de la prueba decisiva.
+4. **Combate** — enfrentamiento con el antagonista, marca o herida, victoria,
+   reparación del daño/carencia inicial.
+5. **Regreso** — vuelta, persecución, socorro; a veces llegada de incógnito y
+   pretensiones de un falso héroe.
+6. **Reconocimiento** — tarea difícil, su resolución, reconocimiento del héroe,
+   desenmascaramiento del falso héroe, castigo y recompensa (boda/ascenso).
+
+Cada escena debería poder etiquetarse con la función que cumple. Una escena que
+no avanza ninguna función suele ser una escena que sobra.
+
+## Dramatis personae (las siete esferas de acción)
+
+Propp agrupa a los personajes por la **esfera de acción** que ocupan, no por su
+identidad. Un mismo personaje puede cambiar de esfera; varias personas pueden
+compartir una:
+
+- **Héroe** — quien repara la carencia o vence; sigue el recorrido central.
+- **Antagonista / villano** — causa la fechoría y se opone al héroe.
+- **Donante** — provee el medio (objeto, saber) tras una prueba.
+- **Auxiliar** — ayuda al héroe en la misión.
+- **Princesa (y su padre)** — el objeto buscado y quien fija/recompensa la tarea.
+- **Mandatario** — quien envía al héroe a la misión.
+- **Falso héroe** — reclama el mérito ajeno; será desenmascarado.
+
+Estas esferas conversan con `narrative_roles` en las fichas de personaje y con el
+modelo actancial de Greimas (ver `references/greimas-actants.md`), que ofrece una
+lectura más abstracta de las mismas fuerzas.

bookwright/resources/commands/references/research-format.md

@@ -0,0 +1,136 @@
+# Formato de `bible/research/` — el contrato que el grafo lee
+
+Esta es la referencia de formato para los archivos que escribe
+`bookwright-research`. El lector (`bookwright graph build`) es **estricto**: una
+violación marcada *fatal* aborta el build con un `ResearchError` y no produce
+grafo. Escribe exactamente esta forma; no inventes claves ni valores nuevos.
+
+Orden de proceso (determinista): `sources.md` → cada `<tema>.md` (orden
+alfabético) → `_index.md`.
+
+## Vocabularios controlados
+
+- `type` ∈ `{primaria, secundaria, oficial, académica, periodística, testimonial}`
+- `reliability` ∈ `{alta, media, baja}`
+
+Un `type` o `reliability` fuera de vocabulario es **fatal** (el error nombra el
+valor).
+
+## `sources.md` — el registro de fuentes
+
+Clave de frontmatter `sources:` → una lista de mappings. Por cada fuente:
+
+| Clave | Obligatoria | Tipo | Notas |
+|---|---|---|---|
+| `name` | ✅ | str | único por *slug* en el archivo (un *slug* duplicado es **fatal**) |
+| `reference` | ✅ | str | localizador de la cita (signatura, URL, tomo/folio) |
+| `author` | ✅ | str | autor u organismo responsable |
+| `original_language` | ✅ | str | código ISO 639-1 (`es`, `de`, `fr`, …) |
+| `type` | ✅ | enum | ver vocabulario |
+| `reliability` | ✅ | enum | ver vocabulario |
+| `reliability_justification` | ✅ | str | no vacío: por qué esa fiabilidad |
+| `access_date` | ✅ | fecha | ISO `YYYY-MM-DD` |
+| `original_quote` | ✅ | str | cita literal en la lengua original |
+| `translation` | condicional | str | **obligatoria si** `original_language` ≠ idioma del libro; **se omite** cuando coinciden |
+
+- Falta una faceta obligatoria → **fatal** (el error nombra la faceta).
+- Regla de traducción: una fuente en lengua distinta a la del libro **sin**
+  `translation` es **fatal**. Si coinciden, no pongas `translation`.
+
+Ejemplo (libro en `es`, fuente en `de`):
+
+```yaml
+---
+sources:
+  - name: "Kriegstagebuch des OKW, Bd. III"
+    reference: "BA-MA RH 2/..., ff. 12-18"
+    author: "Oberkommando der Wehrmacht"
+    original_language: de
+    type: primaria
+    reliability: alta
+    reliability_justification: "Registro oficial contemporáneo."
+    access_date: 2026-06-04
+    original_quote: "Die Nachschublage an der Ostfront ..."
+    translation: "La situación de abastecimiento en el frente oriental ..."
+---
+```
+
+## `<tema>.md` — hallazgos y anclas
+
+Frontmatter con `findings:` y `anchors:` (ambas listas, opcionales). El nombre de
+archivo es el *slug* del título del tema; conserva el título humano como
+`# Encabezado` y como prosa legible en el cuerpo (el cuerpo no se indexa).
+
+### `findings[]`
+
+| Clave | Obligatoria | Tipo | Notas |
+|---|---|---|---|
+| `id` | ✅ | str | no vacío; único en el archivo; es el blanco de las anclas |
+| `claim` | condicional | str | obligatoria salvo que `open: true` |
+| `sources` | condicional | list[str] | ≥1 nombre de fuente que **resuelva** en `sources.md`, salvo `open: true` (no resolver es **fatal**) |
+| `asserted_by` | ❌ | str | por defecto `"author"` |
+| `bears_on` | ❌ | str | nombre de entidad narrativa; si no resuelve, **aviso suave** |
+| `open` | ❌ | bool | por defecto `false` |
+
+- Un hallazgo no abierto sin `claim` **o** sin ≥1 fuente que resuelva es **fatal**.
+- Cuando las fuentes discrepen, escribe **dos hallazgos**, cada uno con su propia
+  fuente; nunca los fundas en uno solo.
+
+### `anchors[]`
+
+| Clave | Obligatoria | Tipo | Notas |
+|---|---|---|---|
+| `promotes` | ✅ | str | un `id` de hallazgo **de este archivo** (desconocido = **fatal**) |
+| `constrains` | ✅ | str | nombre de entidad narrativa, o el literal `"timeline"`; ausente = **fatal**; entidad que no resuelve = **aviso suave** |
+| `begin` | ❌ | int | año (solo entero; otra cosa = **fatal**) |
+| `end` | ❌ | int | año |
+| `date` | ❌ | int | año; **mutuamente excluyente** con `begin`/`end` (combinarlos = **fatal**) |
+
+Promueve a ancla **solo** si la mejor fuente del hallazgo alcanza el umbral
+`[research].min_reliability_for_anchor` del manifiesto (`alta` > `media` > `baja`).
+
+```yaml
+---
+findings:
+  - id: f1
+    claim: "El ferrocarril de vía estrecha limitaba el tonelaje diario."
+    sources: ["Kriegstagebuch des OKW, Bd. III"]
+    bears_on: "Wehrmacht"
+  - id: q-ruta-suministro
+    open: true
+anchors:
+  - promotes: f1
+    constrains: "Wehrmacht"
+    begin: 1943
+    end: 1943
+---
+```
+
+## `_index.md` — preguntas abiertas y mapa de temas
+
+Frontmatter con `open_questions:` → una lista mapeada como **hallazgos abiertos**
+(`id` obligatorio; `claim`/`sources` opcionales). El cuerpo en prosa (mapa de
+temas, lista global de preguntas abiertas) es para humanos y **no se indexa**.
+
+```yaml
+---
+open_questions:
+  - id: q-calibre-via
+    claim: "¿Qué ancho de vía tenía el ramal?"
+---
+# Índice de investigación
+## Temas
+- [Logística de la Wehrmacht en 1943](logistica-de-la-wehrmacht-en-1943.md)
+```
+
+## Suave vs. fatal — resumen
+
+- **Fatal** (`ResearchError`, sin grafo): YAML mal formado; falta una faceta de
+  fuente; vocabulario desconocido; nombre de fuente duplicado; hallazgo no abierto
+  sin `claim`/fuente; nombre de fuente que no resuelve; ancla que promueve un
+  hallazgo desconocido; falta `constrains`; año no entero; `date` junto a
+  `begin`/`end`; incumplir la regla de traducción.
+- **Suave** (`ResearchWarning`, el grafo se construye igual): un `bears_on` o
+  `constrains` que no resuelve en la biblia (se omite la arista; la verificación
+  de existencia es trabajo de un validador posterior).
+- **Vacío/ausente** `bible/research/` → cero entidades, nunca falla.

bookwright/resources/project/.gitignore

@@ -0,0 +1,23 @@
+# Bookwright project cache (regenerated by `bookwright graph build`)
+.bookwright/cache/
+
+# Python artifacts
+*.pyc
+*.pyo
+__pycache__/
+*.egg-info/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+
+# Environment files
+.env
+.env.*
+!.env.example
+
+# OS cruft
+.DS_Store
+Thumbs.db