Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Guard human-only Intent commands from agent execution

Abierto
#229 0 comentarios 0 reacciones 0 asignados Ver en GitHub

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

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

enhancement

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, and automation.
  • Classify these as agent-safe observation:
    • list and list --json
    • load of an already installed permitted skill
    • meta
    • exclude list
    • validate and validate --check
    • stale and stale --json
    • install --dry-run
    • install --map --dry-run
    • install --print-prompt
    • scaffold
  • Classify these as human-only trust or delivery mutations:
    • install when it writes intent.skills or guidance
    • install --map when it writes guidance
    • exclude add and exclude remove
    • hooks install
    • setup and setup-github-actions
    • any future skill acquisition or download command, if introduced
  • Classify validate --fix, validate --set-version, and edit-package-json as source mutations governed by the caller's repository-write authority, not by IntentAudience.
  • Classify validate --github-summary and 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

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de TanStack/intent

Todos los issues de TanStack/intent

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.