Skip to content

docs: add community health defaults and security policy - #4

Merged
BunsDev merged 1 commit into
mainfrom
docs/community-health-refresh
Oct 2, 2026
Merged

BunsDev merged 1 commit into
mainfrom
docs/community-health-refresh

Conversation

@BunsDev

@BunsDev BunsDev commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Summary

  • SECURITY.md (new): splits community-project issues from official TypeSafe AI API/account issues; private advisory in the affected repo, with jev-harness as fallback intake because private reporting is off in modex and community-blog. No response-time promises.
  • CODE_OF_CONDUCT.md, SUPPORT.md (new): Contributor Covenant 2.1 adaptation, and a community-versus-official support split (notes that the playground uses Discussions, not issues).
  • Issue forms + PR template (new): bug form asks mocked vs live mode; config links official support/docs; PR template has an evidence-type check.
  • CONTRIBUTING.md expanded; README, profile, AGENTS.md, llms.txt, and the discovery index now cross-link the new files. The unofficial notice is kept everywhere.

Verification

  • ruby -ryaml parses all three issue forms.
  • Official links (typesafe.ai, docs quick start, github.com/typesafe-ai, jev.works) return 200.
  • Private-reporting status checked per repo with gh api repos/TypeSafeAI/<repo>/private-vulnerability-reporting.
  • Commit is SSH-signed.

🤖 Generated with Claude Code

- add SECURITY.md with community-versus-official routing and a private
  fallback intake (modex and community-blog have private reporting off)
- add CODE_OF_CONDUCT.md, SUPPORT.md, default issue forms with official
  support contact links, and a PR template with a mocked/live evidence check
- expand CONTRIBUTING.md with workflow, evidence, and agent-assisted rules
- cross-link the new files from README, profile, AGENTS.md, llms.txt, and
  the discovery index

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 1, 2026 18:00

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The conduct policy lacks an actionable private reporting channel, and the bug form prevents the requested screenshot attachments.

Review effort: Balanced
Findings: 1 High severity · 2 Low severity

Open (3)
What changed in this PR

Adds organization-wide community health defaults, contributor guidance, and cross-links while preserving the community/official support boundary.

Changes:

  • Adds conduct, security, support, issue, and pull-request templates.
  • Expands contribution and verification guidance.
  • Links the policies throughout repository navigation.
File Description
AGENTS.md Documents requirements for community defaults.
CODE_OF_CONDUCT.md Adds conduct and enforcement policy.
CONTRIBUTING.md Expands contribution and safety guidance.
ISSUE_TEMPLATE/​bug_report.yml Adds structured bug reporting.
ISSUE_TEMPLATE/​config.yml Adds support and security links.
ISSUE_TEMPLATE/​feature_request.yml Adds feature proposal form.
PULL_REQUEST_TEMPLATE.md Adds evidence and safety checklist.
README.md Documents organization defaults.
SECURITY.md Defines private vulnerability reporting.
SUPPORT.md Separates community and official support.
docs/​discovery/​README.md Documents inherited health files.
llms.txt Adds policy navigation links.
profile/​README.md Surfaces support and security policies.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread CODE_OF_CONDUCT.md

## Reporting

Report conduct concerns privately to the organization moderator, [@BunsDev](https://github.com/BunsDev), or to a maintainer of the affected repository through a private channel you have already verified. You can also use GitHub's [report content](https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam) tools. Do not post sensitive evidence publicly.
id: mode
attributes:
label: Mode
description: Was this against mocked/demo data or a live TypeSafe API call?
Comment on lines +47 to +52
- type: textarea
id: logs
attributes:
label: Logs, output, or screenshots
description: Redact keys and personal data.
render: shell
@BunsDev
BunsDev merged commit 41c8c9b into main Oct 2, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants