codexmate 0.0.13 → 0.0.15

package/doc/CHANGELOG.md

@@ -1,4 +1,15 @@
-# Changelog
+# Changelog
+
+## 0.0.15
+
+- Release: bump package version to 0.0.15
+- Docs: sync README / README.en with current release marker
+
+## 0.0.14
+
+- Skills Manager: polish modal layout with overview counters and clearer section structure
+- Skills Manager: unify status select style and refine list scrollbar density
+- Docs: sync README / README.en release notes for 0.0.14
 
 ## 0.0.13
 
@@ -18,3 +29,4 @@
 - Added OpenClaw config mode with JSON5 profiles and one-click apply
 - Added OpenClaw workspace AGENTS.md management
 - Added JSON5 parsing dependency
+

package/doc/CHANGELOG.zh-CN.md

@@ -1,5 +1,18 @@
 # 更新日志
 
+## 0.0.15
+
+- 发版：版本提升至 0.0.15
+- 文档：同步 README / README.en 当前版本标记
+
+
+
+## 0.0.14
+
+- Skills 管理：打磨弹窗信息层级，新增统计概览与分区结构
+- Skills 管理：统一状态下拉样式，并优化列表滚动条密度
+- 文档：同步 README / README.en 的 0.0.14 发版说明
+
 ## 0.0.13
 
 - Web UI：调整为 IDE 风格三栏布局，并新增固定可见的状态检查器
@@ -18,3 +31,4 @@
 - 新增 OpenClaw 配置模式（JSON5 多配置管理 + 一键应用）
 - 新增 OpenClaw Workspace 的 AGENTS.md 管理
 - 增加 JSON5 解析依赖
+

package/lib/cli-utils.js

@@ -71,6 +71,20 @@ function isValidProviderName(name) {
     return typeof name === 'string' && /^[a-zA-Z0-9._-]+$/.test(name.trim());
 }
 
