bookwright-cli 0.2.0__py3-none-any.whl

bookwright/resources/schemas/golem-1.1/version.json

@@ -0,0 +1,8 @@
+{
+  "repository": "https://github.com/GOLEM-lab/golem-ontology",
+  "commit": "f666128a9a29f39c9f23c96ae1c48023cc8e7898",
+  "file": "golem/golem_v1-1.ttl",
+  "version_iri": "https://w3id.org/golem/ontology/v1.1",
+  "version_info": "1.1",
+  "retrieved": "2026-05-30"
+}

bookwright/resources/templates/__init__.py

@@ -0,0 +1 @@
+"""Bundled TOML/Markdown templates loaded via importlib.resources."""

bookwright/resources/templates/bible/character.md.tmpl

@@ -0,0 +1,63 @@
+---
+name: "[PENDING: ¿Cómo se llama el personaje?]"
+# born: 1990          # año entero; descomenta y rellena, nunca un texto
+# died:               # año entero o deja la línea omitida si sigue vivo
+features: []
+narrative_roles: []
+---
+
+# Ficha de personaje
+
+<!--
+Guía para el agente y el autor: esta ficha se indexa como un `Character` del
+modelo GOLEM. El frontmatter sólo admite las claves `name`, `born`, `died`,
+`features` y `narrative_roles`; cualquier otra clave de nivel superior genera un
+aviso del indexador.
+
+  - `name`: cadena obligatoria. El prompt `[PENDING: …]` es legal sólo entre
+    comillas (`name: "[PENDING: …]"`); sin comillas, los corchetes se leen como
+    una lista YAML y la ficha se descarta.
+  - `born` / `died`: año entero o se omiten. Nunca un texto ni un `[PENDING]`:
+    un valor no entero hace que el indexador descarte el archivo. La edad se
+    expresa por `born`/`died` o en prosa, jamás como cadena en el frontmatter.
+  - `features` / `narrative_roles`: listas de cadenas.
+
+Ejemplo de frontmatter ya rellenado:
+
+name: "Ana Soler"
+born: 1990
+features: ["cicatriz en la ceja", "zurda"]
+narrative_roles: ["protagonista", "heroína"]
+-->
+
+## Rasgos biográficos
+
+<!-- Guía: origen, familia, hitos vitales. La edad se deriva de `born`/`died` o
+     se cuenta aquí en prosa, nunca como dato en el frontmatter. -->
+
+[PENDING: ¿De dónde viene el personaje y qué hechos marcaron su vida?]
+
+## Rasgos psicológicos
+
+[PENDING: ¿Qué quiere, qué teme y qué herida arrastra?]
+
+## Rasgos físicos
+
+[PENDING: ¿Qué aspecto tiene y qué detalle lo hace reconocible?]
+
+## Rol narrativo
+
+<!-- Guía: su función en la trama (protagonista, antagonista, aliado…) y cómo
+     se relaciona con los `narrative_roles` declarados en el frontmatter. -->
+
+[PENDING: ¿Qué papel cumple en la historia y respecto a quién?]
+
+## Diálogo de muestra
+
+<!-- Guía: dos o tres réplicas que capturen su voz, para mantenerla constante. -->
+
+[PENDING: ¿Cómo habla? Escribe una réplica característica.]
+
+## Patrones de lenguaje corporal
+
+[PENDING: ¿Qué gestos o tics lo delatan bajo presión?]

bookwright/resources/templates/bible/location.md.tmpl

@@ -0,0 +1,37 @@
+# Ficha de lugar
+
+<!--
+Guía para el agente y el autor: esta plantilla describe un lugar concreto y
+sensorial (una taberna, un puente, una habitación), no el universo amplio (para
+eso está la ficha de escenario). **No se indexa en v0**: el modelo GOLEM aún no
+tiene un manejador de lugares, así que esta ficha es material de consulta y no
+lleva frontmatter ingerido por el indexador. Ancla cada lugar en los cinco
+sentidos para que las escenas que ocurran allí sean concretas. Ejemplo:
+
+  - Qué se ve: vigas combadas, una lámpara de aceite que parpadea.
+  - Qué se oye: el río golpeando los pilotes bajo el suelo.
+  - Qué se huele: humedad, brea, pan quemado.
+-->
+
+## Qué se ve
+
+[PENDING: ¿Qué imágenes dominan el lugar a primera vista?]
+
+## Qué se oye
+
+[PENDING: ¿Qué sonidos lo habitan?]
+
+## Qué se huele
+
+[PENDING: ¿Qué olores lo caracterizan?]
+
+## Qué se toca
+
+[PENDING: ¿Qué texturas y temperaturas se sienten aquí?]
+
+## Atmósfera dominante
+
+<!-- Guía: la emoción que el lugar imprime en quien lo cruza; la suma sensorial
+     convertida en tono. -->
+
+[PENDING: ¿Qué sensación deja el lugar y cómo afecta a la escena que ocurre en él?]

bookwright/resources/templates/bible/research/_index.md.tmpl

@@ -0,0 +1,25 @@
+---
+open_questions: []
+---
+
+# Índice de investigación
+
+<!--
+Guía: molde del índice de investigación, resoluble por capas (un override del
+proyecto bajo `.bookwright/templates/` tiene prioridad sobre este core). Conserva
+la clave `open_questions:` y añade temas en la lista de abajo. El cuerpo en prosa
+no se indexa; el contrato exacto está en `references/research-format.md`.
+-->
+
+## Temas
+
+<!-- Guía: una entrada por tema investigado, enlazando a su `<slug>.md`. -->
+
+[PENDING: ¿Qué tema vas a enlazar? p. ej. `- [Título del tema](slug-del-tema.md)`]
+
+## Preguntas abiertas
+
+<!-- Guía: pasa cada pregunta a `open_questions:` con un `id` cuando quieras
+     rastrearla en el grafo. -->
+
+[PENDING: ¿Qué pregunta global del proyecto queda abierta?]

bookwright/resources/templates/bible/research/sources.md.tmpl

@@ -0,0 +1,21 @@
+---
+sources: []
+---
+
+# Registro de fuentes
+
+<!--
+Guía: molde del registro de fuentes, resoluble por capas (un override del
+proyecto bajo `.bookwright/templates/` tiene prioridad sobre este core). Cada
+elemento de `sources:` necesita procedencia completa — `name`, `reference`,
+`author`, `original_language`, `type` (primaria | secundaria | oficial |
+académica | periodística | testimonial), `reliability` (alta | media | baja),
+`reliability_justification`, `access_date`, `original_quote` y `translation`
+cuando la lengua difiera de la del libro. Ver `references/research-format.md`.
+-->
+
+## Notas
+
+<!-- Guía: prosa de trabajo; no se indexa. La fuente real vive en `sources:`. -->
+
+[PENDING: ¿Qué fuente vas a registrar y con qué justificación de fiabilidad?]

bookwright/resources/templates/bible/research/tema.md.tmpl

@@ -0,0 +1,37 @@
+---
+findings: []
+anchors: []
+---
+
+# Tema de investigación
+
+<!--
+Guía: molde de un tema de investigación, resoluble por capas (un override del
+proyecto bajo `.bookwright/templates/` tiene prioridad sobre este core).
+`findings:` lista los hallazgos (cada uno con `id`, `claim` y `sources`, salvo
+los abiertos con `open: true`). `anchors:` promueve hallazgos a anclas
+vinculantes (`promotes` + `constrains`). Sustituye el encabezado de arriba por el
+título humano del tema; el archivo se nombra con su *slug*. Contrato exacto en
+`references/research-format.md`.
+-->
+
+## Hallazgos
+
+<!-- Guía: un hallazgo por afirmación. Cuando las fuentes discrepen, escribe un
+     hallazgo por versión, cada uno con su propia fuente; nunca los fundas. -->
+
+[PENDING: ¿Qué afirmaste, con qué fuente y sobre qué entidad narrativa recae?]
+
+## Anclas
+
+<!-- Guía: marca como ancla solo el hallazgo cuya mejor fuente alcance
+     `[research].min_reliability_for_anchor`. -->
+
+[PENDING: ¿Qué hallazgo restringe a qué entidad (personaje, escenario, evento o `timeline`)?]
+
+## Preguntas abiertas
+
+<!-- Guía: deja aquí, o como `open_questions` en el índice, lo que siga sin
+     fuente fiable; no lo rellenes con afirmaciones inventadas. -->
+
+[PENDING: ¿Qué sub-pregunta de este tema queda abierta?]

bookwright/resources/templates/bible/setting.md.tmpl

