@miniidealab/openlogos 0.9.27 → 0.9.28

package/dist/lib/project-yaml.js

@@ -0,0 +1,224 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml, parseDocument } from 'yaml';
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const items = value.filter((item) => typeof item === 'string');
+    return items;
+}
+function asBoolean(value) {
+    return typeof value === 'boolean' ? value : undefined;
+}
+function asNodeJson(node) {
+    if (!node || typeof node !== 'object')
+        return undefined;
+    const toJSON = node.toJSON;
+    if (typeof toJSON !== 'function')
+        return undefined;
+    try {
+        return toJSON.call(node, null, {});
+    }
+    catch {
+        return undefined;
+    }
+}
+function collectMessages(...values) {
+    const messages = new Set();
+    for (const value of values) {
+        const message = value instanceof Error
+            ? value.message
+            : typeof value === 'string'
+                ? value
+                : value && typeof value === 'object' && 'message' in value
+                    ? String(value.message ?? '')
+                    : String(value ?? '');
+        const trimmed = message.trim();
+        if (trimmed)
+            messages.add(trimmed);
+    }
+    return Array.from(messages);
+}
+function normalizeModule(raw) {
+    const record = asRecord(raw);
+    if (!record || typeof record.id !== 'string' || typeof record.name !== 'string')
+        return null;
+    const module = {
+        id: record.id,
+        name: record.name,
+    };
+    if (typeof record.lifecycle === 'string') {
+        module.lifecycle = record.lifecycle;
+    }
+    const skipPhases = asStringArray(record.skip_phases);
+    if (skipPhases) {
+        module.skip_phases = skipPhases;
+    }
+    const deploymentRequired = asBoolean(record.deployment_required);
+    if (deploymentRequired !== undefined) {
+        module.deployment_required = deploymentRequired;
+    }
+    const smokeRequired = asBoolean(record.smoke_required);
+    if (smokeRequired !== undefined) {
+        module.smoke_required = smokeRequired;
+    }
+    return module;
+}
+function normalizeScenario(raw) {
+    const record = asRecord(raw);
+    if (!record || typeof record.id !== 'string')
+        return null;
+    const scenario = { id: record.id };
+    if (typeof record.module === 'string') {
+        scenario.module = record.module;
+    }
+    return scenario;
+}
+function normalizeDeploymentGate(raw) {
+    const record = asRecord(raw);
+    if (!record)
+        return null;
+    const gate = {};
+    const deploymentRequired = asBoolean(record.deployment_required);
+    if (deploymentRequired !== undefined) {
+        gate.deployment_required = deploymentRequired;
+    }
+    const smokeRequired = asBoolean(record.smoke_required);
+    if (smokeRequired !== undefined) {
+        gate.smoke_required = smokeRequired;
+    }
+    const environments = asStringArray(record.environments);
+    if (environments) {
+        gate.environments = environments;
+    }
+    return Object.keys(gate).length > 0 ? gate : null;
+}
+function normalizeProjectYaml(raw) {
+    const record = asRecord(raw);
+    if (!record)
+        return null;
+    const data = {};
+    const modules = Array.isArray(record.modules)
+        ? record.modules.map(normalizeModule).filter((item) => item !== null)
+        : undefined;
+    if (modules !== undefined) {
+        data.modules = modules;
+    }
+    const scenarios = Array.isArray(record.scenarios)
+        ? record.scenarios.map(normalizeScenario).filter((item) => item !== null)
+        : undefined;
+    if (scenarios !== undefined) {
+        data.scenarios = scenarios;
+    }
+    const deploymentGates = asRecord(record.deployment_gates);
+    if (deploymentGates) {
+        const normalized = {};
+        for (const [moduleId, gate] of Object.entries(deploymentGates)) {
+            const normalizedGate = normalizeDeploymentGate(gate);
+            if (normalizedGate) {
+                normalized[moduleId] = normalizedGate;
+            }
+        }
+        if (Object.keys(normalized).length > 0) {
+            data.deployment_gates = normalized;
+        }
+    }
+    return Object.keys(data).length > 0 ? data : null;
+}
+function recoverProjectYamlData(content) {
+    const doc = parseDocument(content);
+    const recoveredFields = [];
+    const data = {};
+    let hasRecoveredModules = false;
+    const rawModules = asNodeJson(doc.get('modules', true));
+    const modules = Array.isArray(rawModules)
+        ? rawModules.map(normalizeModule).filter((item) => item !== null)
+        : undefined;
+    if (modules !== undefined) {
+        if (modules.length > 0) {
+            data.modules = modules;
+            recoveredFields.push('modules');
+            hasRecoveredModules = true;
+        }
+    }
+    else if (rawModules !== undefined) {
+        recoveredFields.push('modules');
+    }
+    const rawScenarios = asNodeJson(doc.get('scenarios', true));
+    const scenarios = Array.isArray(rawScenarios)
+        ? rawScenarios.map(normalizeScenario).filter((item) => item !== null)
+        : undefined;
+    if (scenarios !== undefined) {
+        data.scenarios = scenarios;
+        recoveredFields.push('scenarios');
+    }
+    const rawDeploymentGates = asNodeJson(doc.get('deployment_gates', true));
+    const deploymentGatesRecord = asRecord(rawDeploymentGates);
+    if (deploymentGatesRecord) {
+        const normalized = {};
+        for (const [moduleId, gate] of Object.entries(deploymentGatesRecord)) {
+            const normalizedGate = normalizeDeploymentGate(gate);
+            if (normalizedGate) {
+                normalized[moduleId] = normalizedGate;
+            }
+        }
+        if (Object.keys(normalized).length > 0) {
+            data.deployment_gates = normalized;
+            recoveredFields.push('deployment_gates');
+        }
+    }
+    return {
+        data: Object.keys(data).length > 0 ? data : null,
+        recovered_fields: recoveredFields,
+        has_recovered_modules: hasRecoveredModules,
+        messages: collectMessages('logos-project.yaml 存在可恢复的解析错误', ...doc.errors.map(error => error?.message ?? error)),
+    };
+}
+function buildDiagnostics(status, messages, recoveredFields = [], hasRecoveredModules = false) {
+    const finalMessages = [...messages];
+    if (status === 'recovered' && recoveredFields.length > 0) {
+        finalMessages.push(`已从 AST 恢复：${recoveredFields.join('、')}`);
+    }
+    if (status === 'error' && !hasRecoveredModules) {
+        finalMessages.push('无法从 AST 恢复 modules');
+    }
+    return {
+        parse_status: status,
+        messages: finalMessages,
+    };
+}
+export function readProjectYaml(root) {
+    const yamlPath = join(root, 'logos', 'logos-project.yaml');
+    if (!existsSync(yamlPath)) {
+        return {
+            exists: false,
+            data: null,
+            yaml_diagnostics: null,
+        };
+    }
+    const content = readFileSync(yamlPath, 'utf-8');
+    try {
+        return {
+            exists: true,
+            data: normalizeProjectYaml(parseYaml(content)),
+            yaml_diagnostics: null,
+        };
+    }
+    catch (error) {
+        const recovered = recoverProjectYamlData(content);
+        const status = recovered.has_recovered_modules
+            ? 'recovered'
+            : 'error';
+        return {
+            exists: true,
+            data: recovered.data,
+            yaml_diagnostics: buildDiagnostics(status, collectMessages(error, ...recovered.messages), recovered.recovered_fields, recovered.has_recovered_modules),
+        };
+    }
+}
+//# sourceMappingURL=project-yaml.js.map

