@vgai/cli 0.5.0-canary.20260719.0 → 0.5.0

package/dist/index.js

@@ -303897,6 +303897,26 @@ var AdapterRootSchema = external_exports.object({
     "Per-delivery-context capability tier declarations (\xA74). Declaring above the adapter's ceiling for that context is an error; declaring at or below it (including `unsupported`) is legal."
   )
 }).strict();
+var LearnKindSchema = external_exports.enum(["starter", "feature", "sample-game", "lesson-companion"]).describe(
+  "Content kind in the FTUE taxonomy (\xA73): starter (minimal per-genre starting point), feature (demonstrates a subsystem), sample-game (complete game as an architectural reference), lesson-companion (exists to back a Learn-site lesson)"
+);
+var LearnDifficultySchema = external_exports.enum(["beginner", "intermediate", "advanced"]).describe("Learner-facing difficulty rating");
+var LearnMetadataSchema = external_exports.object({
+  kind: LearnKindSchema,
+  title: external_exports.string().min(1).describe("Learner-facing display title (gallery card headline)"),
+  summary: external_exports.string().min(1).describe("One-sentence learner-facing summary (gallery card body)"),
+  difficulty: LearnDifficultySchema,
+  features: external_exports.array(external_exports.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "features tags must be kebab-case")).describe("Short kebab-case feature tags used as gallery/catalog filter facets"),
+  thumbnail: external_exports.string().optional().describe(
+    "Optional thumbnail image reference (engine-repo-relative, e.g. docs/example-screenshots/<id>/<shot>.png; generated per FT-11, never hand-made)"
+  ),
+  preview: external_exports.string().optional().describe("Optional short preview video/loop reference (generated per FT-11)"),
+  lesson: external_exports.string().optional().describe(
+    "Optional Learn-site lesson URL that teaches this project 1:1 (e.g. https://vgai-learn.pages.dev/quick-starts/joints/)"
+  )
+}).strict().describe(
+  "Learner-facing metadata (FT-5, docs/FTUE-LEARN-SYSTEM-DESIGN.md \xA73) \u2014 powers the example gallery, New Project wizard, and Learn-site catalog. Registries are generated from this block; there is no parallel hand-edited catalog."
+);
 var GameManifestSchema = external_exports.object({
   $schema: external_exports.string().optional().describe("Optional JSON Schema URI for editor autocomplete and validation"),
   manifestVersion: external_exports.literal(GAME_MANIFEST_VERSION).describe("Manifest file format version (v2 clean roots)"),
@@ -303981,6 +304001,9 @@ var GameManifestSchema = external_exports.object({
     message: "Game manifest: `budget` must set at least one metric (frameCpuMsP95, physicsMsP95, maxEntities, maxDrawCalls, maxTriangles) \u2014 an empty budget block gates nothing (T4.1 no-dead-fields policy)."
   }).optional().describe(
     "Performance budget (W3d, F11 perf regression gates) asserted by `vgai perf --assert-budget`: a seeded, fixed-step headless run samples the engine profiler and fails (nonzero exit) when any metric here is exceeded. Only headlessly-measurable metrics are budgetable; real GPU frame time is not (SwiftShader)."
+  ),
+  learn: LearnMetadataSchema.optional().describe(
+    "Optional learner-facing metadata (FT-5) \u2014 set on shipped example projects so the gallery/wizard/Learn-catalog registries can be generated from the manifest itself"
   )
 }).strict().describe("Game manifest (vgai.game.json) \u2014 the complete v2 project configuration");
 
@@ -304150,7 +304173,8 @@ function loadGameManifest(raw) {
     authoring: manifest.authoring,
     debug: manifest.debug,
     determinism: manifest.determinism,
-    budget: manifest.budget
+    budget: manifest.budget,
+    learn: manifest.learn
   };
 }
 
@@ -318697,8 +318721,8 @@ function batteryDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.0-canary.20260719.0") {
-    return "0.5.0-canary.20260719.0";
+  if ("0.5.0") {
+    return "0.5.0";
   }
   try {
     const pkg = JSON.parse(readFileSync22(join28(__dirname4, "..", "package.json"), "utf8"));
@@ -318717,7 +318741,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.0-canary.20260719.0","@vgai/editor":"0.5.0-canary.20260719.0","@vgai/p2p-colyseus":"0.5.0-canary.20260719.0","@vgai/e2e":"0.5.0-canary.20260719.0","@vgai/live":"0.5.0-canary.20260719.0","@vgai/sdk":"0.5.0-canary.20260719.0","@vgai/editor-sdk":"0.5.0-canary.20260719.0","@vgai/cli":"0.5.0-canary.20260719.0"}');
+    return JSON.parse('{"@vgai/engine":"0.5.0","@vgai/editor":"0.5.0","@vgai/p2p-colyseus":"0.5.0","@vgai/e2e":"0.5.0","@vgai/live":"0.5.0","@vgai/sdk":"0.5.0","@vgai/editor-sdk":"0.5.0","@vgai/cli":"0.5.0"}');
   } catch {
     return void 0;
   }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.0-canary.20260719.0",
+  "version": "0.5.0",
   "description": "Create, open, control, validate, and playtest VGAI game projects.",
   "keywords": [
     "game-engine",
@@ -37,13 +37,13 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/e2e": "0.5.0-canary.20260719.0",
-    "@vgai/editor": "0.5.0-canary.20260719.0",
-    "@vgai/editor-sdk": "0.5.0-canary.20260719.0",
-    "@vgai/engine": "0.5.0-canary.20260719.0",
-    "@vgai/live": "0.5.0-canary.20260719.0",
-    "@vgai/p2p-colyseus": "0.5.0-canary.20260719.0",
-    "@vgai/sdk": "0.5.0-canary.20260719.0",
+    "@vgai/e2e": "0.5.0",
+    "@vgai/editor": "0.5.0",
+    "@vgai/editor-sdk": "0.5.0",
+    "@vgai/engine": "0.5.0",
+    "@vgai/live": "0.5.0",
+    "@vgai/p2p-colyseus": "0.5.0",
+    "@vgai/sdk": "0.5.0",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",