fix: entire hook compatibility and test updates

.agents/README.md

@@ -0,0 +1,15 @@
+# Agent Assets
+
+This directory is the canonical home for reusable repository-scoped agent assets.
+
+## Layout
+
+- `skills/claude/prompts.chat/` contains the prompts.chat Claude-facing skills that are exposed from `/.well-known/skills`.
+- `skills/windsurf/` contains Windsurf-compatible skills from the same repository source of truth.
+
+## Compatibility Paths
+
+- `plugins/claude/prompts.chat/skills` is preserved as a symlink for Claude plugin consumers.
+- `.windsurf/skills` is preserved as a symlink for Windsurf consumers.
+
+When adding or updating reusable skills, edit the files in `.agents/skills/` first.

.dockerignore

@@ -10,7 +10,6 @@ dist
 # Git
 .git
 .gitignore
-.gitattributes
 
 # IDE
 .vscode
@@ -24,11 +23,10 @@ dist
 .env.development.local
 .env.test.local
 .env.production.local
-.env.sentry-build-plugin
 
 # Docker
-compose.yml
 docker-compose*.yml
+Dockerfile*
 
 # Development files
 .github
@@ -40,8 +38,6 @@ packages
 # Test files
 coverage
 .nyc_output
-vitest.config.ts
-vitest.setup.ts
 
 # OS files
 .DS_Store

.env.example

@@ -7,7 +7,12 @@ DATABASE_URL="postgresql://postgres:postgres@localhost:5432/prompts_chat?schema=
 
 # NextAuth
 NEXTAUTH_URL="http://localhost:3000"
-NEXTAUTH_SECRET="your-super-secret-key-change-in-production"
+AUTH_URL="http://localhost:3000"
+AUTH_SECRET="your-super-secret-key-change-in-production"
+
+# Admin Access Control
+# Admin access is controlled by the `role` field in the database.
+# Set a user's role to ADMIN via the Admin panel or directly in the DB.
 
 # OAuth Providers (optional - enable in prompts.config.ts)
 # GOOGLE_CLIENT_ID=""
@@ -42,9 +47,14 @@ NEXTAUTH_SECRET="your-super-secret-key-change-in-production"
 # OPENAI_API_KEY=your_openai_api_key
 # OPENAI_BASE_URL=https://api.openai.com/v1  # Optional: custom base URL for OpenAI-compatible APIs
 # OPENAI_EMBEDDING_MODEL=text-embedding-3-small  # Optional: embedding model for AI search
-# OPENAI_GENERATIVE_MODEL=gpt-4o-mini  # Optional: generative model for AI generation
+# OPENAI_GENERATIVE_MODEL=gpt-4o-mini  # Optional: model for AI generation features
 # OPENAI_TRANSLATION_MODEL=gpt-4o-mini  # Optional: model for translating non-English search queries
 
+# GitHub Models API (REQUIRED for internal hack description generation)
+# Get a free token from https://github.com/marketplace/models
+# The system will throw an error if this is missing when creating internal hacks
+GITHUB_MODELS_TOKEN=your_github_token_here
+
 # GOOGLE_ANALYTICS_ID="G-XXXXXXXXX"
 
 # Logging (optional)
@@ -66,5 +76,51 @@ CRON_SECRET="your-secret-key-here"
 # SENTRY_AUTH_TOKEN=sentry-auth-token
 
 # GOOGLE_ADSENSE_ACCOUNT=ca-pub-xxxxxxxxxxxxxxxx