package/dist/lib/project-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-yaml.js","sourceRoot":"","sources":["../../src/lib/project-yaml.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miniidealab/openlogos",
-  "version": "0.9.27",
+  "version": "0.9.28",
   "description": "CLI tool for the OpenLogos software engineering methodology",
   "type": "module",
   "bin": {

package/skills/product-designer/SKILL.en.md

@@ -29,6 +29,7 @@ Before executing this Skill, first determine the product type (inferred from the
 | **AI Skills / Conversational Product** | User interacts with AI via natural language | Dialogue flowchart + sample dialogue scripts | Dialogue steps, AI questioning strategy, deliverable format |
 | **Library / SDK** | Called by other programs | API usage examples (code snippets) | Public interfaces, parameter design, return values, error codes |
 | **Mobile Application** | Mobile UI | HTML pages (mobile viewport) | Gesture interaction, navigation patterns, offline state |
+| **Desktop Application** | Locally installed, has GUI, standalone window (Electron / Tauri / SwiftUI / Jetpack Compose / Qt / WPF / GTK, etc.) | HTML simulating desktop layout (with menu bar / toolbar / status bar) or stack-specific style guide | Window management, menu bar / context menu, keyboard shortcuts, system tray, multi-window coordination, file system interaction |
 | **Hybrid** | Combination of multiple deliverables | Select the corresponding format for each deliverable | Interaction handoffs between deliverables |
 
 ## Execution Steps
@@ -52,6 +53,7 @@ Design architecture at different levels based on the product type:
 - **CLI Tool**: Command tree structure, subcommand hierarchy, global options
 - **AI Skills**: Skill trigger relationships, dialogue step orchestration, deliverable dependency chain
 - **Library / SDK**: Module structure, public API grouping
+- **Desktop Application**: Window structure, menu / shortcut system, IPC design (main↔renderer process / native layers), local storage and file system
 
 ### Step 3: Refine Interaction Specifications Per Scenario
 
@@ -63,7 +65,30 @@ Building on the Phase 1 GIVEN/WHEN/THEN, refine down to the interaction element
 
 ### Step 5: Generate Prototypes
 
-Generate prototypes in the format corresponding to the product type (see examples).
+#### Step 5a (GUI Products Only): Invoke ui-ux-pro-max to Get the Design System
+
+**When to apply**: Any product type whose deliverables include a graphical user interface (GUI)—
+- ✅ Trigger: Web Application / Mobile Application / Desktop Application (Electron / Tauri / SwiftUI / Jetpack Compose / Qt / WPF / GTK, etc.) / Hybrid products with GUI deliverables
+- ❌ Skip: Pure CLI Tool / Library / AI Skills / pure API service or any product type without GUI deliverables
+
+**Steps**:
+
+1. Extract keywords from the Phase 1 requirements document: product type (SaaS / e-commerce / dashboard / portfolio, etc.) + industry + style preferences
+2. Invoke `ui-ux-pro-max`:
+   ```bash
+   python3 logos/skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <style_keywords>" --design-system -p "<project_name>"
+   ```
+3. Consume the output: style + color palette + font pairing + landing page patterns + anti-patterns as the visual foundation for Step 5 prototype generation
+   - Web Application: implement the style guide in HTML
+   - Desktop / Mobile Application: produce a style guide per the corresponding tech stack (Electron / Tauri reuse react / shadcn / html-tailwind data; SwiftUI / Jetpack Compose / Flutter map directly to their stack data; other native stacks use stack-agnostic style/color/font recommendations)
+
+**Fallback**:
+
+If `python3` is unavailable, skip this step and inform the user: "Python 3 (required by ui-ux-pro-max) is not detected. The prototype will be generated using a generic style. Install Python 3 and retry to get professional design system recommendations." Continue with Step 5 using a generic style; do not block.
+
+#### Step 5b: Generate Prototypes per Product Type
+
+Generate prototypes in the format corresponding to the product type (see examples). For GUI products, build on the design system obtained in Step 5a; for non-GUI products, pick the prototype format directly by product type.
 
 ### Step 6: Output the Product Design Document
 

package/skills/product-designer/SKILL.md

@@ -29,6 +29,7 @@
 | **AI Skills / 对话式产品** | 用户通过自然语言与 AI 交互 | 对话流程图 + 示例对话脚本 | 对话步骤、AI 提问策略、产出物格式 |
 | **库 / SDK** | 被其他程序调用 | API 使用示例（代码片段） | 公开接口、参数设计、返回值、错误码 |
 | **移动应用** | 手机端 UI | HTML 页面（移动视口） | 手势交互、导航模式、离线状态 |
+| **桌面应用** | 本地安装、含 GUI、独立窗口（Electron / Tauri / SwiftUI / Jetpack Compose / Qt / WPF / GTK 等） | HTML 模拟桌面布局（含菜单栏 / 工具栏 / 状态栏）或对应栈风格指南 | 窗口管理、菜单栏 / 上下文菜单、快捷键、系统托盘、多窗口协作、文件系统交互 |
 | **混合型** | 多种交付物组合 | 按交付物分别选择对应形式 | 各交付物间的交互衔接 |
 
 ## 执行步骤
@@ -52,6 +53,7 @@
 - **CLI 工具**：命令树结构、子命令层级、全局选项
 - **AI Skills**：Skill 触发关系、对话步骤编排、产出物依赖链
 - **库 / SDK**：模块结构、公开 API 分组
+- **桌面应用**：窗口结构、菜单 / 快捷键体系、IPC 设计（主进程↔渲染进程 / 各 native 层）、本地存储与文件系统
 
 ### Step 3: 逐场景细化交互规格
 
@@ -63,7 +65,30 @@
 
 ### Step 5: 生成原型
 
-根据产品类型生成对应形式的原型（见示例）。
+#### Step 5a（仅 GUI 类产品）：调用 ui-ux-pro-max 获取设计系统
+
+**适用条件**：凡产品交付物中包含图形用户界面（GUI）的产品类型——
+- ✅ 触发：Web 应用 / 移动应用 / 桌面应用（Electron / Tauri / SwiftUI / Jetpack Compose / Qt / WPF / GTK 等）/ 混合型中含 GUI 交付物的部分
+- ❌ 不触发：纯 CLI 工具 / Library / AI Skills / 纯 API 服务 等无 GUI 交付物的产品
+
+**执行步骤**：
+
+1. 从 Phase 1 需求文档提取关键词：产品类型（SaaS / e-commerce / dashboard / portfolio 等）+ 行业 + 风格倾向
+2. 调用 `ui-ux-pro-max`：
+   ```bash
+   python3 logos/skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <style_keywords>" --design-system -p "<项目名>"
+   ```
+3. 消费输出：风格 + 调色板 + 字体配对 + 登陆页模式 + 反模式清单作为 Step 5 生成原型的视觉基础
+   - Web 应用：用 HTML 实现风格指南
+   - 桌面 / 移动应用：按对应技术栈输出风格指南（Electron / Tauri 直接复用 react / shadcn / html-tailwind 数据；SwiftUI / Jetpack Compose / Flutter 直接命中对应 stack 数据；其余 native 栈使用 stack 无关的风格/配色/字体推荐）
+
+**降级路径**：
+
+检测不到 `python3` 时跳过本步并提示用户「检测到 ui-ux-pro-max 依赖的 Python 3 不可用。原型将使用通用风格生成。如需专业级设计系统建议，请安装 Python 3 后重试。」原型用通用风格继续生成，不阻塞 Step 5。
+
+#### Step 5b：根据产品类型生成对应形式的原型
+
+根据产品类型生成对应形式的原型（见示例）。GUI 类产品在 Step 5a 已获取设计系统的基础上落地视觉/交互；非 GUI 类产品直接按产品类型选择对应原型形式。
 
 ### Step 6: 输出产品设计文档
 

package/skills/ui-ux-pro-max/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Next Level Builder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.