[codex] Ship AuraGlass 3.1 package release

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,73 @@
+name: Bug report
+description: Report a reproducible package bug in AuraGlass.
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for package behavior that is broken in a React or Next.js app. For visual-only regressions, use the visual regression template.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened, and what did you expect instead?
+      placeholder: GlassCard renders with unreadable text in dark mode when...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Provide a minimal reproduction, repository, StackBlitz, or exact code snippet.
+      placeholder: |
+        npm install aura-glass
+        import { GlassCard } from 'aura-glass';
+        import 'aura-glass/styles';
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: AuraGlass version
+      placeholder: 3.1.0
+    validations:
+      required: true
+  - type: dropdown
+    id: framework
+    attributes:
+      label: Framework
+      options:
+        - React 18
+        - React 19
+        - Next.js 14
+        - Next.js 15
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Include browser, Node, npm/pnpm/yarn, OS, and bundler if relevant.
+      placeholder: Node 20, npm 10, Chrome 124, macOS, Vite...
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or screenshots
+      description: Paste relevant console output, stack traces, screenshots, or test failures.
+      render: shell
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Preflight
+      options:
+        - label: I import styles with `import 'aura-glass/styles';` where required.
+          required: true
+        - label: I am not importing from private `src` paths.
+          required: true
+        - label: I installed optional peer dependencies for any advanced component family I am using.
+          required: true

.github/ISSUE_TEMPLATE/component_request.yml

@@ -0,0 +1,52 @@
+name: Component request
+description: Request a new component, recipe, or flagship enhancement.
+title: "[Component]: "
+labels:
+  - component-request
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Product problem
+      description: What user workflow should AuraGlass support?
+      placeholder: We need a compact Liquid Glass billing plan comparison for SaaS settings pages.
+    validations:
+      required: true
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - Core surface
+        - Navigation
+        - Overlay
+        - Data and visualization
+        - Forms and inputs
+        - Media
+        - AI product UI
+        - Recipe or template
+        - Advanced or 3D
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: api
+    attributes:
+      label: Suggested API or example
+      description: Include import names, props, and expected usage if you have a proposal.
+      render: tsx
+  - type: textarea
+    id: references
+    attributes:
+      label: Visual references
+      description: Link screenshots, product examples, or design notes.
+  - type: checkboxes
+    id: expectations
+    attributes:
+      label: Expected launch quality
+      options:
+        - label: Includes docs and examples.
+        - label: Works in compact catalog cards.
+        - label: Supports dark mode.
+        - label: Supports reduced motion where motion is present.
+        - label: Has focused tests.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: AuraGlass documentation
+    url: https://auraglass.auraone.ai
+    about: Read setup, component, and release documentation before filing an issue.
+  - name: Security vulnerability
+    url: https://github.com/auraoneai/auraglass/security/policy
+    about: Report suspected vulnerabilities through the private security process.

.github/ISSUE_TEMPLATE/documentation_issue.yml

@@ -0,0 +1,37 @@
+name: Documentation issue
+description: Report missing, stale, unclear, or inconsistent documentation.
+title: "[Docs]: "
+labels:
+  - documentation
+body:
+  - type: input
+    id: page
+    attributes:
+      label: Page or file
+      placeholder: README.md, docs/guides/accessibility.md, /docs/getting-started
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What is wrong?
+      description: Explain what is missing, stale, confusing, or inconsistent.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected documentation
+      description: What should the page say or link to?
+  - type: checkboxes
+    id: areas
+    attributes:
+      label: Affected areas
+      options:
+        - label: Install or CSS import
+        - label: Next.js or SSR
+        - label: Peer dependencies
+        - label: Component props or examples
+        - label: Accessibility or reduced motion
+        - label: Performance or bundle size
+        - label: AI-agent guidance

.github/ISSUE_TEMPLATE/visual_regression.yml

@@ -0,0 +1,58 @@
+name: Visual regression
+description: Report a rendering, layout, contrast, motion, or preview-quality regression.
+title: "[Visual]: "
+labels:
+  - visual-regression
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: Describe the visual issue and why it is a regression.
+      placeholder: GlassDataGrid clips row actions at mobile width...
+    validations:
+      required: true
+  - type: input
+    id: component
+    attributes:
+      label: Component or route
+      placeholder: GlassDataGrid, GlassCommandPalette, /components/data
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots or video
+      description: Attach before/after images, contact sheets, or a short clip.
+    validations:
+      required: true
+  - type: dropdown
+    id: viewport
+    attributes:
+      label: Viewport
+      options:
+        - Desktop
+        - Mobile
+        - Tablet
+        - Responsive range
+        - Storybook
+        - Website catalog
+    validations:
+      required: true
+  - type: textarea
+    id: checks
+    attributes:
+      label: Checks run
+      description: List any visual, Storybook, Playwright, or manual QA checks already run.
+      placeholder: npm run test:visual:ci
+  - type: checkboxes
+    id: issue_type
+    attributes:
+      label: Regression type
+      options:
+        - label: Clipping or overflow
+        - label: Unreadable contrast
+        - label: Empty or placeholder preview
+        - label: Motion or reduced-motion issue
+        - label: SSR or hydration visual mismatch
+        - label: Mobile layout issue