-# NEXT_PUBLIC_EZOIC_ENABLED=true
-# EZOIC_SITE_DOMAIN=prompts.chat
+
+# ==============================================================================
+# SSO Authentication Configurations
+# 
+# Why two generic providers (OIDC vs OAuth 2.0)?
+# - "OIDC" (OpenID Connect) performs strict cryptographic validation on the 
+#   ID Token (verifying 'aud' matching the client ID, 'iss' matching issuer, etc).
+#   Use this for standard providers like Google, Auth0, Okta, Keycloak.
+# - "OAuth 2.0" bypasses strict OIDC validation. Use this for legacy or 
+#   enterprise systems that do not return OIDC ID Tokens
+# ==============================================================================
+
+# Generic OIDC Config (Strict Validation)
+# ⚠️ Ensure you add "oidc" to the `providers` array in your prompts.config.ts file
+# Callback URL to whitelist: <your-domain>/api/auth/callback/oidc
+# AUTH_OIDC_ID="dummy-oidc-client-id"
+# AUTH_OIDC_SECRET="dummy-oidc-client-secret"
+# AUTH_OIDC_ISSUER="https://oidc.example.com"
+# AUTH_OIDC_WELLKNOWN="https://oidc.example.com/.well-known/openid-configuration"
+# AUTH_OIDC_SCOPE="openid email profile"
+# AUTH_OIDC_NAME="Company OIDC"
+# Optional overrides (uncomment to use):
+# AUTH_OIDC_LOGO="https://your-domain.com/oidc-logo.png" # Local path or full URL to button image
+# AUTH_OIDC_AUTHORIZATION_URL="https://oidc.example.com/authorize"
+# AUTH_OIDC_TOKEN_URL="https://oidc.example.com/token"
+# AUTH_OIDC_USERINFO_URL="https://oidc.example.com/userinfo"
+# AUTH_OIDC_JWKS_URL="https://oidc.example.com/jwks"
+# AUTH_OIDC_TOKEN_AUTH_METHOD="client_secret_post" # Allowed values: "client_secret_basic", "client_secret_post", "none"
+# AUTH_OIDC_ENABLE_PKCE="true" # PKCE is enabled by default. Set to "false" to disable.
+
+# Generic OAuth 2.0 Config (Loose Validation)
+# ⚠️ Ensure you add "oauth" to the `providers` array in your prompts.config.ts file
+# Callback URL to whitelist: <your-domain>/api/auth/callback/oauth
+# AUTH_OAUTH_ID="dummy-oauth-client-id"
+# AUTH_OAUTH_SECRET="dummy-oauth-client-secret"
+# AUTH_OAUTH_ISSUER="https://sso.example.com"
+# AUTH_OAUTH_WELLKNOWN="https://sso.example.com/.well-known/openid-configuration"
+# AUTH_OAUTH_SCOPE="email profile"
+# AUTH_OAUTH_NAME="Company SSO"
+# Optional overrides (uncomment to use):
+# AUTH_OAUTH_LOGO="https://your-domain.com/sso-logo.png" # Local path or full URL to button image
+# AUTH_OAUTH_AUTHORIZATION_URL="https://sso.example.com/authorize"
+# AUTH_OAUTH_TOKEN_URL="https://sso.example.com/token"
+# AUTH_OAUTH_USERINFO_URL="https://sso.example.com/userinfo"
+# AUTH_OAUTH_JWKS_URL="https://sso.example.com/jwks"
+# AUTH_OAUTH_TOKEN_AUTH_METHOD="client_secret_basic" # Allowed values: "client_secret_basic", "client_secret_post", "none"
+# AUTH_OAUTH_ENABLE_PKCE="true" # PKCE is enabled by default. Set to "false" to disable.
+

.github/README.md

@@ -0,0 +1,102 @@
+<h1 align="center">
+  <a href="https://s8promptbar.vercel.com">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://prompts.chat/logo-dark.svg">
+      <img height="60" alt="s8promptbar.vercel.com" src="https://prompts.chat/logo.svg">
+    </picture>
+    <br>
+    The AIRStack PromptBar
+  </a>
+</h1>
+
+<p align="center">
+  <strong>A better, team-focused open-source prompt.chat fork for AI</strong><br>
+  <sub>Works with ChatGPT, Claude, Gemini, Llama, Mistral, and more</sub>
+</p>
+
+<p align="center">
+  <a href="https://s8promptbar.vercel.com"><img src="https://img.shields.io/badge/Website-prompts.chat-blue?style=flat-square" alt="Website"></a>
+  <a href="https://deepwiki.com/solution8-com/S8-Utility-Promptschat"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
+</p>
+
+<p align="center">
+  <a href="https://s8promptbar.vercel.com">🌐 Browse Content</a>
+</p>
+
+<p align="center">
+  <sub>
+    🏆 Featured in <a href="https://www.forbes.com/sites/tjmccue/2023/01/19/chatgpt-success-completely-depends-on-your-prompt/">Forbes</a> · 
+    🎓 Referenced by <a href="https://www.huit.harvard.edu/news/ai-prompts">Harvard</a>, <a href="https://etc.cuit.columbia.edu/news/columbia-prompt-library-effective-academic-ai-use">Columbia</a> · 
+    📄 <a href="https://scholar.google.com/citations?user=AZ0Dg8YAAAAJ&hl=en">40+ academic citations</a> · 
+  </sub>
+</p>
+
+---
+
+## What is this?
+
+A community-curated SOTA prompt, skill and workflow-sharing platform for use with LLMs.
+
+---
+
+## 🎮 Prompting for Kids
+
+<p>
+  <a href="https://prompts.chat/kids">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://prompts.chat/promi-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://prompts.chat/promi.svg">
+      <img height="60" alt="Promi" src="https://prompts.chat/promi.svg" align="left">
+    </picture>
+  </a>
+</p>
+
+An interactive, game-based adventure to teach children (ages 8-14) how to communicate with AI through fun puzzles and stories.
+
+**[Start Playing →](https://prompts.chat/kids)**
+
+<br clear="left">
+
+---
+
+## 🔌 Integrations
+
+### CLI
+```bash
+npx prompts.chat
+```
+
+### Claude Code Plugin
+```
+/plugin marketplace add f/prompts.chat
+/plugin install prompts.chat@prompts.chat
+```
+📖 [Plugin Documentation](https://github.com/solution8-com/S8-Utility-Promptschat/blob/main/CLAUDE-PLUGIN.md)
+
+### MCP Server
+Use prompts.chat as an MCP server in your AI tools.
+
+**Remote (recommended):**
+```json
+{
+  "mcpServers": {
+    "prompts.chat": {
+      "url": "https://s8promptbar.vercel.com/api/mcp"
+    }
+  }
+}
+```
+
+**Local:**
+```json
+{
+  "mcpServers": {
+    "prompts.chat": {
+      "command": "npx",
+      "args": ["-y", "s8promptbar.vercel.com", "mcp"]
+    }
+  }
+}
+```
+
+📖 [MCP Documentation](https://prompts.chat/docs/api)