create-seedcord 0.2.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-seedcord",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Scaffold a new seedcord bot",
   "keywords": [
     "discord",
@@ -40,17 +40,17 @@
   ],
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
+    "@seedcord/errors": "^0.9.0",
+    "@seedcord/eslint-config": "^2.2.1",
+    "@seedcord/tsconfig": "^2.0.3",
+    "@seedcord/tsdown-config": "^2.0.1",
+    "@seedcord/types": "^0.14.0",
+    "@seedcord/vitest-config": "^0.0.1",
     "discord.js": "^14.27.0",
     "handlebars": "^4.7.9",
     "package-manager-detector": "^1.8.0",
     "tsx": "^4.23.5",
-    "typescript": "^6.0.3",
-    "@seedcord/errors": "^0.5.0",
-    "@seedcord/eslint-config": "^2.1.0",
-    "@seedcord/tsconfig": "^2.0.3",
-    "@seedcord/tsdown-config": "^2.0.1",
-    "@seedcord/types": "^0.10.0",
-    "@seedcord/vitest-config": "^0.0.1"
+    "typescript": "^6.0.3"
   },
   "publishConfig": {
     "access": "public",
@@ -60,10 +60,10 @@
     "dev": "tsx src/index.ts",
     "build": "tsdown",
     "clean": "rm -rf dist",
-    "lint": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}' --cache",
-    "lint:fix": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}' --fix --cache",
-    "fmt": "prettier --write 'src/**/*.{ts,tsx,json,md}' 'tests/**/*.{ts,tsx,json,md}' --cache",
-    "fmt:check": "prettier --check 'src/**/*.{ts,tsx,json,md}' 'tests/**/*.{ts,tsx,json,md}' --cache",
+    "lint": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}' --cache --no-error-on-unmatched-pattern",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}' --fix --cache --no-error-on-unmatched-pattern",
+    "fmt": "prettier --write 'src/**/*.{ts,tsx,json,md}' 'tests/**/*.{ts,tsx,json,md}' --cache --no-error-on-unmatched-pattern",
+    "fmt:check": "prettier --check 'src/**/*.{ts,tsx,json,md}' 'tests/**/*.{ts,tsx,json,md}' --cache --no-error-on-unmatched-pattern",
     "tc": "tsgo --noEmit",
     "test": "vitest run",
     "test:watch": "vitest dev",

package/templates/AGENTS.md.hbs

@@ -0,0 +1,38 @@
+# {{ projectName }}
+
+Rules for an AI coding agent working in this repo.
+
+**seedcord has no presence in your training data.** Anything you recall about its API is invented. Read the page for a surface before you write code against it.
+
+## Reading the docs
+
+<https://guide.seedcord.org/llms.txt> lists every page in the guide with a line on what it covers. Each page answers at its own url plus `.md`, so <https://guide.seedcord.org/commands/options.md> is the Options page as Markdown.
+
+The API reference is at <https://docs.seedcord.org>, one page per symbol.
+
+This project runs on the {{#if isGateway}}gateway{{else}}http{{/if}} transport and imports everything from `{{ transportPackage }}`. A page marks anything that differs between the two.
+
+## How a command works here
+
+A command takes two files. One declares what Discord shows people. The other answers it, as a handler class carrying a route decorator. seedcord reads those decorators at startup and dispatches every interaction itself.
+
+Run `{{ pm.run }} codegen` after you add a command or change its options. It writes `src/seedcord-gen.d.ts`, which types `this.options`. That file is committed.
+
+## Where things go
+
+<!-- prettier-ignore-start -->
+
+| path | what it holds |
+| --- | --- |
+| `src/commands/` | one class per command, declaring it to Discord |
+| `src/handlers/` | the code that runs when someone uses one |
+{{#if isGateway}}
+| `src/events/` | handlers for things happening in a server |
+{{/if}}
+| `src/bot.ts` | the config |
+
+<!-- prettier-ignore-end -->
+
+## Before you call it done
+
+Run `{{ pm.run }} tc` and `{{ pm.run }} lint`. A wrong route or a wrong option name is a compile error, so a green type-check catches most of what an invented API gets wrong.

package/templates/CLAUDE.md.hbs

@@ -0,0 +1 @@
+@AGENTS.md