From 8a49daeab577091e865f5a6a59f4ac6af968234f Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 18:42:52 +0100 Subject: [PATCH 1/9] chore: add bug report issue template --- .github/ISSUE_TEMPLATE/bug_report.yml | 66 +++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..3000b26 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,66 @@ +name: Bug report +description: Something broke or behaved in a way you didn't expect +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + Thanks for reporting. A rough description and the command you ran is plenty — we can dig from there. + - type: textarea + id: what-happened + attributes: + label: What happened + description: What did you expect to happen, and what happened instead? + validations: + required: true + - type: textarea + id: command + attributes: + label: Command you ran + description: The exact command(s), if there was one. + render: shell + validations: + required: false + - type: input + id: tycoon-version + attributes: + label: tycoon version + description: Output of `tycoon --version` + placeholder: "0.1.9" + validations: + required: true + - type: input + id: python-version + attributes: + label: Python version + placeholder: "3.12" + validations: + required: true + - type: dropdown + id: os + attributes: + label: Operating system + options: + - macOS + - Linux + - Windows (WSL) + - Windows (native) + - Other + validations: + required: true + - type: textarea + id: stack + attributes: + label: Stack config + description: The `stack:` block from your `tycoon.yml`, if relevant (ingestion / warehouse / bi / orchestrator). + render: yaml + validations: + required: false + - type: textarea + id: logs + attributes: + label: Logs or error output + description: Paste any error output. It will be formatted as code. + render: shell + validations: + required: false From 8ab4e1cdef163e39454c194eea3caf736874cc2c Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 18:50:57 +0100 Subject: [PATCH 2/9] chore: add feature request issue template Added a feature request template for GitHub issues with fields for problem description, proposed solution, affected area, and alternatives considered. --- .github/ISSUE_TEMPLATE/feature_request.yml | 39 ++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..340d7b5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,39 @@ +name: Feature request +description: Suggest an idea or improvement +labels: ["enhancement"] +body: + - type: textarea + id: problem + attributes: + label: What's the problem? + description: What are you trying to do, and where does tycoon get in the way today? + validations: + required: true + - type: textarea + id: solution + attributes: + label: What would you like to see? + description: A rough idea is fine — no need for a full design. + validations: + required: true + - type: dropdown + id: area + attributes: + label: Which part of tycoon? + options: + - "tycoon init (scaffolding / stack config)" + - "data sources (ingestion / dlt)" + - "data transform (dbt)" + - "data analyze (Rill / dashboards)" + - "data history / status (observability)" + - "ask (Nao / natural language)" + - "Not sure / other" + validations: + required: false + - type: textarea + id: alternatives + attributes: + label: Anything you've tried or considered? + description: Workarounds, other tools, alternatives you weighed. Optional. + validations: + required: false From 16e50065f6fcb3d182521b5a5f3a803cf37afd75 Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 18:53:55 +0100 Subject: [PATCH 3/9] chore: add issue template configuration for discussions --- .github/ISSUE_TEMPLATE/config.yml | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/config.yml diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..d6b68c9 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Questions & discussion + url: https://github.com/Database-Tycoon/tycoon-cli/discussions + about: Have a question, want setup help, or want to share what you're building? Start a discussion — we read every post. From 143c81ed13d34fb8156370404f56e893b3515b05 Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 19:00:16 +0100 Subject: [PATCH 4/9] chore: create pull request template for contributions Added a pull request template to guide contributors. --- .github/PULL_REQUEST_TEMPLATE.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..4df9c6c --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,29 @@ + + +## What this does + + + +## Linked issue + +Closes # + +## Type of change + +- [ ] Bug fix +- [ ] New feature +- [ ] Docs +- [ ] Refactor / internal +- [ ] Other: + +## Checklist + +- [ ] `pre-commit run --all-files` passes +- [ ] Tests pass locally, and the offline `csv-import` pipeline still runs end to end (this is the CI gate — if it breaks, the release is blocked) +- [ ] Added or updated tests where it made sense +- [ ] Updated `CHANGELOG.md` if this is user-facing +- [ ] Updated docs / README if behavior or commands changed + +## Notes for reviewers + + From c526a6476b1715dd5a8a421c50a0a308cf1a313c Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 19:27:00 +0100 Subject: [PATCH 5/9] chore: create code of conduct --- CODE_OF_CONDUCT.md | 77 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 CODE_OF_CONDUCT.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..1714306 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,77 @@ +# Code of Conduct + +Database Tycoon is a small team, and this is a public project. It only works +if people feel comfortable showing up: asking a basic question, filing a rough bug, +disagreeing about a design. This document is the short version of how we keep it +that way. It applies to everyone who shows up in an issue, a pull request, or a discussion. + +## What we expect + +Assume the person on the other end is smart and acting in good faith, even when +they're new, even when they're wrong. Be direct about the work without being +sharp with the person. Concretely, that means: + +* Give feedback on the code, the idea, or the decision — not the human. +* Take disagreement as normal. Explain your reasoning; accept that someone + might explain theirs back. +* When you're wrong, say so and move on. Nobody here is keeping score. +* Make room for people who know less than you do. You were there once. + +## What we won't accept + +* Harassment of any kind, public or private. +* Sexualized language, imagery, or attention. +* Personal, political, or identity-based attacks — insults or dismissiveness + aimed at who someone is rather than what they said. +* Trolling, deliberate derailing, or sustained disruption. +* Publishing someone's private information without their explicit permission. +* Anything else that a reasonable person would read as harassment in a + professional setting. + +This applies regardless of age, body size, visible or invisible disability, +ethnicity, sex characteristics, gender identity and expression, level of +experience, education, socio-economic status, nationality, personal appearance, +race, caste, color, religion, or sexual orientation. + +## Where this applies + +Everywhere the project lives — issues, pull requests, discussions, commit +history — and anywhere someone is representing the project in public, like an +official account or an event. + +## Reporting + +If something crosses a line, tell us. Email info@databasetycoon.com +with what happened. You don't need to have it +perfectly documented; a rough account and we'll take it from there. + +We'll look into every report promptly and fairly, and we'll keep the reporter's +identity private. Reporting something in good faith will never count against +you, full stop. + +## What happens after a report + +Maintainers are responsible for enforcing this, and we'll match the response to +what actually happened: + +1. **A quiet word.** For a one-off — language or behavior that was out of line + but not serious — a private note explaining what was wrong and why. Sometimes + with a request to apologize. +2. **A warning.** For a clearer violation or a repeat: a warning, plus a period + of no interaction with the people involved, across project spaces and + outside them. Ignoring that leads to a ban. +3. **A temporary ban.** For a serious violation or sustained bad behavior: time + away from all project interaction. Breaking the terms of the ban makes it + permanent. +4. **A permanent ban.** For a pattern of violations, harassment of an + individual, or hostility toward a group. + +We'll explain our reasoning when it makes sense to, and we'll act consistently +whether the person involved is a first-time contributor or a maintainer. + +## Attribution + +Adapted from the [Contributor Covenant](https://www.contributor-covenant.org), +version 2.1. The enforcement tiers draw on Mozilla's code of conduct +enforcement ladder. For common questions, see the Contributor Covenant +[FAQ](https://www.contributor-covenant.org/faq). From ff7cc063962bb96414806da4f330e40fa4796a5b Mon Sep 17 00:00:00 2001 From: Karli Date: Fri, 10 Jul 2026 19:33:31 +0100 Subject: [PATCH 6/9] chore: add contributing guidelines to README Added a contributing section to encourage community involvement. (at the bottom) --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 17fb76c..da562e4 100644 --- a/README.md +++ b/README.md @@ -238,3 +238,14 @@ tycoon ask context --schema mart # all tables in a schema tycoon ask context --rules-only # just RULES.md tycoon ask context # list available tables ``` + +## Contributing + +tycoon is open source and still early, which means feedback right now has an +outsized effect on where it goes. However you want to jump in: + +- **Hit a bug or want a feature?** Open an [issue](https://github.com/Database-Tycoon/tycoon-cli/issues) — there's a short form for each. +- **Got a question, or want to show what you're building?** Start a [discussion](https://github.com/Database-Tycoon/tycoon-cli/discussions). Nothing's too small. +- **Want to work on the code?** [CONTRIBUTING.md](CONTRIBUTING.md) covers dev setup, what CI expects, and the repo conventions. + +Everyone taking part is expected to follow our [Code of Conduct](CODE_OF_CONDUCT.md). From 3b1bb6c7d31f13ea189676e0e58c5a4c07465566 Mon Sep 17 00:00:00 2001 From: "Stephen (DB Tycoon)" Date: Mon, 20 Jul 2026 16:21:01 -0400 Subject: [PATCH 7/9] Update CODE_OF_CONDUCT.md --- CODE_OF_CONDUCT.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 1714306..0df92f1 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -41,9 +41,9 @@ official account or an event. ## Reporting -If something crosses a line, tell us. Email info@databasetycoon.com -with what happened. You don't need to have it -perfectly documented; a rough account and we'll take it from there. +If something crosses a line, tell us. Email info@databasetycoon.com with what +happened. You don't need to have it perfectly documented; send a rough account +and we'll take it from there. We'll look into every report promptly and fairly, and we'll keep the reporter's identity private. Reporting something in good faith will never count against From 2c5677c239f339a8d5f5d7b7b9caf49b79a48ac8 Mon Sep 17 00:00:00 2001 From: Karli Date: Tue, 21 Jul 2026 12:25:09 +0100 Subject: [PATCH 8/9] Update .github/ISSUE_TEMPLATE/config.yml Co-authored-by: Stephen (DB Tycoon) --- .github/ISSUE_TEMPLATE/config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index d6b68c9..4c6a3c9 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,4 +1,4 @@ -blank_issues_enabled: false +blank_issues_enabled: true contact_links: - name: Questions & discussion url: https://github.com/Database-Tycoon/tycoon-cli/discussions From 91231d971e0e5e3277816f1cd15ed8e0a5b02c90 Mon Sep 17 00:00:00 2001 From: Karli Date: Tue, 21 Jul 2026 12:26:10 +0100 Subject: [PATCH 9/9] Update CODE_OF_CONDUCT.md Co-authored-by: Stephen (DB Tycoon) --- CODE_OF_CONDUCT.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 0df92f1..4cc79af 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,9 +1,10 @@ # Code of Conduct -Database Tycoon is a small team, and this is a public project. It only works -if people feel comfortable showing up: asking a basic question, filing a rough bug, -disagreeing about a design. This document is the short version of how we keep it -that way. It applies to everyone who shows up in an issue, a pull request, or a discussion. +Database Tycoon is a small team, and this is a public project. It only works +if people feel comfortable showing up: asking a basic question, filing a rough +bug, disagreeing about a design. This document is the short version of how we +keep it that way. It applies to everyone who shows up in an issue, a pull +request, or a discussion. ## What we expect