@@ -0,0 +1,38 @@
+---
+name: "[PENDING: ¿Cómo se llama el escenario?]"
+---
+
+# Ficha de escenario
+
+<!--
+Guía para el agente y el autor: esta ficha se indexa como un `Setting` del
+modelo GOLEM, el universo narrativo amplio (una región, una era, una cultura),
+no un lugar concreto y sensorial (para eso está la plantilla de "lugar").
+
+El frontmatter admite **únicamente** la clave `name`: cualquier otra clave de
+nivel superior genera un aviso del indexador. `name` es una cadena obligatoria;
+el prompt `[PENDING: …]` es legal sólo entre comillas. Ejemplo ya rellenado:
+
+name: "Las Ciudades-Puente del Vel"
+-->
+
+## Cultura
+
+<!-- Guía: valores, costumbres, lenguas, estructuras de poder que tiñen la vida
+     cotidiana de este universo. -->
+
+[PENDING: ¿Qué cultura(s) habitan este escenario y qué las define?]
+
+## Sistema / era
+
+<!-- Guía: el marco tecnológico, mágico o histórico, y el momento temporal en
+     que transcurre la obra dentro de este universo. -->
+
+[PENDING: ¿En qué época y bajo qué sistema (tecnológico, mágico, social) ocurre?]
+
+## Geografía amplia
+
+<!-- Guía: la forma del mundo a gran escala: regiones, fronteras, rutas; los
+     lugares concretos se detallan en fichas de lugar aparte. -->
+
+[PENDING: ¿Cómo es la geografía general y qué regiones importan a la trama?]

bookwright/resources/templates/manifest.template.toml

@@ -0,0 +1,79 @@
+# Bookwright project manifest.
+#
+# This file is the source of truth for a Bookwright project: it declares the
+# CLI floor, the schema generation stamp, the project's URI namespace, and the
+# author-facing book metadata. Every other Bookwright command reads from here.
+#
+# Generated by `Manifest.build(...)`. The toolkit preserves comments and key
+# order on every round-trip; edit values freely.
+
+[bookwright]
+# Minimum Bookwright CLI version required to operate on this project (PEP 440).
+cli_version_min = "0.0.0"
+# GOLEM ontology schema stamp.
+schema_version = "golem-1.1"
+# Manifest format version (positive integer string).
+manifest_version = "1"
+# Absolute http(s) URI used as the @prefix for the project's Turtle graph.
+# Must end with `/`.
+uri_base = "https://example.org/project/"
+# Graph indexer backend.
+indexer = "rdflib"
+
+[book]
+# Required: human-readable title.
+title = "Untitled"
+# Required: one of novel | essay | memoir | non-fiction-narrative | other.
+type = "novel"
+# Required: ISO 639-1 alpha-2 code (lowercase).
+language = "en"
+# Required: at least one author. Duplicates are allowed (co-authorship).
+authors = ["Anonymous"]
+# Optional free-form fields below.
+subtitle = ""
+genre = []
+# Optional `target_length_words` (positive integer) is omitted by default.
+# The builder will insert it when an override is supplied.
+status = "drafting"
+
+[book.metadata]
+# Free-form metadata preserved verbatim by the manifest loader.
+
+[vocabularies]
+# List of vocabulary names (resolved later against .bookwright/vocabularies/).
+active = []
+
+[validators]
+# Built-in validators to enable/disable plus the names of custom validators.
+enabled = []
+disabled = []
+custom = []
+
+[integration]
+# Recorded integration metadata. The manifest loader treats this block as data
+# only; agent dispatch happens in a downstream registry.
+key = "claude"
+skills_dir = ".claude/skills"
+
+[integration.options]
+# Free-form options preserved verbatim.
+
+[paths]
+# Project-relative content roots. No filesystem check at load time.
+manuscript = "manuscript/"
+bible = "bible/"
+outline = "outline/"
+graph = "bible/graph.ttl"
+constitution = "bible/constitution.md"
+
+[research]
+# Whether the research system is active. When false, the bookwright-research
+# skill reports the system inert and produces no graph-bound findings.
+enabled = true
+# Source provenances (ISO 639-1 codes) the protocol should deliberately seek for
+# nationally-charged topics, e.g. ["de", "pl", "en", "fr"]. Empty = no declared
+# preference; the original-language rule still applies.
+source_languages = []
+# Minimum source reliability required before a finding may become a binding
+# anchor: one of "alta" | "media" | "baja".
+min_reliability_for_anchor = "media"

bookwright/resources/templates/manuscript/chapter.md.tmpl

