Merge pull request #530 from TencentCloudBase/feature/attribution-http-functions-express5-wildcard

fix: Express 5 wildcard HTTP function reference

Author: binggg

config/source/skills/cloud-functions/references/http-functions.md

@@ -76,13 +76,15 @@ app.post("/users", (req, res) => {
   return res.status(201).json({ name, email });
 });
 
-app.all("*", (req, res) => {
+app.all("/{*splat}", (req, res) => {
   res.status(405).json({ error: "Method Not Allowed" });
 });
 
 app.listen(9000);
 ```
 
+Express 5 note: do not use bare `*` or `/*` here. Express 5 uses `path-to-regexp` with named wildcards, so `app.all("/{*splat}", ...)` is the safe catch-all form when you also need to match the root path `/`.
+
 ## Deployment flow
 
 Prefer `manageFunctions` over CLI in agent flows.

tests/skill-quality-standards.test.js

@@ -65,6 +65,23 @@ describe('skill quality standards', () => {
     expect(raw).toMatch(/cost/i);
   });
 
+  test('cloud-functions http reference stays compatible with Express 5 wildcard syntax', () => {
+    const raw = readFile(
+      'config',
+      'source',
+      'skills',
+      'cloud-functions',
+      'references',
+      'http-functions.md',
+    );
+
+    expect(raw).not.toContain('app.all("*")');
+    expect(raw).not.toContain("app.all('/*')");
+    expect(raw).toContain('app.all("/{*splat}", (req, res) => {');
+    expect(raw).toMatch(/Express 5 note:/);
+    expect(raw).toMatch(/path-to-regexp/);
+  });
+
   test('cloudbase-agent does not force global activation by default', () => {
     const raw = readSourceSkill('cloudbase-agent');