create-m5kdev 0.40.3 → 0.41.1

package/templates/minimal-app/apps/server/drizzle/meta/_journal.json.tpl

@@ -1,69 +1,76 @@
-{
-  "version": "7",
-  "dialect": "sqlite",
-  "entries": [
-    {
-      "idx": 0,
-      "version": "6",
-      "when": 1787759631723,
-      "tag": "0000_whole_echo",
-      "breakpoints": true
-    },
-    {
-      "idx": 1,
-      "version": "6",
-      "when": 1788197370969,
-      "tag": "0001_yummy_spectrum",
-      "breakpoints": true
-    },
-    {
-      "idx": 2,
-      "version": "6",
-      "when": 1788197859737,
-      "tag": "0002_crazy_lilith",
-      "breakpoints": true
-    },
-    {
-      "idx": 3,
-      "version": "6",
-      "when": 1788198203749,
-      "tag": "0003_freezing_fantastic_four",
-      "breakpoints": true
-    },
-    {
-      "idx": 4,
-      "version": "6",
-      "when": 1788198833389,
-      "tag": "0004_slow_ezekiel_stane",
-      "breakpoints": true
-    },
-    {
-      "idx": 5,
-      "version": "6",
-      "when": 1788253467922,
-      "tag": "0005_wonderful_the_professor",
-      "breakpoints": true
-    },
-    {
-      "idx": 6,
-      "version": "6",
-      "when": 1788787832546,
-      "tag": "0006_lazy_blue_marvel",
-      "breakpoints": true
-    },
-    {
-      "idx": 7,
-      "version": "6",
-      "when": 1788788533642,
-      "tag": "0007_abnormal_ultimo",
-      "breakpoints": true
-    },
-    {
-      "idx": 8,
-      "version": "6",
-      "when": 1788789159968,
-      "tag": "0008_steady_nekra",
-      "breakpoints": true
-    }
-  ]
-}
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1787759631723,
+      "tag": "0000_whole_echo",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1788197370969,
+      "tag": "0001_yummy_spectrum",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1788197859737,
+      "tag": "0002_crazy_lilith",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1788198203749,
+      "tag": "0003_freezing_fantastic_four",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1788198833389,
+      "tag": "0004_slow_ezekiel_stane",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1788253467922,
+      "tag": "0005_wonderful_the_professor",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "6",
+      "when": 1788787832546,
+      "tag": "0006_lazy_blue_marvel",
+      "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "6",
+      "when": 1788788533642,
+      "tag": "0007_abnormal_ultimo",
+      "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "6",
+      "when": 1788789159968,
+      "tag": "0008_steady_nekra",
+      "breakpoints": true
+    },
+    {
+      "idx": 9,
+      "version": "6",
+      "when": 1791905282553,
+      "tag": "0009_empty_starjammers",
+      "breakpoints": true
+    }
+  ]
+}

package/templates/minimal-app/apps/server/src/app.ts.tpl

@@ -1,3 +1,4 @@
+// biome-ignore-all assist/source/organizeImports: feature-gated module imports stay in marker blocks
 import { createBackendApp } from "@m5kdev/backend/app";
 import { shutdownTelemetry } from "@m5kdev/backend/lib/otel";
 // m5k:ai:start

package/templates/minimal-app/biome.json.tpl

@@ -14,6 +14,7 @@
       "!!**/storybook-static",
       "!**/.react-router",
       "!**/.m5kdev.json",
+      "!**/.e2e",
       "!**/drizzle/meta"
     ]
   },

package/templates/minimal-app/docs/agents/domain.md.tpl

@@ -0,0 +1,38 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`GLOSSARY.md`** at the repo root, or
+- **`GLOSSARY-MAP.md`** at the repo root if it exists — it points at one `GLOSSARY.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The `/domain-modeling` skill (reached via `/grill-with-docs` and `/improve-codebase-architecture`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo:
+
+```
+/
+├── GLOSSARY.md
+├── docs/
+│   ├── agents/
+│   └── adr/
+│       ├── 0001-….md
+│       └── 0002-….md
+└── apps/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `GLOSSARY.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/domain-modeling`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (…) — but worth reopening because…_

package/templates/minimal-app/docs/agents/issue-tracker.md.tpl

