qbarev/para-plugin

Bandeja de entrada (Inbox)

El búfer de captura del vault es la bandeja de entrada del backend de tareas, no una carpeta; paths.md posee esa regla y define para qué sirve Inbox/ en el disco. Una captura abandona el búfer hacia una carpeta PARA adecuada una vez que está claro qué es, o permanece en el backend si es solo una acción.

Bajo TASKS = files, la bandeja de entrada es la carpeta Inbox/ (paths.md dice lo que eso significa, incluidos los archivos sueltos); los pasos siguientes son iguales excepto el manejo de archivos sueltos.

Cada llamada de tarea es una operación de tasks.md, ejecutada según el adaptador para TASKS. Si el backend no está disponible, se aplica «Backend ausente» de tasks.md.

Capa base

Lee antes de actuar, cada una como ../../para/<archivo>.md relativa al directorio base de esta habilidad: contienen las reglas compartidas, no las repitas de memoria:

• ../../para/paths.md — siempre, incluido «Idioma»: las cadenas siguientes provienen de lang/<IDIOMA>.md
• ../../para/tasks.md — siempre: las operaciones; para process también qué es una tarea, áreas, proyectos
• ../../para/note-format.md — para process
• ../../para/confirm.md — para process
• ../../para/move.md — para process, cuando enruta un archivo suelto fuera de Inbox/

Subcomandos

La primera palabra de $ARGUMENTS elige el subcomando. Cualquier cosa que no sea list o process se trata como el texto de un add, así que /inbox un pensamiento sobre dormir captura ese pensamiento; la palabra clave add es opcional. $ARGUMENTS vacío → muestra los tres subcomandos y pregunta.

---

add <texto> — capturar

1. inbox.add con un title y un description opcional. Un texto corto es el título tal cual. Uno largo recibe un título corto en IDIOMA derivado de él (6 palabras o menos) y el texto completo como descripción.
2. No establecer nada más — sin fecha, prioridad ni etiquetas a menos que el usuario lo haya dicho explícitamente. Esto es un búfer, no un lugar para ordenar el pensamiento del usuario.
3. Informar en una línea qué se creó, para que el usuario pueda renombrar si no está de acuerdo.

Si la captura obviamente pertenece a algún lugar específico, indícalo en el informe y ofrece /inbox process; no la enrutes sin que te lo pidan.

---

list — mostrar lo que está sin procesar

Solo lectura.

1. inbox.list — cada captura abierta.
2. Imprime una lista numerada, la más antigua primero, encabezada con la cadena inbox.header ({n} capturas, {days} la antigüedad de la más antigua). Solo títulos, sin descripciones.
3. Archivos sueltos. No bajo TASKS = files (paths.md). Lista los *.md en Inbox/ (solo nombres de archivo, no los abras). Si existen, añade una línea, la cadena inbox.strays ({k} archivos).
4. Una bandeja de entrada vacía es una respuesta válida y buena: dilo claramente.

---

process — enrutar las capturas

La válvula del búfer. Interactivo, una captura a la vez — nunca vacíes toda la bandeja de entrada con destinos propuestos y pidas al usuario que apruebe en bloque.

1. Lista la bandeja de entrada como arriba — primero las capturas del backend (las más antiguas primero), luego los archivos sueltos de Inbox/ (bajo TASKS = files, inbox.list los incluye todos, paths.md). Di cuántas hay y empieza por la primera.

2. Para cada captura: muestra el título y el contenido (la descripción, o el cuerpo del archivo para un suelto) — brevemente si es largo. Luego da tu interpretación de qué es y ofrece las rutas. Los nombres de las rutas son las cadenas inbox.route.* de lang/<IDIOMA>.md; la columna izquierda siguiente es la clave:

   Ruta	Qué ocurre
   inbox.route.action	una tarea fuera de cualquier proyecto → la redacción se revisa según tasks.md «Qué es una tarea» y se propone y acuerda una redacción primero, luego task.move con el area que elija el usuario (los nombres son los que tasks.md da para area) y el title acordado
   inbox.route.project_task	un paso de un proyecto existente → el proyecto se encuentra según find-target.md, la redacción se propone según tasks.md «Qué es una tarea», luego task.move con ese project_ref y el nuevo title; la tarea permanece abierta, no se crea ni cierra nada. Bajo TASKS = files, un nombre base ya tomado es una colisión: note-format.md «Colisiones de nombres»
   inbox.route.project	un esfuerzo con un estado final → derivar a /projects create
   inbox.route.area	responsabilidad continua → /areas create, o añadir a un Área existente
   inbox.route.resource	conocimiento que vale la pena conservar → /resources create
   inbox.route.keep	no está maduro aún — se queda en la bandeja de entrada, no hay vergüenza en ello
   inbox.route.delete	basura → cerrarlo (ver abajo)

   Recomienda una, con una razón en una frase. El usuario decide.

3. Ejecuta la ruta, pasando el texto de la captura a la habilidad que posee el destino — ella construye la nota a partir de su propia plantilla. Nunca escribas una nota aquí.

4. Cierra la captura una vez que su ruta se haya ejecutado:

   • Captura del backend — enrutada al vault, o basura → inbox.close — reversible (tasks.md), por lo tanto Nivel 1 (confirm.md). inbox.route.action e inbox.route.project_task mueven la tarea en sí (task.move) y la dejan abierta; inbox.route.keep la deja donde está.
   • Archivo suelto en Inbox/ — después de que /projects create, /areas create o /resources create hayan tomado su contenido, elimina el archivo mediante /remove; para inbox.route.delete, pásalo directamente a /remove. inbox.route.action lo convierte en una tarea con task.add y area, luego elimina el archivo de la misma manera.

5. Luego pasa a la siguiente captura. No agrupes los cierres al final.

6. Detente cuando el usuario diga stop, e informa cuántas se procesaron y cuántas quedan. Vaciar toda la bandeja de entrada en una sola sesión no es el objetivo.

Notas

• La bandeja de entrada es deliberadamente de baja fricción: add nunca hace una pregunta que pueda evitar. process es donde ocurre el pensamiento.
• Todo en IDIOMA, tareas incluidas.