.github/pull_request_template.md

@@ -0,0 +1,50 @@
+# Summary
+
+Describe the change and the user-facing behavior it affects.
+
+## Scope
+
+- [ ] Package source
+- [ ] Documentation or README
+- [ ] GitHub/community metadata
+- [ ] Release evidence
+- [ ] Tests or audit tooling
+- [ ] Website handoff only; no website repo edits in this PR
+
+## Package Checks
+
+Run the focused checks that match the change. Do not mark a gate complete unless it was run on this branch.
+
+- [ ] `npm run typecheck`
+- [ ] `npm run lint:check`
+- [ ] `npm run lint:tokens`
+- [ ] `npm run lint:styles`
+- [ ] `npm test -- --runInBand`
+- [ ] `npm run audit:components`
+- [ ] `npm run audit:exports`
+- [ ] `npm run audit:api`
+- [ ] `npm run audit:runtime`
+- [ ] `npm run build`
+- [ ] `npm run verify:pack`
+- [ ] `npm run test:integration:next -- --skip-build`
+- [ ] `npm run release:dry-run`
+
+## Visual QA
+
+- [ ] Storybook preview checked
+- [ ] Desktop viewport checked
+- [ ] Mobile viewport checked
+- [ ] Reduced motion checked
+- [ ] Dark theme checked
+- [ ] Screenshots or contact sheets attached when visual output changed
+
+## Documentation
+
+- [ ] README/npm-facing copy updated if public behavior changed
+- [ ] Component docs updated if API or usage changed
+- [ ] Changelog updated
+- [ ] 3.1 evidence scaffold updated when a launch gate changed
+
+## Risk
+
+List known risks, follow-ups, and any gates intentionally not run.

.github/workflows/deploy-storybook.yml

@@ -8,6 +8,8 @@ on:
 
 permissions:
   contents: write
+  issues: write
+  pull-requests: write
 
 jobs:
   build-and-deploy:
@@ -39,10 +41,11 @@ jobs:
 
       - name: Comment PR with Storybook URL
         if: github.event_name == 'pull_request'
+        continue-on-error: true
         uses: actions/github-script@v7
         with:
           script: |
-            github.rest.issues.createComment({
+            await github.rest.issues.createComment({
               issue_number: context.issue.number,
               owner: context.repo.owner,
               repo: context.repo.repo,

.github/workflows/design-system-compliance.yml

@@ -6,6 +6,11 @@ on:
   pull_request:
     branches: [ main, develop ]
 
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
 jobs:
   design-system-compliance:
     runs-on: ubuntu-latest
@@ -71,6 +76,7 @@ jobs:
 
     - name: Comment PR with Design System Report
       if: github.event_name == 'pull_request'
+      continue-on-error: true
       uses: actions/github-script@v7
       with:
         script: |
@@ -82,7 +88,7 @@ jobs:
             report = '## Design System Report\n\nReport generation failed.';
           }
 
-          github.rest.issues.createComment({
+          await github.rest.issues.createComment({
             issue_number: context.issue.number,
             owner: context.repo.owner,
             repo: context.repo.repo,

.github/workflows/glass-pipeline.yml

@@ -6,6 +6,11 @@ on:
   pull_request:
     branches: [main, develop]
 
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
 jobs:
   glass-quality-gates:
     name: Glass Quality Gates
@@ -121,13 +126,14 @@ jobs:
         path: reports/glass/visual-tests/
 
     - name: Comment on PR with test links
+      continue-on-error: true
       uses: actions/github-script@v7
       with:
         script: |
           const fs = require('fs');
 
           if (fs.existsSync('reports/glass/visual-tests/comprehensive-test.html')) {
-            github.rest.issues.createComment({
+            await github.rest.issues.createComment({
               issue_number: context.issue.number,
               owner: context.repo.owner,
               repo: context.repo.repo,

.github/workflows/visual-regression.yml

@@ -6,6 +6,11 @@ on:
   pull_request:
     branches: [main]
 
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
 jobs:
   visual-tests:
     runs-on: ubuntu-latest
@@ -45,10 +50,11 @@ jobs:
 
       - name: Comment PR with visual changes
         if: github.event_name == 'pull_request' && failure()
+        continue-on-error: true
         uses: actions/github-script@v7
         with:
           script: |
-            github.rest.issues.createComment({
+            await github.rest.issues.createComment({
               issue_number: context.issue.number,
               owner: context.repo.owner,
               repo: context.repo.repo,

.storybook/README.md

@@ -1,6 +1,6 @@
-# AuraGlass Storybook
+# AuraGlass by AuraOne Storybook
 
-AuraGlass Storybook is the presentation, QA, and developer-discovery surface for the 3.0 release. It covers the 356-component certified inventory while keeping generated audit coverage separate from curated public showroom examples.
+AuraGlass by AuraOne Storybook is the presentation, QA, and developer-discovery surface for the 3.1 release. It covers the certified component inventory while keeping generated audit coverage separate from curated public showroom examples.
 
 ## Run Locally