@@ -0,0 +1,45 @@
+# Issue tracker: GitHub
+
+Issues and specs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## Pull requests as a triage surface
+
+**PRs as a request surface: no.** _(Set to `yes` if this repo treats external PRs as feature requests; `/triage` reads this flag.)_
+
+When set to `yes`, PRs run through the same labels and states as issues, using the `gh pr` equivalents:
+
+- **Read a PR**: `gh pr view <number> --comments` and `gh pr diff <number>` for the diff.
+- **List external PRs for triage**: `gh pr list --state open --json number,title,body,labels,author,authorAssociation,comments` then keep only `authorAssociation` of `CONTRIBUTOR`, `FIRST_TIME_CONTRIBUTOR`, or `NONE` (drop `OWNER`/`MEMBER`/`COLLABORATOR`).
+- **Comment / label / close**: `gh pr comment`, `gh pr edit --add-label`/`--remove-label`, `gh pr close`.
+
+GitHub shares one number space across issues and PRs, so a bare `#42` may be either — resolve with `gh pr view 42` and fall back to `gh issue view 42`.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
+
+## Wayfinding operations
+
+Used by `/wayfinder`. The **map** is a single issue with **child** issues as tickets.
+
+- **Map**: a single issue labelled `wayfinder:map`, holding the Notes / Decisions-so-far / Fog body. `gh issue create --label wayfinder:map`.
+- **Child ticket**: an issue linked to the map as a GitHub sub-issue (`gh api` on the sub-issues endpoint). Where sub-issues aren't enabled, add the child to a task list in the map body and put `Part of #<map>` at the top of the child body. Labels: `wayfinder:<type>` (`research`/`prototype`/`grilling`/`task`). Once claimed, the ticket is assigned to the driving dev.
+- **Blocking**: GitHub's **native issue dependencies** — the canonical, UI-visible representation. Add an edge with `gh api --method POST repos/<owner>/<repo>/issues/<child>/dependencies/blocked_by -F issue_id=<blocker-db-id>`, where `<blocker-db-id>` is the blocker's numeric **database id** (`gh api repos/<owner>/<repo>/issues/<n> --jq .id`, _not_ the `#number` or `node_id`). GitHub reports `issue_dependencies_summary.blocked_by` (open blockers only — the live gate). Where dependencies aren't available, fall back to a `Blocked by: #<n>, #<n>` line at the top of the child body. A ticket is unblocked when every blocker is closed.
+- **Frontier query**: list the map's open children (`gh issue list --state open`, scoped to the map's sub-issues / task list), drop any with an open blocker (`issue_dependencies_summary.blocked_by > 0`, or an open issue in the `Blocked by` line) or an assignee; first in map order wins.
+- **Claim**: `gh issue edit <n> --add-assignee @me` — the session's first write.
+- **Resolve**: `gh issue comment <n> --body "<answer>"`, then `gh issue close <n>`, then append a context pointer (gist + link) to the map's Decisions-so-far.

package/templates/minimal-app/docs/agents/triage-labels.md.tpl

@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.

package/templates/minimal-app/pnpm-workspace.yaml.tpl

@@ -7,21 +7,21 @@ catalogs:
     "@heroui/react": 3.0.3
     "@heroui/styles": 3.0.3
     "@libsql/client": 0.17.4
-    "@m5kdev/backend": 0.40.3
-    "@m5kdev/commons": 0.40.3
-    "@m5kdev/config": 0.40.3
-    "@m5kdev/email": 0.40.3
-    "@m5kdev/expo": 0.40.3
-    "@m5kdev/frontend": 0.40.3
-    "@m5kdev/module-clay": 0.40.3
-    "@m5kdev/module-docx": 0.40.3
-    "@m5kdev/module-pdf": 0.40.3
-    "@m5kdev/module-social": 0.40.3
-    "@m5kdev/module-video": 0.40.3
-    "@m5kdev/web-ui": 0.40.3
+    "@m5kdev/backend": 0.41.1
+    "@m5kdev/commons": 0.41.1
+    "@m5kdev/config": 0.41.1
+    "@m5kdev/email": 0.41.1
+    "@m5kdev/expo": 0.41.1
+    "@m5kdev/frontend": 0.41.1
+    "@m5kdev/module-clay": 0.41.1
+    "@m5kdev/module-docx": 0.41.1
+    "@m5kdev/module-pdf": 0.41.1
+    "@m5kdev/module-social": 0.41.1
+    "@m5kdev/module-video": 0.41.1
+    "@m5kdev/web-ui": 0.41.1
     "@mastra/core": 1.51.0
     "@openrouter/ai-sdk-provider": 3.0.0
-    "@opentelemetry/api": 1.9.0
+    "@opentelemetry/api": 1.9.1
     "@playwright/test": 1.57.0
     "@react-email/components": 1.0.1
     "@tailwindcss/vite": 4.1.17
@@ -29,7 +29,7 @@ catalogs:
     "@trpc/client": 11.4.3
     "@trpc/server": 11.4.3
     "@trpc/tanstack-react-query": 11.4.3
-    "@types/express": 4.17.21
+    "@types/express": 5.0.6
     "@types/node": 20.19.11
     "@types/react": 19.2.17
     "@types/react-dom": 19.2.3
@@ -40,7 +40,7 @@ catalogs:
     drizzle-kit: 0.31.10
     drizzle-orm: 0.45.2
     drizzle-zod: 0.8.3
-    express: 4.21.2
+    express: 5.3.0
     i18next: 25.3.2
     ioredis: 5.11.1
     lucide-react: 0.488.0

package/templates/minimal-app/template.manifest.json

@@ -148,6 +148,18 @@
       {
         "pattern": "apps/server/drizzle.config.ts",
         "policy": "ensure"
+      },
+      {
+        "pattern": "GLOSSARY.md",
+        "policy": "ensure"
+      },
+      {
+        "pattern": "docs/agents/**",
+        "policy": "ensure"
+      },
+      {
+        "pattern": "docs/adr/**",
+        "policy": "ensure"
       }
     ],
     "renames": []