Repository navigation
docs: copilot instructions - #347
Conversation
There was a problem hiding this comment.
Pull request overview
This PR adds comprehensive GitHub Copilot instructions to help AI assistants understand the Interledger Charts repository structure, workflows, and conventions.
Changes:
- Added
.github/copilot-instructions.mddocumenting repository purpose, automated versioning workflows, tooling stack, CI processes, and contribution guidelines
| - **Common library changes**: When editing the shared common chart, prefer adding the manual-versioning label so you can bump it and update dependent test charts (e.g., charts/tests/common-unittests and charts/examples/*) in the same PR without the auto-versioner firing early. | ||
| - **Packaging details**: chartmanager runs `helm dep update`, `helm package`, and `helm repo index` targeting docs/interledger with repo URL https://interledger.github.io/charts/interledger (see [tooling/chartmanager.js](tooling/chartmanager.js)). | ||
| - **Commit message source**: resolveCommitMessage prefers PR title, then head commit message, then PR_TITLE env var, otherwise falls back to chore: bump charts (see [tooling/runner.js](tooling/runner.js)). | ||
| - **Tooling stack**: Node 24 with pnpm 10; run `pnpm install` in tooling/, then `pnpm lint` (tsc) and `pnpm test` (node --test) (see [tooling/package.json](tooling/package.json)). |
There was a problem hiding this comment.
The pnpm version reference is imprecise. The package.json specifies "pnpm@10.25.0" (a specific patch version), not just "pnpm 10". Consider updating to "pnpm 10.25.0" for accuracy.
| - **Tooling stack**: Node 24 with pnpm 10; run `pnpm install` in tooling/, then `pnpm lint` (tsc) and `pnpm test` (node --test) (see [tooling/package.json](tooling/package.json)). | |
| - **Tooling stack**: Node 24 with pnpm 10.25.0; run `pnpm install` in tooling/, then `pnpm lint` (tsc) and `pnpm test` (node --test) (see [tooling/package.json](tooling/package.json)). |
| - **Packaging details**: chartmanager runs `helm dep update`, `helm package`, and `helm repo index` targeting docs/interledger with repo URL https://interledger.github.io/charts/interledger (see [tooling/chartmanager.js](tooling/chartmanager.js)). | ||
| - **Commit message source**: resolveCommitMessage prefers PR title, then head commit message, then PR_TITLE env var, otherwise falls back to chore: bump charts (see [tooling/runner.js](tooling/runner.js)). | ||
| - **Tooling stack**: Node 24 with pnpm 10; run `pnpm install` in tooling/, then `pnpm lint` (tsc) and `pnpm test` (node --test) (see [tooling/package.json](tooling/package.json)). | ||
| - **Helm unit tests CI**: [.github/workflows/unit-tests.yml](.github/workflows/unit-tests.yml) discovers charts (excluding charts/docs/tests/common) and, for each, runs `helm unittest` plus `helm template <chart> | kubeconform -strict -summary -ignore-missing-schemas` inside the ghcr.io/interledger/builders/chartvalidator:v0.5 container. |
There was a problem hiding this comment.
The exclusion pattern description is incorrect. The workflow at .github/workflows/unit-tests.yml line 31 uses "grep -vE '^(charts|docs|tests|common)'" which excludes any chart directory starting with these names (charts, docs, tests, or common), not specifically "charts/docs/tests/common" as a single path. The pattern excludes charts at the top level within the charts/ directory that begin with these names.
| - **Helm unit tests CI**: [.github/workflows/unit-tests.yml](.github/workflows/unit-tests.yml) discovers charts (excluding charts/docs/tests/common) and, for each, runs `helm unittest` plus `helm template <chart> | kubeconform -strict -summary -ignore-missing-schemas` inside the ghcr.io/interledger/builders/chartvalidator:v0.5 container. | |
| - **Helm unit tests CI**: [.github/workflows/unit-tests.yml](.github/workflows/unit-tests.yml) discovers charts (excluding top-level charts under charts/ named charts, docs, tests, or common) and, for each, runs `helm unittest` plus `helm template <chart> | kubeconform -strict -summary -ignore-missing-schemas` inside the ghcr.io/interledger/builders/chartvalidator:v0.5 container. |
No description provided.