@@ -0,0 +1,36 @@
+# Capítulo: [PENDING: ¿Qué título lleva el capítulo?]
+
+<!--
+Guía para el agente y el autor: esta plantilla estructura el borrador de un
+capítulo. No lleva frontmatter ingerido por el indexador: es texto de
+manuscrito. Usa el encabezado para fijar el propósito del capítulo antes de
+redactar, y separa las escenas con una línea de regla (`---`) o un salto claro.
+Ejemplo de propósito: "Cap. 3 — Ana descubre la deuda de Marco; termina con la
+decisión de ocultárselo a su madre." -->
+
+## Propósito del capítulo
+
+<!-- Guía: una o dos frases con la función dramática del capítulo y el cambio de
+     estado que debe producir. -->
+
+[PENDING: ¿Qué hace avanzar este capítulo y cómo deja al lector distinto al empezarlo?]
+
+## POV y momento
+
+<!-- Guía: desde qué personaje se narra (si la obra es multi-POV) y cuándo
+     ocurre respecto a la línea de tiempo. -->
+
+[PENDING: ¿Quién narra y en qué punto de la historia transcurre?]
+
+## Escenas
+
+<!-- Guía: lista las escenas del capítulo en orden; desarrolla cada una en su
+     propia ficha de escena y enlázalas o transcríbelas aquí al redactar. -->
+
+[PENDING: ¿En qué escenas se divide el capítulo?]
+
+## Borrador
+
+<!-- Guía: el texto del capítulo. Empieza a escribir aquí. -->
+
+[PENDING: Redacta el capítulo a partir de las decisiones anteriores.]

bookwright/resources/templates/scenes/scene.md.tmpl

@@ -0,0 +1,37 @@
+# Escena: [PENDING: ¿Qué identificador y título lleva la escena?]
+
+<!--
+Guía para el agente y el autor: esta plantilla estructura el borrador de una
+escena, la unidad mínima de la redacción. No lleva frontmatter ingerido por el
+indexador. Toda escena debe cambiar algo: define objetivo, conflicto y cambio de
+estado antes de escribir. Ejemplo:
+
+  - Objetivo del POV: conseguir el salvoconducto.
+  - Conflicto: el vendedor la reconoce y sube el precio.
+  - Cambio de estado: de anónima a buscada.
+-->
+
+## Encuadre
+
+<!-- Guía: lugar, momento y quién está presente al abrir la escena. -->
+
+[PENDING: ¿Dónde, cuándo y con quién arranca la escena?]
+
+## Objetivo del POV
+
+[PENDING: ¿Qué quiere conseguir el personaje de punto de vista aquí?]
+
+## Conflicto
+
+[PENDING: ¿Qué o quién se interpone?]
+
+## Cambio de estado
+
+<!-- Guía: el "antes → después" que justifica la existencia de la escena; si
+     nada cambia, la escena sobra. -->
+
+[PENDING: ¿Cómo queda la situación al cerrar la escena, distinta de como empezó?]
+
+## Borrador
+
+[PENDING: Redacta la escena a partir de las decisiones anteriores.]

bookwright/resources/vocabularies/__init__.py

@@ -0,0 +1,6 @@
+"""Bundled Turtle vocabulary stubs copied into ``.bookwright/vocabularies/``.
+
+Marker file — vocabularies are read at scaffold time via
+``importlib.resources.files("bookwright.resources.vocabularies")``. Full
+vocabularies land with iteration 10.
+"""

bookwright/resources/vocabularies/greimas.ttl

@@ -0,0 +1,4 @@
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix greimas: <https://bookwright.dev/vocab/greimas#> .
+
+greimas:Actant a owl:Class .

bookwright/resources/vocabularies/propp.ttl

@@ -0,0 +1,4 @@
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix propp: <https://bookwright.dev/vocab/propp#> .
+
+propp:Function a owl:Class .

bookwright/resources/vocabularies/sources.ttl

