trust (reviewed = Knowledge, la fuente de verdad del equipo; proposed / draft = una Nota, una pista), para que un cliente pueda basarse en trust === "reviewed" directamente.
Recuperación y lectura
Empieza condriftless_context_retrieve cuando tienes una tarea pero no un slug. Los cuerpos vuelven brief por defecto (el porqué durable, no el content completo); trae un cuerpo completo con driftless_context_get.
| Tool | Propósito | Params principales | Devuelve |
|---|---|---|---|
driftless_context_retrieve | Contexto ordenado, con lo drifteado primero, para una tarea y/o archivos | task, files, view, limit | { shown, has_more, next_action, results[] } |
driftless_context_search | Búsqueda de texto completo, ordenada por relevancia | query, tags, stale, limit | 5 primeros summaries, has_more |
driftless_context_list | Lista topics, drifteados primero | status, stale, tags, limit | 40 primeros summaries |
driftless_context_get | Un topic por slug (cuerpo completo) | topic, view | el topic completo |
driftless_context_get_for_files | Empareja topics con rutas de archivo | files, view, limit | 10 primeros, brief |
context:read. Disponibilidad: Available.
Escritura y edición
| Tool | Propósito | Params principales | Notas |
|---|---|---|---|
driftless_context_create | Crea un topic (por defecto queda En revisión) | title, content, pattern, rels | devuelve anchor_validation |
driftless_note_add | Captura una Nota privada (se queda en draft) | content, project_id, card_id | nunca se envía sola |
driftless_context_update | Update seguro para append | topic, fields, rels | devuelve anchor_validation |
driftless_context_delete | Elimina un topic (destructivo) | topic | irreversible |
driftless_context_merge | Funde un duplicado en su superviviente | source, into | archiva el origen |
driftless_context_share | Publica una página pública y/o comparte con members | topic, to_web, with_members | compartir, no mergear |
topics:create / topics:write; work:write para merge y share. Disponibilidad: Available. Las respuestas de escritura llevan anchor_validation (ok / overbroad / zero), que nunca bloquea la escritura.
Grafo y salud
| Tool | Propósito | Params principales | Devuelve |
|---|---|---|---|
driftless_context_relations | Las relaciones tipadas de un topic | topic | entrantes + salientes |
driftless_context_graph | Grafo local de relaciones | topic, depth | nodos + aristas |
driftless_context_doctor | Audita la capa de contexto | (ninguno) | stale / zombie / orphaned / draft |
driftless_context_coverage | Áreas de código sin topic | (ninguno) | los huecos de cobertura |
driftless_context_events | Actividad reciente de un topic | topic | el stream de eventos |
context:read. Disponibilidad: Available.
Registros: tags y areas
| Tool | Actions | Propósito |
|---|---|---|
driftless_tags | list, create, delete | El registro de tags (conteos por tag; curación) |
driftless_areas | list, create, update, delete | El registro de areas (los dominios bajo los que se archivan los topics) |
list es de nivel member; create / update / delete requieren work:write. Disponibilidad: Available.
Gobernanza
Un topic se vuelve Knowledge solo cuando un owner o admin lo integra. Un cliente MCP siempre propone; puede integrar solo con autoridad de owner/admin, y solo cuando la persona que autoriza lo pide de forma explícita.| Tool | Propósito | Params principales | Permiso |
|---|---|---|---|
driftless_context_propose | Pone una Nota en revisión (draft → proposed) | topic | work:write |
driftless_context_approve | Integra en Knowledge (proposed → reviewed) | topic | owner/admin, solo cuando lo piden |
driftless_context_create_proposal | Abre una Edición sugerida a Knowledge existente | topic, summary, content | work:write |
driftless_context_proposals | Lista las Notas en revisión (la cola de revisión) | (ninguno) | member |
Permisos
| Scope | Cubre |
|---|---|
context:read | Leer topics, retrieve, search, list, graph, doctor, coverage, events |
topics:create | Crear topics |
topics:write | Actualizar topics existentes |
work:write | Curación de tags/areas, merge, share, propose y Ediciones sugeridas |
context:diff | Leer el diff de topics para cambios locales |
Relacionado
- Topics, Gobernanza, Drift - los conceptos.
- Govern agent learning, Clean workspace context - los workflows.
- CLI: Context Commands - la misma superficie desde la terminal.
- MCP & OAuth - setup, auth y scopes.