From e2b05b4d7cab8e639c47b3573e2f78c137ab75b1 Mon Sep 17 00:00:00 2001 From: Jonathan Miller Date: Sat, 18 Jul 2026 14:51:56 -0500 Subject: [PATCH] docs(issue-templates): review and align MokoGIT issue templates Authored-by: Moko Consulting --- .mokogit/ISSUE_TEMPLATE/bug_report.md | 10 +++++----- .mokogit/ISSUE_TEMPLATE/config.yml | 4 ++-- .mokogit/ISSUE_TEMPLATE/mcp_connection_issue.md | 4 +++- .mokogit/ISSUE_TEMPLATE/mcp_tool_request.md | 5 +++-- .mokogit/ISSUE_TEMPLATE/question.md | 5 +++-- .mokogit/ISSUE_TEMPLATE/security.md | 2 +- .mokogit/ISSUE_TEMPLATE/version.md | 11 ++++++----- 7 files changed, 23 insertions(+), 18 deletions(-) diff --git a/.mokogit/ISSUE_TEMPLATE/bug_report.md b/.mokogit/ISSUE_TEMPLATE/bug_report.md index 38a16a7..a08ba76 100644 --- a/.mokogit/ISSUE_TEMPLATE/bug_report.md +++ b/.mokogit/ISSUE_TEMPLATE/bug_report.md @@ -27,11 +27,11 @@ A clear and concise description of what actually happened. If applicable, add screenshots to help explain your problem. ## Environment -- **Project**: [e.g., MokoDoliTools, moko-cassiopeia] -- **Version**: [e.g., 1.2.3] -- **Platform**: [e.g., Dolibarr 18.0, Joomla 5.0] -- **PHP Version**: [e.g., 8.1] -- **Database**: [e.g., MySQL 8.0, PostgreSQL 14] +- **Project**: [e.g., MokoDoliTools, moko-cassiopeia, an MCP server] +- **Version**: [e.g., 01.02.03] +- **Platform**: [e.g., Dolibarr 18.0, Joomla 5.0, Node.js 20.x] +- **Runtime Version** (if applicable): [e.g., PHP 8.1, Node.js 20.11] +- **Database** (if applicable): [e.g., MySQL 8.0, PostgreSQL 14] - **Browser** (if applicable): [e.g., Chrome 120, Firefox 121] - **OS**: [e.g., Ubuntu 22.04, Windows 11] diff --git a/.mokogit/ISSUE_TEMPLATE/config.yml b/.mokogit/ISSUE_TEMPLATE/config.yml index c52380c..ceff85a 100644 --- a/.mokogit/ISSUE_TEMPLATE/config.yml +++ b/.mokogit/ISSUE_TEMPLATE/config.yml @@ -14,5 +14,5 @@ contact_links: url: https://git.mokoconsulting.tech/MokoConsulting/.github-private/security/advisories/new about: Report security vulnerabilities privately (for critical issues) - name: 💡 Community Discussions - url: https://github.com/orgs/mokoconsulting-tech/discussions - about: Join community discussions and Q&A + url: https://git.mokoconsulting.tech/MokoConsulting + about: Join community discussions and Q&A on MokoGIT diff --git a/.mokogit/ISSUE_TEMPLATE/mcp_connection_issue.md b/.mokogit/ISSUE_TEMPLATE/mcp_connection_issue.md index e7031a8..5c9d3e2 100644 --- a/.mokogit/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/.mokogit/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -19,7 +19,8 @@ assignees: '' ### MCP Server - **Server Name**: [e.g., mcp_mokowaas] -- **Server Version**: [e.g., 1.0.0] +- **Server Version**: [e.g., 01.00.00] +- **Transport**: [stdio / http] - **Node.js Version**: [e.g., 20.x] ### Connection Details @@ -65,3 +66,4 @@ What should have happened. - **OS**: [e.g., macOS 14, Ubuntu 22.04, Windows 11] - **Claude Code Version**: [e.g., latest] - **Registration**: [.mcp.json / ~/.claude.json] +- **Invocation**: [e.g., `npx ` / `node dist/index.js`] diff --git a/.mokogit/ISSUE_TEMPLATE/mcp_tool_request.md b/.mokogit/ISSUE_TEMPLATE/mcp_tool_request.md index 2fe76d9..8544d35 100644 --- a/.mokogit/ISSUE_TEMPLATE/mcp_tool_request.md +++ b/.mokogit/ISSUE_TEMPLATE/mcp_tool_request.md @@ -10,7 +10,7 @@ assignees: '' ## Tool Request ### Tool Name -Proposed tool name (snake_case): `resource_action` +Proposed tool name (snake_case, `prefix_resource_action`): `prefix_resource_action` ### Description What should this tool do? What API endpoint(s) does it map to? @@ -46,4 +46,5 @@ Describe when and why someone would use this tool from Claude or another AI assi ### Checklist - [ ] I have checked this tool does not already exist - [ ] I have verified the API endpoint exists and is documented -- [ ] The proposed name follows the `resource_action` convention +- [ ] The proposed name follows the `prefix_resource_action` convention +- [ ] The tool spreads `...ConnectionParam` into its schema (and `...PaginationParams` for list tools) diff --git a/.mokogit/ISSUE_TEMPLATE/question.md b/.mokogit/ISSUE_TEMPLATE/question.md index 3175013..a001da0 100644 --- a/.mokogit/ISSUE_TEMPLATE/question.md +++ b/.mokogit/ISSUE_TEMPLATE/question.md @@ -2,8 +2,9 @@ name: Question about: Ask a question about usage, features, or best practices title: '[QUESTION] ' -labels: ['question'] -assignees: ['jmiller'] +labels: 'question' +assignees: '' + --- diff --git a/.mokogit/ISSUE_TEMPLATE/security.md b/.mokogit/ISSUE_TEMPLATE/security.md index 37a266d..043cdd4 100644 --- a/.mokogit/ISSUE_TEMPLATE/security.md +++ b/.mokogit/ISSUE_TEMPLATE/security.md @@ -11,7 +11,7 @@ assignees: '' ## ⚠️ IMPORTANT: Private Disclosure Required **For critical security vulnerabilities, DO NOT use this template.** -Follow the process in [SECURITY.md](../SECURITY.md) for responsible disclosure. +Follow the process in [SECURITY.md](../../SECURITY.md) for responsible disclosure, or [report a vulnerability privately on MokoGIT](https://git.mokoconsulting.tech/MokoConsulting/.github-private/security/advisories/new). Use this template only for: - Security improvements diff --git a/.mokogit/ISSUE_TEMPLATE/version.md b/.mokogit/ISSUE_TEMPLATE/version.md index 6328421..0ec55e6 100644 --- a/.mokogit/ISSUE_TEMPLATE/version.md +++ b/.mokogit/ISSUE_TEMPLATE/version.md @@ -2,14 +2,15 @@ name: Version Bump about: Request or track a version change title: '[VERSION] ' -labels: 'version, type: version' -assignees: 'jmiller' +labels: 'version' +assignees: '' + --- ## Version Change -**Current version**: -**Requested version**: +**Current version**: +**Requested version**: **Change type**: ## Reason @@ -20,5 +21,5 @@ assignees: 'jmiller' - [ ] README.md `VERSION:` field updated - [ ] CHANGELOG.md entry added -- [ ] Module descriptor version updated (Dolibarr: `$this->version`, Joomla: ``) +- [ ] Manifest/descriptor version updated (npm: `package.json` `"version"`; Dolibarr: `$this->version`; Joomla: ``) - [ ] All file headers will be auto-propagated by `sync-version-on-merge` workflow -- 2.52.0