@@ -0,0 +1,82 @@
+@prefix bw:   <https://bookwright.dev/vocab/bw#> .
+@prefix crm:  <http://www.cidoc-crm.org/cidoc-crm/> .
+@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix xsd:  <http://www.w3.org/2001/XMLSchema#> .
+
+# Bookwright's own research/provenance vocabulary (iteration 012). These terms are
+# Bookwright's, NOT part of the frozen GOLEM ontology (`golem.ttl`): they are
+# intentionally outside the `CLASS_IRI` 17-class closure (Constitution X). The
+# emitted `bible/graph.ttl` reuses only `crm:E13_Attribute_Assignment` and
+# `crm:E55_Type` for typing; no new GOLEM/ontology class is introduced (FR-001).
+# This file is the human-readable declaration the emitted triples conform to;
+# enforcement lives in the `Source` Pydantic `Literal`s (research D4).
+
+# --- Source-type controlled vocabulary (six E55_Type individuals, FR-003) ----
+
+<https://bookwright.dev/vocab/bw#source-type/primaria>
+    a crm:E55_Type ; rdfs:label "primaria"@es .
+<https://bookwright.dev/vocab/bw#source-type/secundaria>
+    a crm:E55_Type ; rdfs:label "secundaria"@es .
+<https://bookwright.dev/vocab/bw#source-type/oficial>
+    a crm:E55_Type ; rdfs:label "oficial"@es .
+<https://bookwright.dev/vocab/bw#source-type/academica>
+    a crm:E55_Type ; rdfs:label "académica"@es .
+<https://bookwright.dev/vocab/bw#source-type/periodistica>
+    a crm:E55_Type ; rdfs:label "periodística"@es .
+<https://bookwright.dev/vocab/bw#source-type/testimonial>
+    a crm:E55_Type ; rdfs:label "testimonial"@es .
+
+# --- Reliability controlled vocabulary (three E55_Type individuals, FR-004) --
+
+<https://bookwright.dev/vocab/bw#reliability/alta>
+    a crm:E55_Type ; rdfs:label "alta"@es .
+<https://bookwright.dev/vocab/bw#reliability/media>
+    a crm:E55_Type ; rdfs:label "media"@es .
+<https://bookwright.dev/vocab/bw#reliability/baja>
+    a crm:E55_Type ; rdfs:label "baja"@es .
+
+# --- bw: property declarations (contracts/provenance-graph.md) ----------------
+
+bw:reference a rdf:Property ;
+    rdfs:label "reference"@en ;
+    rdfs:comment "Bibliographic reference or URL of a source."@en .
+bw:author a rdf:Property ;
+    rdfs:label "author"@en ;
+    rdfs:comment "Author or issuing body of a source."@en .
+bw:originalLanguage a rdf:Property ;
+    rdfs:label "originalLanguage"@en ;
+    rdfs:comment "ISO 639-1 code of a source's original language."@en .
+bw:reliability a rdf:Property ;
+    rdfs:label "reliability"@en ;
+    rdfs:comment "A source's reliability E55_Type individual (alta/media/baja)."@en .
+bw:reliabilityJustification a rdf:Property ;
+    rdfs:label "reliabilityJustification"@en ;
+    rdfs:comment "Prose justifying a source's reliability rating."@en .
+bw:accessDate a rdf:Property ;
+    rdfs:label "accessDate"@en ;
+    rdfs:comment "The date a source was consulted (xsd:date)."@en .
+bw:originalQuote a rdf:Property ;
+    rdfs:label "originalQuote"@en ;
+    rdfs:comment "Verbatim quote in the source's original language."@en .
+bw:translation a rdf:Property ;
+    rdfs:label "translation"@en ;
+    rdfs:comment "Translation of the quote; present iff source language differs from the book's."@en .
+bw:claim a rdf:Property ;
+    rdfs:label "claim"@en ;
+    rdfs:comment "The real-world assertion a finding records."@en .
+bw:assertedBy a rdf:Property ;
+    rdfs:label "assertedBy"@en ;
+    rdfs:comment "Who asserts a finding's claim (agent or author)."@en .
+bw:supportedBy a rdf:Property ;
+    rdfs:label "supportedBy"@en ;
+    rdfs:comment "A source supporting a finding (one per source)."@en .
+bw:open a rdf:Property ;
+    rdfs:label "open"@en ;
+    rdfs:comment "True when a finding is an unresolved open question (xsd:boolean)."@en .
+bw:promotes a rdf:Property ;
+    rdfs:label "promotes"@en ;
+    rdfs:comment "The finding an anchor promotes into a binding constraint."@en .
+bw:constrains a rdf:Property ;
+    rdfs:label "constrains"@en ;
+    rdfs:comment "The narrative entity (or timeline) an anchor constrains."@en .

bookwright/validation/__init__.py

@@ -0,0 +1,33 @@
+"""Validation subsystem: deterministic coherence checks + the ``validate`` command.
+
+The public surface a custom validator imports (``Severity``, ``Violation``) and the
+engine seam the command wires together (discovery, the runner, the report).
+"""
+
+from __future__ import annotations
+
+from bookwright.validation.base import (
+    Severity,
+    UnknownValidatorError,
+    ValidationContext,
+    Validator,
+    ValidatorError,
+    Violation,
+)
+from bookwright.validation.registry import discover_validators, resolve_active
+from bookwright.validation.report import ScopeFilter, ValidationReport
+from bookwright.validation.runner import run_validators
+
+__all__ = [
+    "ScopeFilter",
+    "Severity",
+    "UnknownValidatorError",
+    "ValidationContext",
+    "ValidationReport",
+    "Validator",
+    "ValidatorError",
+    "Violation",
+    "discover_validators",
+    "resolve_active",
+    "run_validators",
+]