@geminilight/mindos 0.6.29 → 0.6.30

package/app/lib/agent/to-agent-messages.ts

@@ -13,13 +13,36 @@
  * - Orphaned tool calls (running/pending from interrupted streams): supply empty result
  * - Reasoning parts: filtered out (display-only, not sent back to LLM)
  */
-import type { Message as FrontendMessage, ToolCallPart as FrontendToolCallPart } from '@/lib/types';
+import type { Message as FrontendMessage, ToolCallPart as FrontendToolCallPart, ImagePart } from '@/lib/types';
 import type { AgentMessage } from '@mariozechner/pi-agent-core';
 import type { UserMessage, AssistantMessage, ToolResultMessage } from '@mariozechner/pi-ai';
 
 // Re-export for convenience
 export type { AgentMessage } from '@mariozechner/pi-agent-core';
 
+/** Build multimodal content array for user messages with images */
+function buildUserContent(text: string, images?: ImagePart[]): string | any[] {
+  // Filter out stripped images (empty data from persisted sessions)
+  const validImages = images?.filter(img => img.data);
+  if (!validImages || validImages.length === 0) return text;
+
+  // Multimodal content: images first, then text
+  // Use pi-ai ImageContent format: { type: 'image', data: base64, mimeType }
+  // The SDK converts this to the provider-specific format (Anthropic/OpenAI) internally
+  const parts: any[] = [];
+  for (const img of validImages) {
+    parts.push({
+      type: 'image',
+      data: img.data,
+      mimeType: img.mimeType,
+    });
+  }
+  if (text) {
+    parts.push({ type: 'text', text });
+  }
+  return parts;
+}
+
 export function toAgentMessages(messages: FrontendMessage[]): AgentMessage[] {
   const result: AgentMessage[] = [];
 
@@ -29,7 +52,7 @@ export function toAgentMessages(messages: FrontendMessage[]): AgentMessage[] {
     if (msg.role === 'user') {
       result.push({
         role: 'user',
-        content: msg.content,
+        content: buildUserContent(msg.content, msg.images),
         timestamp,
       } satisfies UserMessage as AgentMessage);
       continue;

package/app/lib/i18n/modules/knowledge.ts

@@ -39,11 +39,13 @@ export const knowledgeEn = {
       'agent-inspector': 'Agent Inspector',
       'config-panel': 'Config Panel',
       'todo': 'TODO Board',
+      'workflow-yaml': 'Workflows',
     } as Record<string, string>,
     toolDesc: {
       'agent-inspector': 'View agent tool-call logs and audit trail',
       'config-panel': 'Edit and manage global configuration',
       'todo': 'Manage tasks as an interactive kanban board',
+      'workflow-yaml': 'Execute step-by-step workflows with AI assistance',
     } as Record<string, string>,
     plugins: 'Extensions',
     changeHistory: 'Change History',
@@ -251,11 +253,13 @@ export const knowledgeZh = {
       'agent-inspector': '审计面板',
       'config-panel': '配置面板',
       'todo': '待办面板',
+      'workflow-yaml': '工作流',
     } as Record<string, string>,
     toolDesc: {
       'agent-inspector': '查看 Agent 操作日志与调用轨迹',
       'config-panel': '编辑和管理全局配置项',
       'todo': '以看板形式管理待办事项',
+      'workflow-yaml': '执行多步骤工作流，AI 辅助执行',
     } as Record<string, string>,
     plugins: '扩展',
     changeHistory: '变更历史',

package/app/lib/i18n/modules/navigation.ts

@@ -11,6 +11,7 @@ export const navigationEn = {
     agents: 'Agents',
     echo: 'Echo',
     discover: 'Discover',
+    workflows: 'Flows',
     history: 'History',
     help: 'Help',
     syncLabel: 'Sync',
@@ -86,6 +87,7 @@ export const navigationZh = {
     agents: '智能体',
     echo: '回响',
     discover: '探索',
+    workflows: '流程',
     history: '历史',
     help: '帮助',
     syncLabel: '同步',

package/app/lib/i18n/modules/panels.ts

@@ -40,6 +40,7 @@ export const panelsEn = {
       navMcp: 'MCP',
       navSkills: 'Skills',
       navNetwork: 'Network',
+      navSessions: 'Sessions',
       // A2A tab
       a2aTabTitle: 'Remote Agents',
       a2aTabEmpty: 'No remote agents',
@@ -90,11 +91,33 @@ export const panelsEn = {
       acpComingSoon: 'Coming soon \u2014 use Ask AI to invoke',
       acpReady: 'Ready',
       acpNotInstalled: 'Not Installed',
-      acpScan: 'Scan Local',
+      acpScan: 'Re-scan',
       acpInstallHint: (cmd: string) => `Install with: ${cmd}`,
+      acpInstall: 'Install',
+      acpInstalling: 'Installing…',
       acpLoading: 'Loading ACP registry\u2026',
       acpLoadFailed: 'Failed to load ACP registry.',
       acpRetry: 'Retry',
+      acpQuickReview: 'Review code',
+      acpQuickFix: 'Fix bugs',
+      acpQuickExplain: 'Explain repo',
+      acpUseWith: (name: string) => `Use ${name} to `,
+      acpDefaultAgent: 'MindOS Agent',
+      acpSelectAgent: 'Select Agent',
+      acpChangeAgent: 'Change agent',
+      acpConfigToggle: 'Configure',
+      acpConfigCommand: 'Command',
+      acpConfigArgs: 'Args',
+      acpConfigEnv: 'Env',
+      acpConfigEnvAdd: 'Add env var',
+      acpConfigSource: 'Source',
+      acpConfigSourceBuiltin: 'built-in',
+      acpConfigSourceRegistry: 'registry',
+      acpConfigSourceUser: 'custom',
+      acpConfigReset: 'Reset',
+      acpConfigSave: 'Save',
+      acpConfigSaved: 'Saved',
+      acpConfigPath: 'Path',
       networkEmptyTitle: 'Connect to the agent ecosystem',
       networkEmptyDesc: 'Discover remote agents or browse coding agents from the ACP registry.',
       networkDiscoverBtn: 'Discover Agent',
@@ -139,6 +162,22 @@ export const panelsEn = {
       viewAll: 'View all use cases',
       tryIt: 'Try',
     },
+    workflows: {
+      title: 'Flows',
+      empty: 'No flows yet',
+      emptyDesc: 'Create your first flow to automate multi-step tasks with AI.',
+      newWorkflow: 'New Flow',
+      nSteps: (n: number) => `${n} step${n === 1 ? '' : 's'}`,
+      parseError: 'Parse error',
+      name: 'Name',
+      namePlaceholder: 'My Flow',
+      template: 'Template',
+      templateBlank: 'Blank',
+      create: 'Create',
+      cancel: 'Cancel',
+      creating: 'Creating...',
+      exists: 'A workflow with this name already exists',
+    },
   },
   echoPages: {
     parent: 'Echo',
@@ -211,6 +250,7 @@ export const panelsEn = {
     navMcp: 'MCP',
     navSkills: 'Skills',
     navNetwork: 'Network',
+    navSessions: 'Sessions',
     a2aTabTitle: 'Remote Agents',
     a2aTabEmptyHint: 'Discover agents to enable cross-agent delegation.',
     backToOverview: 'Back to Agents',
@@ -518,6 +558,38 @@ export const panelsEn = {
       mcpReconnectAll: 'Reconnect all',
       mcpReconnectAllRunning: 'Reconnecting...',
       mcpReconnectAllDone: (ok: number, failed: number) => `Reconnected ${ok}${failed > 0 ? `, failed ${failed}` : ''}.`,
+      // ─── Runtime & Diagnostics ───
+      runtimeDiagTitle: 'Runtime & Diagnostics',
+      runtimePing: 'Ping',
+      runtimePinging: 'Pinging...',
+      runtimePingOk: (ms: number) => `Reachable (${ms}ms)`,
+      runtimePingFail: 'Unreachable',
+      runtimeUptime: 'Uptime',
+      runtimePid: 'Process',
+      runtimeMemory: 'Memory',
+      runtimeVersion: 'Version',
+      runtimeStartedAt: 'Started',
+      runtimeNoData: 'No runtime data available.',
+      // ─── Environment & Permissions ───
+      envPermTitle: 'Environment & Permissions',
+      envVars: 'Environment variables',
+      envVarsCount: (n: number) => `${n} configured`,
+      envVarsEmpty: 'No custom environment variables.',
+      envScope: 'Scope',
+      envReadOnly: 'Read-only access',
+      envWriteAccess: 'Write access',
+      envFileAccess: 'File access',
+      envNetworkAccess: 'Network access',
+      envAllowed: 'Allowed',
+      envRestricted: 'Restricted',
+      // ─── Activity & Usage ───
+      activityTitle: 'Activity & Usage',
+      activityTotal: 'Total invocations',
+      activityLast7d: 'Last 7 days',
+      activityLastInvocation: 'Last invocation',
+      activityTokensUsed: 'Tokens used',
+      activityAvgLatency: 'Avg latency',
+      activityNoData: 'No activity recorded yet.',
     },
     detailSubtitle: '',
     detailNotFound: 'Agent not found — it may have been removed or renamed.',
@@ -565,6 +637,7 @@ export const panelsZh = {
       navMcp: 'MCP',
       navSkills: '技能',
       navNetwork: '网络',
+      navSessions: '会话',
       // A2A tab
       a2aTabTitle: '远程 Agent',
       a2aTabEmpty: '无远程 Agent',
@@ -615,11 +688,33 @@ export const panelsZh = {
       acpComingSoon: '即将上线 — 当前可通过 Ask AI 调用',
       acpReady: '就绪',
       acpNotInstalled: '未安装',
-      acpScan: '扫描本地',
+      acpScan: '重新扫描',
       acpInstallHint: (cmd: string) => `安装命令: ${cmd}`,
+      acpInstall: '安装',
+      acpInstalling: '安装中…',
       acpLoading: '加载 ACP 注册表中…',
       acpLoadFailed: '加载 ACP 注册表失败。',
       acpRetry: '重试',
+      acpQuickReview: '代码审查',
+      acpQuickFix: '修复Bug',
+      acpQuickExplain: '解释项目',
+      acpUseWith: (name: string) => `使用 ${name} `,
+      acpDefaultAgent: 'MindOS Agent',
+      acpSelectAgent: '选择 Agent',
+      acpChangeAgent: '切换 Agent',
+      acpConfigToggle: '配置',
+      acpConfigCommand: '命令',
+      acpConfigArgs: '参数',
+      acpConfigEnv: '环境变量',
+      acpConfigEnvAdd: '添加环境变量',
+      acpConfigSource: '来源',
+      acpConfigSourceBuiltin: '内置',
+      acpConfigSourceRegistry: '注册表',
+      acpConfigSourceUser: '自定义',
+      acpConfigReset: '重置',
+      acpConfigSave: '保存',
+      acpConfigSaved: '已保存',
+      acpConfigPath: '路径',
       networkEmptyTitle: '连接智能体生态',
       networkEmptyDesc: '发现远程 Agent 或浏览 ACP 注册表中的编程智能体。',
       networkDiscoverBtn: '发现 Agent',
@@ -664,6 +759,22 @@ export const panelsZh = {
       viewAll: '查看所有使用案例',
       tryIt: '试试',
     },
+    workflows: {
+      title: '流程',
+      empty: '还没有流程',
+      emptyDesc: '创建第一个流程，用 AI 自动化多步骤任务。',
+      newWorkflow: '新建流程',
+      nSteps: (n: number) => `${n} 个步骤`,
+      parseError: '解析错误',
+      name: '名称',
+      namePlaceholder: '我的流程',
+      template: '模板',
+      templateBlank: '空白',
+      create: '创建',
+      cancel: '取消',
+      creating: '创建中...',
+      exists: '已存在同名流程',
+    },
   },
   echoPages: {
     parent: '回响',
@@ -736,6 +847,7 @@ export const panelsZh = {
     navMcp: 'MCP',
     navSkills: 'Skills',
     navNetwork: '网络',
+    navSessions: '会话',
     a2aTabTitle: '远程 Agent',
     a2aTabEmptyHint: '发现远程 Agent 以启用跨 Agent 委派。',
     backToOverview: '返回 Agents',
@@ -1043,6 +1155,38 @@ export const panelsZh = {
       mcpReconnectAll: '全部重连',
       mcpReconnectAllRunning: '正在重连...',
       mcpReconnectAllDone: (ok: number, failed: number) => `已重连 ${ok}${failed > 0 ? `，失败 ${failed}` : ''}。`,
+      // ─── 运行与诊断 ───
+      runtimeDiagTitle: '运行与诊断',
+      runtimePing: '连通测试',
+      runtimePinging: '测试中...',
+      runtimePingOk: (ms: number) => `可达 (${ms}ms)`,
+      runtimePingFail: '不可达',
+      runtimeUptime: '运行时长',
+      runtimePid: '进程',
+      runtimeMemory: '内存',
+      runtimeVersion: '版本',
+      runtimeStartedAt: '启动于',
+      runtimeNoData: '暂无运行数据。',
+      // ─── 环境与权限 ───
+      envPermTitle: '环境与权限',
+      envVars: '环境变量',
+      envVarsCount: (n: number) => `已配置 ${n} 个`,
+      envVarsEmpty: '暂无自定义环境变量。',
+      envScope: '作用域',
+      envReadOnly: '只读访问',
+      envWriteAccess: '写入访问',
+      envFileAccess: '文件访问',
+      envNetworkAccess: '网络访问',
+      envAllowed: '允许',
+      envRestricted: '受限',
+      // ─── 活动与用量 ───
+      activityTitle: '活动与用量',
+      activityTotal: '总调用次数',
+      activityLast7d: '近 7 天',
+      activityLastInvocation: '最近调用',
+      activityTokensUsed: '消耗 Tokens',
+      activityAvgLatency: '平均延迟',
+      activityNoData: '暂无活动记录。',
     },
     detailSubtitle: '',
     detailNotFound: '未找到该 Agent，可能已移除或重命名。',

package/app/lib/pi-integration/skills.ts

@@ -23,15 +23,30 @@ export function parseSkillMd(content: string): { name: string; description: stri
   if (!match) return { name: '', description: '' };
   const yaml = match[1];
   const nameMatch = yaml.match(/^name:\s*(.+)/m);
-  const descMatch = yaml.match(/^description:\s*>?\s*\n?([\s\S]*?)(?=\n\w|\n---)/m);
-  const name = nameMatch ? nameMatch[1].trim() : '';
+  
+  // Try to match block scalar (description: >) first
+  // Captures all indented lines until next non-indented line or EOF
   let description = '';
-  if (descMatch) {
-    description = descMatch[1].trim().split('\n').map((l) => l.trim()).join(' ').slice(0, 200);
+  const blockMatch = yaml.match(/^description:\s*>?\s*\n((?:\s+.+\n?)*)/m);
+  if (blockMatch && blockMatch[1].trim()) {
+    // Block scalar: join indented lines, dedent, preserve structure
+    description = blockMatch[1]
+      .split('\n')
+      .map(line => line.replace(/^\s+/, '')) // Remove leading spaces
+      .filter(line => line.trim()) // Remove empty lines
+      .join(' ')
+      .slice(0, 200);
   } else {
-    const simpleDesc = yaml.match(/^description:\s*(.+)/m);
-    if (simpleDesc) description = simpleDesc[1].trim().slice(0, 200);
+    // Fallback to single-line description
+    const simpleMatch = yaml.match(/^description:\s*(.+)/m);
+    if (simpleMatch) {
+      const val = simpleMatch[1].trim();
+      // Skip the ">" character if it's there (fallback from block scalar)
+      description = val === '>' ? '' : val.slice(0, 200);
+    }
   }
+  
+  const name = nameMatch ? nameMatch[1].trim() : '';
   return { name, description };
 }
 

package/app/lib/renderers/index.ts

@@ -10,11 +10,11 @@ import { manifest as csv } from '@/components/renderers/csv/manifest';
 import { manifest as summary } from '@/components/renderers/summary/manifest';
 import { manifest as timeline } from '@/components/renderers/timeline/manifest';
 import { manifest as todo } from '@/components/renderers/todo/manifest';
-import { manifest as workflow } from '@/components/renderers/workflow/manifest';
+import { manifest as workflowYaml } from '@/components/renderers/workflow-yaml/manifest';
 import { manifest as graph } from '@/components/renderers/graph/manifest';
 
 const manifests = [
-  agentInspector, backlinks, config, csv, summary, timeline, todo, workflow, graph,
+  agentInspector, backlinks, config, csv, summary, timeline, todo, workflowYaml, graph,
 ];
 
 for (const m of manifests) {

package/app/lib/settings.ts

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { parseAcpAgentOverrides } from './acp/agent-descriptors';
 
 const SETTINGS_PATH = path.join(os.homedir(), '.mindos', 'config.json');
 
@@ -49,6 +50,8 @@ export interface ServerSettings {
   setupPending?: boolean;  // true → / redirects to /setup
   disabledSkills?: string[];
   guideState?: GuideState;
+  /** Per-agent ACP overrides (command, args, env, enabled). Keyed by agent ID. */
+  acpAgents?: Record<string, import('./acp/agent-descriptors').AcpAgentOverride>;
 }
 
 const DEFAULTS: ServerSettings = {
@@ -133,6 +136,11 @@ function parseAgent(raw: unknown): AgentConfig | undefined {
   return Object.keys(result).length > 0 ? result : undefined;
 }
 
+/** Parse acpAgents config field, delegates to agent-descriptors.ts */
+function parseAcpAgentsField(raw: unknown): Record<string, import('./acp/agent-descriptors').AcpAgentOverride> | undefined {
+  return parseAcpAgentOverrides(raw);
+}
+
 /** Parse guideState from unknown input */
 function parseGuideState(raw: unknown): GuideState | undefined {
   if (!raw || typeof raw !== 'object') return undefined;
@@ -159,6 +167,7 @@ export function readSettings(): ServerSettings {
     return {
       ai: migrateAi(parsed),
       agent: parseAgent(parsed.agent),
+      acpAgents: parseAcpAgentsField(parsed.acpAgents),
       mindRoot: (parsed.mindRoot ?? parsed.sopRoot ?? DEFAULTS.mindRoot) as string,
       webPassword: typeof parsed.webPassword === 'string' ? parsed.webPassword : undefined,
       authToken:   typeof parsed.authToken   === 'string' ? parsed.authToken   : undefined,
@@ -189,6 +198,7 @@ export function writeSettings(settings: ServerSettings): void {
   if (settings.startMode   !== undefined) merged.startMode   = settings.startMode;
   if (settings.disabledSkills !== undefined) merged.disabledSkills = settings.disabledSkills;
   if (settings.guideState !== undefined) merged.guideState = settings.guideState;
+  if (settings.acpAgents !== undefined) merged.acpAgents = settings.acpAgents;
   // setupPending: false/undefined → remove the field (cleanup); true → set it
   if ('setupPending' in settings) {
     if (settings.setupPending) merged.setupPending = true;

package/app/lib/types.ts

@@ -32,7 +32,16 @@ export interface ReasoningPart {
   text: string;
 }
 
-export type MessagePart = TextPart | ToolCallPart | ReasoningPart;
+export type ImageMimeType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+
+export interface ImagePart {
+  type: 'image';
+  /** Base64-encoded image data (no data: prefix) */
+  data: string;
+  mimeType: ImageMimeType;
+}
+
+export type MessagePart = TextPart | ToolCallPart | ReasoningPart | ImagePart;
 
 export interface Message {
   role: 'user' | 'assistant';
@@ -41,6 +50,8 @@ export interface Message {
   timestamp?: number;
   /** Structured parts for assistant messages (tool calls + text segments) */
   parts?: MessagePart[];
+  /** Images attached to this message (user messages only) */
+  images?: ImagePart[];
   /** Skill name used for this user message (rendered as a capsule in the UI) */
   skillName?: string;
 }

package/app/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/app/package.json

@@ -39,9 +39,10 @@
     "extend": "^3.0.2",
     "fuse.js": "^7.1.0",
     "github-slugger": "^2.0.0",
+    "js-yaml": "^4.1.1",
     "lucide-react": "^0.577.0",
-    "nanoid": "^5.1.0",
     "mcporter": "^0.7.3",
+    "nanoid": "^5.1.0",
     "next": "16.1.6",
     "papaparse": "^5.5.3",
     "pdfjs-dist": "^4.10.38",
@@ -61,6 +62,7 @@
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20",
     "@types/papaparse": "^5.5.2",
     "@types/react": "^19",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.6.29",
+  "version": "0.6.30",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",

package/templates/en/.mindos/workflows/Sprint Release.flow.yaml

@@ -0,0 +1,130 @@
+title: Sprint Release Workflow
+description: Weekly sprint release process with multi-agent collaboration and comprehensive QA
+
+# Global configuration - skills available across all steps
+skills:
+  - software-architecture
+  - code-review-quality
+  - document-release
+
+# Global tools guidance (advisory - LLM auto-selects based on context)
+tools:
+  - git
+  - npm
+  - github
+
+# Workflow steps - executed sequentially
+steps:
+  # Step 1: Run comprehensive test suite
+  - id: run_tests
+    name: Run tests
+    description: Execute full test suite and report results with coverage metrics
+    agent: cursor
+    prompt: |
+      Execute the full test suite for this project.
+      
+      Provide:
+      1. Total tests run, passed, failed
+      2. Coverage report (lines/branches/functions)
+      3. Any critical failures with recommendations
+      4. Time taken
+      
+      If failures exist, list the top 3 most critical with suggested fixes.
+    timeout: 120
+
+  # Step 2: Code review with dedicated AI agent
+  - id: code_review
+    name: Code review
+    description: Comprehensive code review using software architecture principles
+    agent: claude-code
+    skill: code-review-quality
+    prompt: |
+      Review the recent code changes using the code-review-quality standard.
+      
+      Evaluate:
+      1. Correctness - error handling, edge cases
+      2. Security - authentication, input validation, secrets
+      3. Performance - N+1 queries, caching, complexity
+      4. Maintainability - naming, tests, documentation
+      5. Architecture - follows project patterns, no anti-patterns
+      
+      Provide a rating (e.g., 8.5/10) and key recommendations.
+    timeout: 120
+
+  # Step 3: Automated security scan (no agent - use LLM with tools)
+  - id: security_check
+    name: Security scan
+    description: Run security analysis and dependency checks
+    tools:
+      - npm
+      - github
+    prompt: |
+      Perform security checks on this project:
+      
+      1. Check for known vulnerabilities in npm dependencies
+      2. Review recent dependency changes
+      3. Check for hardcoded secrets or credentials
+      4. Evaluate access control and authentication mechanisms
+      5. Assess error handling for information leaks
+      
+      Report severity and recommended fixes.
+    timeout: 60
+
+  # Step 4: Update documentation using document-release skill
+  - id: update_docs
+    name: Update documentation
+    description: Sync CHANGELOG, README, and API docs with shipped changes
+    skill: document-release
+    prompt: |
+      Update project documentation based on the shipped changes:
+      
+      1. Update CHANGELOG.md following semantic versioning
+      2. Update README.md if features or APIs changed
+      3. Update API documentation if endpoints changed
+      4. Verify all documentation links are valid
+      5. Check code examples match current implementation
+      
+      Provide a summary of all documentation updates made.
+    timeout: 60
+
+  # Step 5: Final checklist before release
+  - id: pre_release_check
+    name: Pre-release verification
+    description: Final comprehensive verification before shipping
+    agent: mindos
+    prompt: |
+      Perform final pre-release verification:
+      
+      Checklist:
+      ☐ All tests passing
+      ☐ Code review completed and issues resolved
+      ☐ Security scan passed or risks accepted
+      ☐ Documentation updated and links valid
+      ☐ Version bumped correctly (semver)
+      ☐ Git tags and commits clean
+      ☐ No uncommitted changes
+      ☐ Changelog entry present
+      ☐ Dependencies updated and locked
+      ☐ Performance benchmarks acceptable
+      
+      Confirm release readiness or list any blockers.
+    timeout: 60
+
+  # Step 6: Create release tag and prepare release notes
+  - id: create_release
+    name: Create release
+    description: Tag release and prepare release notes for publishing
+    tools:
+      - git
+      - npm
+    prompt: |
+      Prepare the project for release:
+      
+      1. Confirm version in package.json matches intended release
+      2. Create git tag for this version (vX.Y.Z)
+      3. Generate release notes from CHANGELOG.md
+      4. Prepare npm release command (do not execute yet)
+      5. List all deliverables included in this release
+      
+      Provide step-by-step commands for final publishing.
+    timeout: 60