Guard human-only Intent commands from agent execution
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 35/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Activo
- Stack tecnológico
- typescript
- Área
- cli, documentation, security, testing
Línea de trabajo
Empieza localizando el registro de comandos y el manejo existente de IntentAudience, agent y automation-context. Asigna cada comando listado a una clase explícita de efecto y autoridad, y después ejecuta o añade pruebas específicas que cubran la observación, la denegación de mutaciones, las excepciones de dry-run, la autorización de automation y la falta de autoridad de audience o pseudo-TTY; se considera terminado cuando todos los comandos registrados están clasificados y la matriz de aceptación pasa.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
IntentAudience controls presentation and redaction only. It is not authority. A TTY proves terminal interaction, not human identity. Current hooks are soft, fail-open convenience controls, not a security boundary. An agent with unrestricted shell and repository write access can bypass CLI guards or edit files directly. OS and host permissions remain the hard boundary.
Intent needs a command effect and authority classification that is separate from audience so an agent context cannot use presentation state or a pseudo-TTY to authorize trust or delivery changes.
Intent has no skill download command today. load reads an already installed permitted skill; it does not download content.
User outcome
Humans can keep existing confirmation-based trust and delivery workflows. Agents can inspect permitted Intent state and load already installed permitted skills. Automation can run its supported paths only through an explicit automation context. Audience never grants mutation authority.
In scope
- Introduce a command effect and authority classification separate from
IntentAudience:observe,trust-mutation,delivery-mutation,source-mutation, andautomation. - Classify these as agent-safe observation:
listandlist --jsonloadof an already installed permitted skillmetaexclude listvalidateandvalidate --checkstaleandstale --jsoninstall --dry-runinstall --map --dry-runinstall --print-promptscaffold
- Classify these as human-only trust or delivery mutations:
installwhen it writesintent.skillsor guidanceinstall --mapwhen it writes guidanceexclude addandexclude removehooks installsetupandsetup-github-actions- any future skill acquisition or download command, if introduced
- Classify
validate --fix,validate --set-version, andedit-package-jsonas source mutations governed by the caller's repository-write authority, not byIntentAudience. - Classify
validate --github-summaryand supported CI workflow paths as automation-only, with explicit CI identity and token permissions. - Require command implementations to declare their effect and authority class at registration or through one shared command policy.
- Deny an agent context before a human-only command can prompt, scan for selectors, write package policy, write guidance, install hooks, or install workflows.
- Preserve explicit automation paths without treating a TTY, an environment variable, or audience as authenticated human authority.
- Add focused tests for every command class, dry-run exception, mutation denial, automation allowance, and the rule that audience cannot grant authority.
Out of scope
- Cryptographic proof of human identity.
- A claim that Intent can contain an actor with unrestricted shell and repository write access.
- New dependencies or a new skill-content download command.
- Changes to the current Clack interactive permission setup work.
- Amendments to #220 or #228.
Acceptance criteria
- Every registered command action has an explicit effect and authority class.
- Agent execution can run only classified observation paths and can load only already installed permitted skills.
- Agent execution fails before any human-only trust or delivery mutation and before its related prompt or write path.
IntentAudience, TTY detection, host permissions, and CI identity have separate documented roles.- Existing supported automation paths remain usable only through an explicit automation context.
- Tests cover the command matrix and prove that changing audience or using a pseudo-TTY cannot grant human mutation authority.
- The documentation states that host permissions remain the security boundary for actors with unrestricted shell and repository write access.
Dependencies
Blocked by: None
#220 and #228 remain independent. This issue must not block or alter the current Clack work.
- Lenguaje dominante
- TypeScript
- Estrellas
- 331
- Forks
- 22
- Merge medio
- 12 h 17 min
- PR fusionados (30 d)
- 51
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de TanStack/intent
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 45/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 45/100
Todos los issues de TanStack/intent
Issues similares
-
blocklist removal
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
MetaMask/eth-phishing-detect#296544 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
pastelsky/bundlephobia#1122 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
-
category/development priority/P2 scope/file-operations scope/testing type/enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Enatega Customer and Rider app: Add-ons price is not visible to customer after order is placed. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100