@kansodata/kansodata-jira-plugin

Plugin OpenClaw para Jira Cloud en modo read-only (v1), con skill operativa separada kansodata-jira-ops.

Alcance v1 (incluido)

• get_issue(issueKey)
• search_issues(jql, maxResults, fields)
• get_issue_comments(issueKey)
• get_issue_worklogs(issueKey)
• get_project(projectKey)
• list_projects()
• list_issue_types(projectKey?)
• list_statuses(projectKey?)
• list_transitions(issueKey)

Fuera de alcance v1

• Crear/editar/comentar/transicionar/asignar issues.
• Jira Data Center.
• OAuth complejo.
• Operaciones destructivas o masivas.

Seguridad y hardening

• Validación estricta de inputs con Zod.
• Cliente HTTP encapsulado.
• Auth centralizada por Basic Auth (email:apiToken).
• Timeouts configurables.
• Errores tipados.
• Sanitización de mensajes de error.
• Truncado de respuestas grandes.
• Paginación controlada (maxResults acotado).
• READ_ONLY=true por defecto.

Variables de entorno

• JIRA_BASE_URL (ej. https://empresa.atlassian.net)
• JIRA_EMAIL
• JIRA_API_TOKEN
• READ_ONLY (default: true)
• JIRA_TIMEOUT_MS (default: 10000)
• JIRA_MAX_RESULTS (default: 50, máximo 100)
• JIRA_MAX_RESPONSE_CHARS (default: 12000)

Instalación local

1. Instalar dependencias:

npm install

2. Preparar entorno:

cp .env.example .env

3. Compilar:

npm run build

4. Referenciar el plugin en tu instalación OpenClaw usando openclaw.plugin.json y dist/openclawEntry.js.

Validación local

npm run check:versions
npm run lint
npm run typecheck
npm run build
npm run test
npm pack

Empaquetado y publicación

1. Generar paquete:

npm pack

2. Verificar contenido del .tgz y consistencia de versión (package.json, openclaw.plugin.json, src/pluginMetadata.ts):

npm run check:versions

3. Publicar manualmente (solo con revisión humana previa):

npm publish --access public

4. Para ClawHub, usar el paquete npm publicado (scope @kansodata) o el .tgz validado según el flujo manual de publicación de plugins en tu entorno.

Rollback operativo sugerido

• Si falla validación: no publicar y revertir cambios locales.
• Si un release local causa regresión: desinstalar versión nueva e instalar último .tgz estable.
• Mantener READ_ONLY=true mientras no existan tools de escritura aprobadas.

Criterios de aceptación v1

• Plugin compila y registra las 9 tools read-only.
• Validaciones locales exitosas: install, lint, typecheck, build, test, pack.
• Skill kansodata-jira-ops disponible y consistente con modo solo lectura.
• No existen endpoints de escritura en el código fuente.