chore: update README and CLI usage for cursor_gen, version bump to 1.0.1

- Changed CLI usage instructions from `dart run cursor_gen` to `cursor_gen` for global activation.
- Updated project-brief.yaml example and README to reflect new command usage.
- Added app_context section in project-brief.yaml for theme variants and RBAC roles.
- Fixed bundled template resolution for local and global installs to prevent 'Template not found' errors.
- Version bump to 1.0.1 with corresponding updates in CHANGELOG and pubspec.yaml.

flutter-cursor-templates/generator/brief-schema.json

@@ -8,7 +8,7 @@
     "cursor_templates_version": {
       "type": "string",
       "description": "Pillar 1: Pin to template version for reproducibility",
-      "examples": ["1.0.0"]
+      "examples": ["1.0.1"]
     },
     "project": {
       "type": "object",
@@ -91,6 +91,73 @@
         "locales": { "type": "array", "items": { "type": "string" } }
       }
     },
+    "design": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "type": "string",
+          "enum": ["figma_mcp", "figma_manual", "native_ref", "html_ref", "none"]
+        },
+        "figma_url": { "type": "string" }
+      }
+    },
+    "api_docs": {
+      "type": "object",
+      "properties": {
+        "format": {
+          "type": "string",
+          "enum": ["openapi", "postman", "markdown", "none"]
+        },
+        "path": { "type": "string" }
+      }
+    },
+    "references": {
+      "type": "object",
+      "description": "Other repos or local paths agents should treat as product context",
+      "properties": {
+        "repos": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Git remote URLs (https or ssh)"
+        },
+        "local_paths": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Repo-relative paths (e.g. monorepo packages) or other local references"
+        }
+      }
+    },
+    "features": {
+      "type": "object",
+      "properties": {
+        "modules": { "type": "array", "items": { "type": "string" } },
+        "special": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "app_context": {
+      "type": "object",
+      "description": "Theme targets and optional RBAC labels — mirrored to cursor-gen-metadata.json on generate",
+      "properties": {
+        "theme_variants": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["light", "dark", "high_contrast"]
+          },
+          "description": "Supported theme tokens; omit or leave empty to default to light + dark in the loader"
+        },
+        "roles_enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, list concrete roles in role_names"
+        },
+        "role_names": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Product role identifiers when roles_enabled is true"
+        }
+      }
+    },
     "telemetry_opt_in": {
       "type": "boolean",
       "description": "Pillar 6: Opt-in local telemetry for rule trigger analytics",