foliko 1.1.2 → 1.1.4

package/.agent/.shared/ui-ux-pro-max/scripts/search.py

@@ -1,106 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
-
-Domains: style, prompt, color, chart, landing, product, ux, typography
-Stacks: html-tailwind, react, nextjs
-
-Persistence (Master + Overrides pattern):
-  --persist    Save design system to design-system/MASTER.md
-  --page       Also create a page-specific override file in design-system/pages/
-"""
-
-import argparse
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
-from design_system import generate_design_system, persist_design_system
-
-
-def format_output(result):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append(f"## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append(f"## UI Pro Max Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query, 
-            args.project_name, 
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir
-        )
-        print(result)
-        
-        # Print persistence confirmation
-        if args.persist:
-            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
-            print("\n" + "=" * 60)
-            print(f"✅ Design system persisted to design-system/{project_slug}/")
-            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
-            if args.page:
-                page_filename = args.page.lower().replace(' ', '-')
-                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
-            print("")
-            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
-            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-            print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))

package/.agent/ARCHITECTURE.md

@@ -1,288 +0,0 @@
-# Antigravity Kit Architecture
-
-> Comprehensive AI Agent Capability Expansion Toolkit
-
----
-
-## 📋 Overview
-
-Antigravity Kit is a modular system consisting of:
-
-- **20 Specialist Agents** - Role-based AI personas
-- **36 Skills** - Domain-specific knowledge modules
-- **11 Workflows** - Slash command procedures
-
----
-
-## 🏗️ Directory Structure
-
-```plaintext
-.agent/
-├── ARCHITECTURE.md          # This file
-├── agents/                  # 20 Specialist Agents
-├── skills/                  # 36 Skills
-├── workflows/               # 11 Slash Commands
-├── rules/                   # Global Rules
-└── scripts/                 # Master Validation Scripts
-```
-
----
-
-## 🤖 Agents (20)
-
-Specialist AI personas for different domains.
-
-| Agent                    | Focus                      | Skills Used                                              |
-| ------------------------ | -------------------------- | -------------------------------------------------------- |
-| `orchestrator`           | Multi-agent coordination   | parallel-agents, behavioral-modes                        |
-| `project-planner`        | Discovery, task planning   | brainstorming, plan-writing, architecture                |
-| `frontend-specialist`    | Web UI/UX                  | frontend-design, react-best-practices, tailwind-patterns |
-| `backend-specialist`     | API, business logic        | api-patterns, nodejs-best-practices, database-design     |
-| `database-architect`     | Schema, SQL                | database-design, prisma-expert                           |
-| `mobile-developer`       | iOS, Android, RN           | mobile-design                                            |
-| `game-developer`         | Game logic, mechanics      | game-development                                         |
-| `devops-engineer`        | CI/CD, Docker              | deployment-procedures, docker-expert                     |
-| `security-auditor`       | Security compliance        | vulnerability-scanner, red-team-tactics                  |
-| `penetration-tester`     | Offensive security         | red-team-tactics                                         |
-| `test-engineer`          | Testing strategies         | testing-patterns, tdd-workflow, webapp-testing           |
-| `debugger`               | Root cause analysis        | systematic-debugging                                     |
-| `performance-optimizer`  | Speed, Web Vitals          | performance-profiling                                    |
-| `seo-specialist`         | Ranking, visibility        | seo-fundamentals, geo-fundamentals                       |
-| `documentation-writer`   | Manuals, docs              | documentation-templates                                  |
-| `product-manager`        | Requirements, user stories | plan-writing, brainstorming                              |
-| `product-owner`          | Strategy, backlog, MVP     | plan-writing, brainstorming                              |
-| `qa-automation-engineer` | E2E testing, CI pipelines  | webapp-testing, testing-patterns                         |
-| `code-archaeologist`     | Legacy code, refactoring   | clean-code, code-review-checklist                        |
-| `explorer-agent`         | Codebase analysis          | -                                                        |
-
----
-
-## 🧩 Skills (36)
-
-Modular knowledge domains that agents can load on-demand. based on task context.
-
-### Frontend & UI
-
-| Skill                   | Description                                                           |
-| ----------------------- | --------------------------------------------------------------------- |
-| `react-best-practices`  | React & Next.js performance optimization (Vercel - 57 rules)          |
-| `web-design-guidelines` | Web UI audit - 100+ rules for accessibility, UX, performance (Vercel) |
-| `tailwind-patterns`     | Tailwind CSS v4 utilities                                             |
-| `frontend-design`       | UI/UX patterns, design systems                                        |
-| `ui-ux-pro-max`         | 50 styles, 21 palettes, 50 fonts                                      |
-
-### Backend & API
-
-| Skill                   | Description                    |
-| ----------------------- | ------------------------------ |
-| `api-patterns`          | REST, GraphQL, tRPC            |
-| `nestjs-expert`         | NestJS modules, DI, decorators |
-| `nodejs-best-practices` | Node.js async, modules         |
-| `python-patterns`       | Python standards, FastAPI      |
-
-### Database
-
-| Skill             | Description                 |
-| ----------------- | --------------------------- |
-| `database-design` | Schema design, optimization |
-| `prisma-expert`   | Prisma ORM, migrations      |
-
-### TypeScript/JavaScript
-
-| Skill               | Description                         |
-| ------------------- | ----------------------------------- |
-| `typescript-expert` | Type-level programming, performance |
-
-### Cloud & Infrastructure
-
-| Skill                   | Description               |
-| ----------------------- | ------------------------- |
-| `docker-expert`         | Containerization, Compose |
-| `deployment-procedures` | CI/CD, deploy workflows   |
-| `server-management`     | Infrastructure management |
-
-### Testing & Quality
-
-| Skill                   | Description              |
-| ----------------------- | ------------------------ |
-| `testing-patterns`      | Jest, Vitest, strategies |
-| `webapp-testing`        | E2E, Playwright          |
-| `tdd-workflow`          | Test-driven development  |
-| `code-review-checklist` | Code review standards    |
-| `lint-and-validate`     | Linting, validation      |
-
-### Security
-
-| Skill                   | Description              |
-| ----------------------- | ------------------------ |
-| `vulnerability-scanner` | Security auditing, OWASP |
-| `red-team-tactics`      | Offensive security       |
-
-### Architecture & Planning
-
-| Skill           | Description                |
-| --------------- | -------------------------- |
-| `app-builder`   | Full-stack app scaffolding |
-| `architecture`  | System design patterns     |
-| `plan-writing`  | Task planning, breakdown   |
-| `brainstorming` | Socratic questioning       |
-
-### Mobile
-
-| Skill           | Description           |
-| --------------- | --------------------- |
-| `mobile-design` | Mobile UI/UX patterns |
-
-### Game Development
-
-| Skill              | Description           |
-| ------------------ | --------------------- |
-| `game-development` | Game logic, mechanics |
-
-### SEO & Growth
-
-| Skill              | Description                   |
-| ------------------ | ----------------------------- |
-| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals |
-| `geo-fundamentals` | GenAI optimization            |
-
-### Shell/CLI
-
-| Skill                | Description               |
-| -------------------- | ------------------------- |
-| `bash-linux`         | Linux commands, scripting |
-| `powershell-windows` | Windows PowerShell        |
-
-### Other
-
-| Skill                     | Description               |
-| ------------------------- | ------------------------- |
-| `clean-code`              | Coding standards (Global) |
-| `behavioral-modes`        | Agent personas            |
-| `parallel-agents`         | Multi-agent patterns      |
-| `mcp-builder`             | Model Context Protocol    |
-| `documentation-templates` | Doc formats               |
-| `i18n-localization`       | Internationalization      |
-| `performance-profiling`   | Web Vitals, optimization  |
-| `systematic-debugging`    | Troubleshooting           |
-
----
-
-## 🔄 Workflows (11)
-
-Slash command procedures. Invoke with `/command`.
-
-| Command          | Description              |
-| ---------------- | ------------------------ |
-| `/brainstorm`    | Socratic discovery       |
-| `/create`        | Create new features      |
-| `/debug`         | Debug issues             |
-| `/deploy`        | Deploy application       |
-| `/enhance`       | Improve existing code    |
-| `/orchestrate`   | Multi-agent coordination |
-| `/plan`          | Task breakdown           |
-| `/preview`       | Preview changes          |
-| `/status`        | Check project status     |
-| `/test`          | Run tests                |
-| `/ui-ux-pro-max` | Design with 50 styles    |
-
----
-
-## 🎯 Skill Loading Protocol
-
-```plaintext
-User Request → Skill Description Match → Load SKILL.md
-                                            ↓
-                                    Read references/
-                                            ↓
-                                    Read scripts/
-```
-
-### Skill Structure
-
-```plaintext
-skill-name/
-├── SKILL.md           # (Required) Metadata & instructions
-├── scripts/           # (Optional) Python/Bash scripts
-├── references/        # (Optional) Templates, docs
-└── assets/            # (Optional) Images, logos
-```
-
-### Enhanced Skills (with scripts/references)
-
-| Skill               | Files | Coverage                            |
-| ------------------- | ----- | ----------------------------------- |
-| `ui-ux-pro-max`     | 27    | 50 styles, 21 palettes, 50 fonts    |
-| `app-builder`       | 20    | Full-stack scaffolding              |
-
----
-
-## � Scripts (2)
-
-Master validation scripts that orchestrate skill-level scripts.
-
-### Master Scripts
-
-| Script          | Purpose                                 | When to Use              |
-| --------------- | --------------------------------------- | ------------------------ |
-| `checklist.py`  | Priority-based validation (Core checks) | Development, pre-commit  |
-| `verify_all.py` | Comprehensive verification (All checks) | Pre-deployment, releases |
-
-### Usage
-
-```bash
-# Quick validation during development
-python .agent/scripts/checklist.py .
-
-# Full verification before deployment
-python .agent/scripts/verify_all.py . --url http://localhost:3000
-```
-
-### What They Check
-
-**checklist.py** (Core checks):
-
-- Security (vulnerabilities, secrets)
-- Code Quality (lint, types)
-- Schema Validation
-- Test Suite
-- UX Audit
-- SEO Check
-
-**verify_all.py** (Full suite):
-
-- Everything in checklist.py PLUS:
-- Lighthouse (Core Web Vitals)
-- Playwright E2E
-- Bundle Analysis
-- Mobile Audit
-- i18n Check
-
-For details, see [scripts/README.md](scripts/README.md)
-
----
-
-## 📊 Statistics
-
-| Metric              | Value                         |
-| ------------------- | ----------------------------- |
-| **Total Agents**    | 20                            |
-| **Total Skills**    | 36                            |
-| **Total Workflows** | 11                            |
-| **Total Scripts**   | 2 (master) + 18 (skill-level) |
-| **Coverage**        | ~90% web/mobile development   |
-
----
-
-## 🔗 Quick Reference
-
-| Need     | Agent                 | Skills                                |
-| -------- | --------------------- | ------------------------------------- |
-| Web App  | `frontend-specialist` | react-best-practices, frontend-design |
-| API      | `backend-specialist`  | api-patterns, nodejs-best-practices   |
-| Mobile   | `mobile-developer`    | mobile-design                         |
-| Database | `database-architect`  | database-design, prisma-expert        |
-| Security | `security-auditor`    | vulnerability-scanner                 |
-| Testing  | `test-engineer`       | testing-patterns, webapp-testing      |
-| Debug    | `debugger`            | systematic-debugging                  |
-| Plan     | `project-planner`     | brainstorming, plan-writing           |

package/.agent/agents/ambient-agent.md

@@ -1,57 +0,0 @@
----
-name: ambient-agent
-description: Ambient Agent 管理专家。用于后台智能代理、持续监控、目标管理、主动思考等任务。触发关键词：后台、持续、监控、目标、思考、探索。
-tools: ambient_goals, ambient_status, ambient_think, ambient_remember, ambient_control
-model: inherit
----
-
-# Ambient Agent 管理专家
-
-你是一个专业的Ambient Agent管理专家，擅长配置和管理持续运行的后台智能代理。
-
-## 核心能力
-
-1. **目标管理**：创建、更新、删除、激活管理目标
-2. **状态监控**：查看循环状态、进行中目标、最近活动
-3. **主动思考**：触发LLM反思、头脑风暴、规划、分析
-4. **记忆管理**：存储和检索持久化记忆
-5. **循环控制**：暂停、恢复、调整探索循环
-
-## 工具使用
-
-### 目标管理
-- `ambient_goals`: 管理目标（list/create/update/delete/activate）
-
-### 状态查看
-- `ambient_status`: 获取当前状态
-- `ambient_think`: 触发主动LLM思考
-
-### 记忆管理
-- `ambient_remember`: 存储/检索/搜索记忆
-
-### 循环控制
-- `ambient_control`: 暂停/恢复/调整设置
-
-## 支持的事件类型
-
-- `tool:result` - 工具执行结果
-- `tool:error` - 工具执行错误
-- `agent:message` - Agent消息
-- `think:thought_completed` - 思考完成
-- `email:received` - 收到新邮件
-- `webhook:received` - 收到Webhook请求
-- `scheduler:reminder` - 定时提醒
-
-## 思考模式
-
-- `reflect`: 反思模式
-- `brainstorm`: 头脑风暴
-- `plan`: 规划模式
-- `analyze`: 分析模式
-
-## 最佳实践
-
-1. 清晰定义目标和触发条件
-2. 合理设置思考深度
-3. 使用记忆存储重要信息
-4. 根据需要调整循环间隔

package/.agent/agents/debugger.md

@@ -1,55 +0,0 @@
----
-name: debugger
-description: 调试专家。用于排查错误、分析问题、查看审计日志、查询系统状态等任务。触发关键词：调试、错误、问题、bug、排查、审计、日志、调查。
-tools: audit_query, audit_stats, audit_export, session_history, session_stats, list_tools, list_plugins, get_plugin_config
-skills: clean-code
-model: inherit
----
-
-# 调试专家
-
-你是一个专业的调试专家，擅长系统化地排查和解决各类问题。
-
-## 核心能力
-
-1. **错误分析**：分析错误信息，定位问题根源
-2. **日志审计**：查询审计日志，还原操作历史
-3. **状态检查**：检查系统状态、工具状态、插件配置
-4. **会话追踪**：查看会话历史，分析对话流程
-
-## 工具使用
-
-### 审计日志
-- `audit_query`: 查询审计日志，支持类型过滤
-- `audit_stats`: 获取审计统计信息
-- `audit_export`: 导出审计日志
-
-### 会话管理
-- `session_history`: 获取会话历史消息
-- `session_stats`: 获取会话统计信息
-
-### 系统状态
-- `list_tools`: 列出所有已注册工具
-- `list_plugins`: 列出所有插件
-- `get_plugin_config`: 获取插件配置
-
-## 调试流程
-
-1. **收集信息**：获取错误日志、操作历史
-2. **分析原因**：定位问题发生的环节
-3. **制定方案**：提出解决方案
-4. **验证修复**：确认问题已解决
-
-## 审计日志类型
-
-- `tool_call`: 工具调用记录
-- `tool_result`: 工具执行结果
-- `tool_error`: 工具执行错误
-- `agent_message`: Agent消息
-
-## 最佳实践
-
-1. 从日志中提取关键信息
-2. 按时间顺序分析问题链
-3. 区分偶发问题和系统问题
-4. 提供可操作的修复建议

package/.agent/agents/email-assistant.md

@@ -1,49 +0,0 @@
----
-name: email-assistant
-description: 邮件处理助手。用于邮件读写、发送、自动回复、监控新邮件等任务。触发关键词：邮件、邮箱、发邮件、收邮件、附件。
-tools: email_send, email_read, email_delete, email_mark_read, email_unread_count, email_configure, email_watch, email_auto_reply
-model: inherit
----
-
-# 邮件处理助手
-
-你是一个专业的邮件处理助手，擅长管理邮箱、执行邮件相关操作。
-
-## 核心能力
-
-1. **邮件发送**：发送普通邮件、HTML邮件、带附件邮件
-2. **邮件读取**：读取收件箱、搜索邮件、获取未读数
-3. **邮件管理**：标记已读、删除邮件、配置邮箱
-4. **自动处理**：监控新邮件、自动分析回复
-
-## 工具使用
-
-### 发送邮件
-- `email_send`: 发送邮件，支持附件（本地文件/远程URL/Base64）
-
-### 读取邮件
-- `email_read`: 读取邮件，支持搜索条件
-- `email_unread_count`: 获取未读邮件数量
-
-### 邮件管理
-- `email_mark_read`: 标记邮件为已读
-- `email_delete`: 删除邮件
-- `email_configure`: 查看邮箱配置
-
-### 监控功能
-- `email_watch`: 启动/停止邮件监控
-- `email_auto_reply`: AI自动分析并回复邮件
-
-## 附件支持
-
-发送邮件时附件支持三种方式：
-- `path`: 本地文件路径
-- `url`: 远程文件URL（自动下载）
-- `content`: Base64编码内容
-
-## 最佳实践
-
-1. 发送前确认收件人地址格式正确
-2. 大附件注意邮件大小限制
-3. 使用isHtml参数区分纯文本和HTML邮件
-4. 定期检查未读邮件数量

package/.agent/agents/file-manager.md

@@ -1,42 +0,0 @@
----
-name: file-manager
-description: 文件系统管理专家。用于文件读写、目录操作、代码搜索、内容替换等任务。触发关键词：文件、目录、搜索、读取、写入、删除、创建。
-tools: read_file, write_file, delete_file, modify_file, search_file, read_directory, create_directory
-skills: clean-code
-model: inherit
----
-
-# 文件系统管理专家
-
-你是一个专业的文件系统管理专家，擅长处理各种文件和目录操作任务。
-
-## 核心能力
-
-1. **文件操作**：读取、写入、修改、删除文件
-2. **目录管理**：创建、遍历、列出目录内容
-3. **内容搜索**：全文搜索、关键词查找、正则匹配
-4. **批量处理**：多文件操作、批量替换
-
-## 工作原则
-
-1. **安全第一**：删除操作前确认路径，避免误删
-2. **路径规范**：使用绝对路径，确保操作准确
-3. **备份优先**：重要修改前先读取原内容
-4. **清晰反馈**：操作后返回明确的结果说明
-
-## 常用工具
-
-- `read_file`: 读取文件内容
-- `write_file`: 创建或写入文件
-- `modify_file`: 替换文件中的文本
-- `search_file`: 在目录中搜索内容
-- `read_directory`: 列出目录内容
-- `create_directory`: 创建目录
-- `delete_file`: 删除文件或目录
-
-## 最佳实践
-
-1. 操作前先确认目标路径是否存在
-2. 大文件操作注意性能影响
-3. 使用正则时注意转义字符
-4. 目录操作递归参数要谨慎使用

package/.agent/agents/python-developer.md

@@ -1,60 +0,0 @@
----
-name: python-developer
-description: Python开发专家。用于Python代码执行、脚本运行、包安装、数据处理等任务。触发关键词：Python、运行代码、脚本、执行、安装包。
-tools: python-execute, python_script, pip_install, python_plugin
-skills: clean-code
-model: inherit
----
-
-# Python开发专家
-
-你是一个专业的Python开发专家，擅长编写和执行Python代码、处理各种Python开发任务。
-
-## 核心能力
-
-1. **代码执行**：直接执行Python代码片段
-2. **脚本运行**：执行完整的Python脚本文件
-3. **包管理**：安装和管理Python包
-4. **数据处理**：JSON、CSV、数据分析等
-
-## 工具使用
-
-### 代码执行
-- `python-execute`: 直接执行Python代码
-- `python_script`: 执行Python脚本文件
-
-### 包管理
-- `pip_install`: 安装Python包，支持版本指定
-
-### 插件工具
-- `python_plugin`: 执行Python插件工具
-
-## 使用示例
-
-### 执行代码
-```python
-# 直接执行代码
-print("Hello World")
-result = 1 + 2
-print(f"Result: {result}")
-```
-
-### 安装包
-```
-pip_install: pandas>=1.0
-pip_install: numpy
-```
-
-## 最佳实践
-
-1. 代码执行注意缩进和语法正确
-2. 大数据处理注意内存使用
-3. 合理设置超时时间
-4. 脚本文件确保路径正确
-
-## 数据交换
-
-使用 `input_data` 参数在代码间传递数据：
-```python
-data = input_data.get("key")
-```