+function escapeTomlBasicString(value) {
+    return String(value || '')
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"');
+}
+
+function buildModelProviderTableHeader(providerName) {
+    const raw = typeof providerName === 'string' ? providerName.trim() : '';
+    if (/^[a-zA-Z0-9_-]+$/.test(raw)) {
+        return `[model_providers.${raw}]`;
+    }
+    return `[model_providers."${escapeTomlBasicString(raw)}"]`;
+}
+
 function buildModelsCandidates(baseUrl) {
     const trimmed = typeof baseUrl === 'string' ? baseUrl.trim() : '';
     if (!trimmed) return [];
@@ -132,6 +146,8 @@ module.exports = {
     detectLineEnding,
     normalizeLineEnding,
     isValidProviderName,
+    escapeTomlBasicString,
+    buildModelProviderTableHeader,
     buildModelsCandidates,
     isValidHttpUrl,
     normalizeBaseUrl,

package/lib/workflow-engine.js

@@ -0,0 +1,340 @@
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+function getPathValue(source, path) {
+    if (!path || typeof path !== 'string') {
+        return undefined;
+    }
+    const parts = path
+        .split('.')
+        .map((part) => part.trim())
+        .filter(Boolean);
+    let current = source;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (Array.isArray(current)) {
+            const index = Number.parseInt(part, 10);
+            if (!Number.isFinite(index)) {
+                return undefined;
+            }
+            current = current[index];
+            continue;
+        }
+        if (!isPlainObject(current)) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+
+function resolveTemplateString(template, context) {
+    if (typeof template !== 'string') {
+        return template;
+    }
+    const direct = template.match(/^\{\{\s*([^{}]+?)\s*\}\}$/);
+    if (direct) {
+        return getPathValue(context, direct[1].trim());
+    }
+
+    const pattern = /\{\{\s*([^{}]+?)\s*\}\}/g;
+    return template.replace(pattern, (_, rawPath) => {
+        const value = getPathValue(context, String(rawPath || '').trim());
+        if (value === undefined || value === null) {
+            return '';
+        }
+        if (typeof value === 'object') {
+            try {
+                return JSON.stringify(value);
+            } catch (_) {
+                return '';
+            }
+        }
+        return String(value);
+    });
+}
+
+function resolveTemplateValue(value, context) {
+    if (Array.isArray(value)) {
+        return value.map((item) => resolveTemplateValue(item, context));
+    }
+    if (isPlainObject(value)) {
+        const result = {};
+        for (const [key, item] of Object.entries(value)) {
+            result[key] = resolveTemplateValue(item, context);
+        }
+        return result;
+    }
+    if (typeof value === 'string') {
+        return resolveTemplateString(value, context);
+    }
+    return value;
+}
+
+function evaluateStepCondition(condition, context) {
+    if (!condition) {
+        return true;
+    }
+    if (!isPlainObject(condition)) {
+        return !!condition;
+    }
+    const path = typeof condition.path === 'string' ? condition.path.trim() : '';
+    if (!path) {
+        return true;
+    }
+    const value = getPathValue(context, path);
+    if (Object.prototype.hasOwnProperty.call(condition, 'equals')) {
+        return value === condition.equals;
+    }
+    if (Object.prototype.hasOwnProperty.call(condition, 'notEquals')) {
+        return value !== condition.notEquals;
+    }
+    if (Object.prototype.hasOwnProperty.call(condition, 'truthy')) {
+        return condition.truthy ? !!value : !value;
+    }
+    if (Object.prototype.hasOwnProperty.call(condition, 'exists')) {
+        return condition.exists ? value !== undefined : value === undefined;
+    }
+    return !!value;
+}
+
+function isFailurePayload(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return false;
+    }
+    if (typeof payload.error === 'string' && payload.error.trim()) {
+        return true;
+    }
+    if (payload.success === false) {
+        return true;
+    }
+    return false;
+}
+
+function toIso(value) {
+    const date = value ? new Date(value) : new Date();
+    if (Number.isNaN(date.getTime())) {
+        return '';
+    }
+    return date.toISOString();
+}
+
+function validateWorkflowDefinition(definition, options = {}) {
+    const issues = [];
+    const knownTools = options.knownTools instanceof Set ? options.knownTools : new Set();
+
+    if (!definition || !isPlainObject(definition)) {
+        return { ok: false, issues: [{ code: 'workflow-invalid', message: 'workflow must be an object' }] };
+    }
+
+    const id = typeof definition.id === 'string' ? definition.id.trim() : '';
+    if (!id) {
+        issues.push({ code: 'workflow-id-required', message: 'workflow.id is required' });
+    }
+    const steps = Array.isArray(definition.steps) ? definition.steps : [];
+    if (steps.length === 0) {
+        issues.push({ code: 'workflow-steps-required', message: 'workflow.steps must be a non-empty array' });
+    }
+
+    const stepIds = new Set();
+    for (const step of steps) {
+        if (!step || !isPlainObject(step)) {
+            issues.push({ code: 'workflow-step-invalid', message: 'workflow step must be an object' });
+            continue;
+        }
+        const stepId = typeof step.id === 'string' ? step.id.trim() : '';
+        if (!stepId) {
+            issues.push({ code: 'workflow-step-id-required', message: 'workflow step id is required' });
+        } else if (stepIds.has(stepId)) {
+            issues.push({ code: 'workflow-step-id-duplicate', message: `duplicate step id: ${stepId}` });
+        } else {
+            stepIds.add(stepId);
+        }
+
+        const tool = typeof step.tool === 'string' ? step.tool.trim() : '';
+        if (!tool) {
+            issues.push({ code: 'workflow-step-tool-required', message: `step ${stepId || '(unknown)'} missing tool` });
+        } else if (knownTools.size > 0 && !knownTools.has(tool)) {
+            issues.push({ code: 'workflow-step-tool-unknown', message: `step ${stepId || '(unknown)'} unknown tool: ${tool}` });
+        }
+
+        if (step.when !== undefined && step.when !== null && !isPlainObject(step.when)) {
+            issues.push({ code: 'workflow-step-when-invalid', message: `step ${stepId || '(unknown)'} when must be an object` });
+        }
+    }
+
+    if (issues.length > 0) {
+        return {
+            ok: false,
+            issues,
+            error: issues[0].message
+        };
+    }
+
+    return { ok: true, issues: [] };
+}
+
+async function executeWorkflowDefinition(definition, input = {}, options = {}) {
+    const invokeTool = typeof options.invokeTool === 'function'
+        ? options.invokeTool
+        : async () => ({ error: 'invokeTool is not configured' });
+    const allowWrite = options.allowWrite === true;
+    const dryRun = options.dryRun === true;
+
+    const startedAtTs = Date.now();
+    const context = {
+        input: isPlainObject(input) ? input : {},
+        steps: {}
+    };
+    const steps = Array.isArray(definition && definition.steps) ? definition.steps : [];
+    const logs = [];
+    let overallError = '';
+    let lastOutput = null;
+
+    for (const step of steps) {
+        const stepId = typeof step.id === 'string' ? step.id.trim() : '';
+        const startedStepTs = Date.now();
+        const baseLog = {
+            id: stepId || '',
+            tool: typeof step.tool === 'string' ? step.tool.trim() : '',
+            startedAt: toIso(startedStepTs)
+        };
+
+        const conditionPass = evaluateStepCondition(step.when, context);
+        if (!conditionPass) {
+            const skippedLog = {
+                ...baseLog,
+                status: 'skipped',
+                reason: 'condition-not-met',
+                endedAt: toIso(Date.now()),
+                durationMs: Date.now() - startedStepTs
+            };
+            logs.push(skippedLog);
+            context.steps[stepId] = {
+                status: 'skipped',
+                output: null,
+                error: '',
+                args: null
+            };
+            continue;
+        }
+
+        const resolvedArgs = resolveTemplateValue(isPlainObject(step.arguments) ? step.arguments : {}, context);
+        const isWriteStep = step.write === true;
+        if (isWriteStep && !allowWrite) {
+            const error = `write step requires allowWrite: ${stepId || baseLog.tool}`;
+            const failedLog = {
+                ...baseLog,
+                args: resolvedArgs,
+                status: 'failed',
+                error,
+                endedAt: toIso(Date.now()),
+                durationMs: Date.now() - startedStepTs
+            };
+            logs.push(failedLog);
+            context.steps[stepId] = {
+                status: 'failed',
+                output: null,
+                error,
+                args: resolvedArgs
+            };
+            overallError = error;
+            if (!step.continueOnError) {
+                break;
+            }
+            continue;
+        }
+
+        if (isWriteStep && dryRun) {
+            const dryRunLog = {
+                ...baseLog,
+                args: resolvedArgs,
+                status: 'skipped',
+                reason: 'dry-run-write-step',
+                endedAt: toIso(Date.now()),
+                durationMs: Date.now() - startedStepTs
+            };
+            logs.push(dryRunLog);
+            context.steps[stepId] = {
+                status: 'skipped',
+                output: null,
+                error: '',
+                args: resolvedArgs
+            };
+            continue;
+        }
+
+        let payload;
+        let stepError = '';
+        try {
+            payload = await invokeTool(baseLog.tool, resolvedArgs, {
+                step,
+                context,
+                allowWrite,
+                dryRun
+            });
+            if (isFailurePayload(payload)) {
+                stepError = typeof payload.error === 'string' && payload.error.trim()
+                    ? payload.error.trim()
+                    : `step failed: ${stepId || baseLog.tool}`;
+            }
+        } catch (error) {
+            stepError = error && error.message ? error.message : String(error || 'step execution failed');
+            payload = { error: stepError };
+        }
+
+        const status = stepError ? 'failed' : 'success';
+        const endedAtTs = Date.now();
+        const stepLog = {
+            ...baseLog,
+            args: resolvedArgs,
+            status,
+            output: payload,
+            error: stepError,
+            endedAt: toIso(endedAtTs),
+            durationMs: endedAtTs - startedStepTs
+        };
+        logs.push(stepLog);
+        context.steps[stepId] = {
+            status,
+            output: payload,
+            error: stepError,
+            args: resolvedArgs
+        };
+
+        if (!stepError) {
+            lastOutput = payload;
+        } else {
+            overallError = stepError;
+            if (!step.continueOnError) {
+                break;
+            }
+        }
+    }
+
+    const endedAtTs = Date.now();
+    const hasFailed = logs.some((item) => item.status === 'failed');
+    const result = {
+        success: !hasFailed,
+        startedAt: toIso(startedAtTs),
+        endedAt: toIso(endedAtTs),
+        durationMs: endedAtTs - startedAtTs,
+        steps: logs,
+        output: lastOutput || null
+    };
+    if (overallError) {
+        result.error = overallError;
+    }
+    return result;
+}
+
+module.exports = {
+    getPathValue,
+    resolveTemplateValue,
+    evaluateStepCondition,
+    validateWorkflowDefinition,
+    executeWorkflowDefinition
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Codex/Claude Code 配置与会话管理 CLI + Web 工具",
   "main": "cli.js",
   "bin": {
@@ -14,7 +14,7 @@
     "res/",
     "doc/",
     "README.md",
-    "README.zh-CN.md",
+    "README.en.md",
     "LICENSE"
   ],
   "exports": {
@@ -26,6 +26,9 @@
   "scripts": {
     "dev": "node cli.js run",
     "start": "node cli.js",
+    "docs:dev": "node ./node_modules/vitepress/dist/node/cli.js dev site",
+    "docs:build": "node ./node_modules/vitepress/dist/node/cli.js build site",
+    "docs:preview": "node ./node_modules/vitepress/dist/node/cli.js preview site",
     "test": "npm run test:unit && npm run test:e2e",
     "test:unit": "node tests/unit/run.mjs",
     "test:e2e": "node tests/e2e/run.js",
@@ -34,6 +37,7 @@
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "json5": "^2.2.3",
+    "yauzl": "^3.2.1",
     "zip-lib": "^1.2.1"
   },
   "engines": {
@@ -52,5 +56,8 @@
     "cli"
   ],
   "author": "ymkiux",
-  "license": "Apache-2.0"
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "vitepress": "^1.6.4"
+  }
 }