Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
chore(contributing): verify plugin proposal policy (#57)
Leofbeac325bb87
diff --git a/.depot/workflows/ci.yml b/.depot/workflows/ci.ymlindex 11f09ee57..07722f0d4 100644--- a/.depot/workflows/ci.yml+++ b/.depot/workflows/ci.yml@@ -63,6 +63,15 @@ jobs:- name: Validate plugin catalogrun: node scripts/validate-plugin-catalog.ts+ - name: Test plugin catalog and contribution policy+ run: >-+ vp test run+ scripts/validate-plugin-catalog.test.ts+ scripts/plugin-contribution-policy.test.ts+ plugins/catalog.test.ts+ plugins/schema.test.ts+ plugins/lifecycle-matrix.test.ts+- name: Lintrun: vp run lintdiff --git a/.github/ISSUE_TEMPLATE/plugin_proposal.yml b/.github/ISSUE_TEMPLATE/plugin_proposal.ymlindex e47c64c66..324e028f0 100644--- a/.github/ISSUE_TEMPLATE/plugin_proposal.yml+++ b/.github/ISSUE_TEMPLATE/plugin_proposal.yml@@ -28,6 +28,15 @@ body:validations:required: true+ - type: input+ id: maintainer+ attributes:+ label: Plugin maintainer+ description: Name the person or organization that maintains the plugin and give their public URL.+ placeholder: Acme Inc., https://acme.example+ validations:+ required: true+- type: textareaid: akeru_jobattributes:@@ -76,6 +85,7 @@ body:description: Choose the state that works today. Explain an approval blocker below.options:- available+ - verification-pending- approval-pending- deprecatedvalidations:diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 6d8bebe04..9a6238be2 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -6,7 +6,7 @@ We are not actively accepting contributions right now.You can still report a bug or open a PR, but please do so knowing there is a high chance we close it, defer it forever, or never look at it.-Feature requests and proposals belong in [Ideas discussions](https://github.com/pingdotgg/t3code/discussions/categories/ideas), not issues. Plugin and provider contributions are the exception: start with the matching proposal form, and read the [plugin directory admission rules](plugins/README.md) before you submit a plugin.+Feature requests and proposals belong in [Ideas discussions](https://github.com/pingdotgg/t3code/discussions/categories/ideas), not issues. Plugin and provider contributions are the exception. Start with the [plugin proposal](https://github.com/opencoredev/akeru-bot/issues/new?template=plugin_proposal.yml) or [provider proposal](https://github.com/opencoredev/akeru-bot/issues/new?template=provider_proposal.yml). Read the [plugin directory admission rules](plugins/README.md) before you submit a plugin.If that sounds annoying, that is because it is. This project is still early and we are trying to keep scope, quality, and direction under control.diff --git a/docs/README.md b/docs/README.mdindex ee90a6752..370a9b27b 100644--- a/docs/README.md+++ b/docs/README.md@@ -7,6 +7,7 @@- [Keyboard shortcuts](./user/keybindings.md)- [Organizing threads](./user/thread-sidebar.md)- [Sending product feedback](./user/product-feedback.md)+- [Plugins](./user/plugins.md)- [Review usage](./user/usage.md)- [Customize a project icon](./user/project-settings.md)- [Mobile appearance](./user/mobile-appearance.md)@@ -31,6 +32,7 @@ policy in [CONTRIBUTING.md](../CONTRIBUTING.md); agent rules in [AGENTS.md](../A- [Scripts](./internals/scripts.md)- [Connection runtime](./internals/connection-runtime.md)- [Providers](./internals/providers.md)+- [Plugin lifecycle verification](./internals/plugin-lifecycle-verification.md)- [Remote environments](./internals/remote.md)- [Server updates](./internals/server-updates.md)- [Resource telemetry](./internals/resource-telemetry.md)diff --git a/docs/internals/ci.md b/docs/internals/ci.mdindex 2ebe29406..1f990bbf1 100644--- a/docs/internals/ci.md+++ b/docs/internals/ci.md@@ -9,7 +9,8 @@ Issue-label, PR-vouch, and PR-size jobs stay in GitHub Actions on `ubuntu-24.04`- **Public dependency install.** The job rejects `file:` and `link:` dependencies that resolveoutside the repository, then runs `vp install --frozen-lockfile`.- **Lint, types, and builds.** The job checks lint and formatting, runs workspace type checks,- builds the desktop pipeline, checks the preload output, and builds the marketing site.+ validates the plugin directory and contribution policy, builds the desktop pipeline, checks the+ preload output, and builds the marketing site.- **Focused tests.** Separate jobs run the shipped desktop and shared-package tests, the shardedserver tests, and the resource-monitor tests. Relay and mobile-production packages are excluded.The server shards exclude `orchestrationEngine.integration.test.ts` until the executor stackdiff --git a/docs/internals/work-artifacts.md b/docs/internals/work-artifacts.mdindex 157a61745..7999f1b2a 100644--- a/docs/internals/work-artifacts.md+++ b/docs/internals/work-artifacts.md@@ -14,7 +14,7 @@ When the reason for a decision will matter after implementation, record it in thTrack active maintainer work in its GitHub issue or project item. The tracking item should state the outcome, constraints, and acceptance criteria, then link the pull requests that implement it. Split large efforts into one durable specification and small work items that can each close independently.-Close completed items. Update or delete invalidated work before starting the next implementation session. External proposals follow [CONTRIBUTING.md](../../CONTRIBUTING.md) and belong in Ideas discussions rather than issues.+Close completed items. Update or delete invalidated work before starting the next implementation session. External proposals follow [CONTRIBUTING.md](../../CONTRIBUTING.md) and belong in Ideas discussions rather than issues. Plugin and provider proposals use their issue forms because maintainers need fixed admission and lifecycle evidence.## Temporary work stays temporarydiff --git a/plugins/README.md b/plugins/README.mdindex ead9c054d..8bb0ec796 100644--- a/plugins/README.md+++ b/plugins/README.md@@ -24,7 +24,7 @@ Declare an approval for each permission that can send, pay, delete, change produ## Add an entry-1. Open a Plugin proposal issue and attach the admission evidence.+1. Open a [Plugin proposal](https://github.com/opencoredev/akeru-bot/issues/new?template=plugin_proposal.yml) and attach the admission evidence. Use the [Provider proposal](https://github.com/opencoredev/akeru-bot/issues/new?template=provider_proposal.yml) for an agent runtime.2. Wait for a maintainer to confirm that the plugin fits the directory.3. Add one `entries/<id>/` directory with `plugin.json`, `logo.svg`, and `logo-dark.svg`.4. Run the validator and focused tests.diff --git a/scripts/plugin-contribution-policy.test.ts b/scripts/plugin-contribution-policy.test.tsindex ff771d702..a9ad5e49e 100644--- a/scripts/plugin-contribution-policy.test.ts+++ b/scripts/plugin-contribution-policy.test.ts@@ -36,7 +36,11 @@ function labelsForPath(config: PathLabelConfig, path: string): string[] {describe("plugin contribution policy", () => {it.each([- ["plugin_proposal.yml", "type:plugin", ["product", "mcp_ownership", "logo", "permissions"]],+ [+ "plugin_proposal.yml",+ "type:plugin",+ ["product", "maintainer", "mcp_ownership", "logo", "permissions"],+ ],["provider_proposal.yml", "type:provider", ["provider", "runtime", "logo", "approvals"]],])("collects admission evidence in %s", (file, typeLabel, specificFields) => {const form = yaml(`.github/ISSUE_TEMPLATE/${file}`) as {@@ -163,7 +167,7 @@ describe("plugin contribution policy", () => {);});- it("runs the existing catalog validator in CI", () => {+ it("runs catalog validation and contribution policy tests in CI", () => {const ci = yaml(".depot/workflows/ci.yml") as {jobs: Record<string, { steps?: Array<{ run?: string }> }>;};@@ -172,6 +176,9 @@ describe("plugin contribution policy", () => {);expect(commands).toContain("node scripts/validate-plugin-catalog.ts");+ expect(commands).toContain(+ "vp test run scripts/validate-plugin-catalog.test.ts scripts/plugin-contribution-policy.test.ts plugins/catalog.test.ts plugins/schema.test.ts plugins/lifecycle-matrix.test.ts",+ );});it("keeps issue routing and the accepted-proposal PR exception coherent", () => {@@ -186,6 +193,13 @@ describe("plugin contribution policy", () => {);expect(contributionGuide).not.toContain("opencoredev/akeru-bot/discussions");expect(contributionGuide).toContain("plugin and provider proposal forms");+ expect(contributionGuide).toContain("issues/new?template=plugin_proposal.yml");+ expect(contributionGuide).toContain("issues/new?template=provider_proposal.yml");+ expect(text("plugins/README.md")).toContain("issues/new?template=plugin_proposal.yml");+ expect(text(".github/ISSUE_TEMPLATE/plugin_proposal.yml")).toContain("verification-pending");+ expect(text("docs/internals/work-artifacts.md")).toContain(+ "Plugin and provider proposals use their issue forms",+ );expect(pullRequestTemplate).toContain("accepted plugin or provider proposal");});});