Positioning Bridge

Positioning Bridge comprueba si un borrador transmite los mensajes correctos de la empresa para su audiencia, canal, etapa del embudo, locale y campaña.

Una empresa mantiene un único paquete de posicionamiento versionado. Los redactores usan la misma política a través de una CLI, un host de MCP o una biblioteca de TypeScript. Cada resultado indica exactamente el pilar, la afirmación, la regla, la campaña, el competidor y la fuente que lo han provocado.

qué comprueba

La decisión es pass, needs_revision o blocked. No hay una pNtación cine fuer global. La evidencia determinista y la asistida pon el modelo se mantiene etiquetado por separado.

Related MCP server: MCP Gatekeeper

ejecutar el ejemplo

Requisitos: Node.js 22 or newer.

git clone https://github.com/shashank-sn/positioning-bridge.git
cd positioning-bridge
npm ci
npm run build
node dist/cli/main.js validate --pack examples/acme/positioning.yaml

comprueba el borrador ficticio que pasa:

node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --content examples/acme/drafts/pass.md \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --campaign campaign.launch

comprueba desde la entrada estándar y conserva el resultado estructurado:

printf '%s\n' 'Acme trains on customer content.' | node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --stdin \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --json

el comando termina con 0 para pass, 1 para needs_revision o blocked, y 2 para un error de uso o configuración. Si se omite el locale, se usa el defaultLocale del paquete.

crea un paquete inicial sin sobrescribir un archivo existente:

node dist/cli/main.js init --output company-positioning.yaml

El proyecto es de código abierto en GitHub bajo la licencia MIT. positioning-bridge aún no se ha publicado en npm, así que usa el flujo de clonación anterior para 0.1.0.

conectar un host de MCP

Compila el repositorio y luego indica al host las rutas absolutas del paquete y del ejecutable:

{
  "mcpServers": {
    "positioning-bridge": {
      "command": "node",
      "args": [
        "/absolute/path/to/positioning-bridge/dist/cli/main.js",
        "serve",
        "--pack",
        "/absolute/path/to/company-positioning.yaml"
      ]
    }
  }
}

El servidor carga un paquete al iniciarse y expone cuatro herramientas de solo lectura:

• get_positioning_context devuelve la política aplicable y las razones estructuradas;

• create_content_brief devuelve la política de contenido requerido, aprobado, prohibido y de divulgación;

• check_content devuelve la decisión, la cobertura, las capacidades y los hallazgos tipados;

• explain_positioning_item acepta un ID de política o de hallazgo emitido, junto con contexto.

Reinicia el proceso después de modificar el paquete. La guía de MCP contiene las entradas y salidas de las herramientas, el comando de Codex y la secuencia del redactor.

paquete de posicionamiento

un paquete contiene:

• catálogos de contexto para audiencias, canales, etapas del embudo y locales;

• fuentes de evidencia con estado de aprobación, visibilidad, verificación y expiración;

• pilares y afirmaciones aprobadas, sujetas a revisión o prohibidas;

• competidores nombrados y aplicación de la política para comparaciones no registradas;

• narrativas de campaña, acciones deseadas, mensajes requeridos y exclusiones;

• reglas deterministas de contradicción, divulgación y campaña.

Los IDs son estables y toda referencia se valida antes de que el servidor se inicie. Consulta la referencia del paquete, el JSON Schema generado y el paquete ficticio completo de Acme.

límite de certeza y seguridad

Las contradicciones confirmadas provienen de reglas determinísticas explícitas. Un SemanticReviewer opcional puede informar de paráfrasis y conflictos contextuales. Estos hallazgos se mantienen como model_assisted, por defecto requieren revisión humana y no pueden bloquear por sí solos.

Comportamiento por defecto en tiempo de ejecución:

• no hace ninguna solicitud de red;

• no almacena ningún borrador enviado;

• solo carga la ruta del paquete configurada;

• limita el tamaño del paquete y del borrador;

• no expone ninguna herramienta de mutación de políticas ni de publicación.

Positioning Bridge comprueba la política suministrada y el estado de evidencia suministrado. No prueba un hecho externo, la aprobación legal, el permiso del cliente ni la autenticidad de una fuente.

uso con Hold Your Voice

Positioning Bridge y Hold Your Voice siguen siendo puertas de entrada separadas. Positioning Bridge comprueba la política de mensajes y la evidencia. HYV comprueba los patrones de voz y lingüísticos. Ninguno de los dos paquete importa el otro, y ningún resultado constituye una aprobación de publicación.

biblioteca TypeScript

import { PositioningService, loadPack } from "positioning-bridge";

const pack = await loadPack("./company-positioning.yaml");
const service = new PositioningService(pack);
const result = await service.checkContent({
  content: "draft text",
  context: {
    audienceId: "primary-buyer",
    channelId: "website",
    funnelStageId: "consideration",
    localeId: "en",
  },
});

La construcción de MCP se exporta desde positioning-bridge/mcp. El JSON Schema se exporta desde positioning-bridge/schema.

desarrollo y verificación

npm ci
npm run verify
npm run smoke:package

npm run verify comprueba formato, linting, tipos estrictos, pruebas y cobertura, derivación del esquema, directión de la arquitectura, enlases de documentción, build de produción y handshake en vivo de stdio. npm run smoke:package empaqueta la versión exacta, comprueba su permmitlist y enlaces de Markdown, lo insta en un proyecto temporal limpio y luego comprueba su binario, su imagen de biblioteca y hook de ejemplo y el handshake de MCP.

Los límites de los componentes están en architecture.md y en la política de arquitectura. Las operaciones de publicación están en operations.md.

estado del proyecto

0.1.0 bildet la base principlal local-first. Ese base no incluye empaño un plano de control gestionado, interfaz web, proveedor de modelos remoto, rastreador de CMS, flujo de trabajo de null ni análisis de rendimiento. ReSos límit se documentan en ADR 0001.

Lee CONTRIBUTING.md antes de proponer un cambio. Usa GitHub Issues para bugs reproducibles and solicities de funcionalidad acotadas. Con uns solvedes Use GitHub Discussions for setup and diseño design questions. Reporta vulnerabilities through the private route en SECURITY.md.

Con licencia MIT. Ver LICENSE.