Proyectos

Espacios de trabajo de proyecto en Memory Console

Los Project Workspaces proporcionan límites contextuales estructurados para agrupar recuerdos, rastrear decisiones operativas y administrar tareas activas entre sesiones de clientes. En la Memory Console en https://xmemo.dev/me#projects, la sección de navegación de espacios de trabajo aloja el panel Projects, diseñado para "Browse project workspaces, context, and project memories."

• Métricas del espacio de trabajo: La consola muestra estadísticas de nivel superior en todos sus espacios de trabajo, incluidos Total Projects, Active, Attention Needed y Archived.
• Aprovisionamiento de espacios de trabajo: Al seleccionar Create New Project se abre un modal guiado que requiere un Project Name ("Required, 1-128 characters."). La interfaz representa una vista previa en tiempo real del identificador de proyecto ("Non-authoritative preview. The backend server assigns the authoritative project key.") y acepta una Description opcional de hasta 2000 caracteres.
• Límite personal: Los proyectos son solo personales por el momento. El servicio backend rechaza la creación de espacios de trabajo con team_id (HTTP 400). La documentación no promete soporte para proyectos de equipo.
• Sin límites numéricos: Los espacios de trabajo de proyectos no tienen cuotas de plan numéricas ni límites artificiales de creación. Las cuentas aprovisionan espacios de trabajo en función de las necesidades de flujo de trabajo en lugar de cuotas de plan.

Asociaciones de memoria, estados de ciclo de vida y eliminación no destructiva

Las memorias se asignan a un proyecto para proporcionar un contexto con alcance para los agentes conectados y la revisión del panel. La vista de detalles del proyecto agrega métricas de salud del proyecto y proporciona una inspección detallada de los registros vinculados:

• Estadísticas destacadas del proyecto: Cada barra destacada del espacio de trabajo resalta agregados en tiempo real para Memories:, Open TODOs: y Decisions:.
• Filtrado por ciclo de vida de la memoria: El explorador de memoria clasifica los registros por estado de ciclo de vida: Active, Superseded, Expired y Archived.
• Desvinculación no destructiva: Eliminar un registro de memoria de un espacio de trabajo de proyecto desvincula la asociación sin destruir la memoria subyacente. El cuadro de diálogo de confirmación afirma: "This memory will be disassociated from this project workspace. The memory content remains in your personal memory archive, but will no longer appear in this project context."
• Aislamiento de diagnóstico: Los elementos con referencias canónicas faltantes o conflictos de espacio de nombres se ponen en cuarentena bajo Diagnostic Isolated Items con la insignia Unindexed - Troubleshooting Only, evitando que el contexto corrupto se filtre al recall del agente.

Particiones de Knowledge frente a Working y vista Attention Needed

Los espacios de trabajo de proyecto admiten la partición contextual de la memoria si está habilitada para su cuenta (el modo de evaluación de convergencia está desactivado de forma predeterminada):

• Partición de Knowledge: Contiene datos de referencia duraderos, decisiones arquitectónicas a largo plazo y convenciones de proyecto destinadas a un recall persistente.
• Partición de Working memory: Contiene el estado de tareas transitorias, sesiones de trabajo en curso y contexto de borrador que se pueden retirar tras completar un hito.
• Vista Attention Needed: Destaca candidatos no asignados, presuntos duplicados o registros pendientes de atribución cuando la curación particionada está activa para su cuenta.
• Diferencia con las Knowledge Bases: Una partición de Knowledge de proyecto clasifica la memoria conversacional episódica dentro del límite de un proyecto. Por el contrario, una Knowledge Base proporciona documentos de referencia seleccionados con múltiples revisiones administrados mediante almacenamiento independiente. Para obtener documentación seleccionada, consulte la guía de conceptos de Knowledge Bases en /docs/concepts/knowledge-bases.

Un proyecto combina un scope con una convención de path

Para el alcance básico de la memoria, XMemo no requiere un objeto de proyecto independiente: un proyecto se expresa mediante el scope bajo el cual se escribe una memoria y el espacio de nombres de ruta lógica dentro de él, por lo que una misma cuenta puede contener muchos proyectos sin contaminación cruzada. Sobre ese límite de memoria, Project Workspaces superpone el estado estructurado del proyecto (API de proyecto, seguimiento de TODO y decisiones registradas) para la colaboración entre clientes.

• Escriba los hechos del proyecto en una ruta estable como projects/<name>/decisions.
• Pase el scope del proyecto tanto en la escritura como en la lectura para que la recuperación se mantenga delimitada.
• Project Workspaces superpone el estado estructurado del proyecto (incluidas las API de proyecto, los TODO duraderos y las decisiones registradas) sobre el límite de memoria subyacente.
• Los proyectos siguen siendo solo personales hoy en día; los espacios de trabajo de proyecto con alcance de equipo son rechazados por la API.

Escribir una decisión de proyecto

Adjunte el registro a la ruta y al scope del proyecto en el momento de la escritura; no es necesario configurar nada más primero.

await client.recordDecision(
  "Remote agents should use network MCP, not SSH stdio",
  { source: "codex", scope: "memory-os" },
);

Continuar un proyecto en otro cliente

Un segundo cliente invoca el mismo scope y recupera el contexto del proyecto sin que el usuario tenga que volver a explicarlo.

const context = await client.recallContext("recent agent integration progress", {
  scope: "memory-os",
  maxItems: 6,
  maxTokens: 1200,
});

Herramientas de agente y acceso al perfil de cliente

Los agentes autorizados interactúan con los proyectos a través de herramientas definidas en config/mcp-documentation-contract.json en perfiles de cliente específicos:

• chatgpt-public, generic-public y public-only: Exponen project, get_project_summary y open_project_workspace.
• claude-plugin: Expone project y get_project_context.
• cursor-plugin y ordinary-full: Exponen get_project_context, update_project_todo y update_project_decision.
• Distinción del widget en el chat: El widget de ChatGPT Project Workspace abierto a través de open_project_workspace es una interfaz de tarjeta interactiva dentro del chat; es distinto de la Memory Console completa basada en web en https://xmemo.dev/me#projects.