@agent-spaces/server 0.3.63 → 0.3.65

package/public/skills/planning-with-files/planning-with-files-zh/scripts/init-session.sh

@@ -1,124 +0,0 @@
-#!/usr/bin/env bash
-# 初始化新会话的规划文件
-# 用法：./init-session.sh [项目名称]
-
-set -e
-
-PROJECT_NAME="${1:-project}"
-DATE=$(date +%Y-%m-%d)
-
-echo "正在初始化规划文件：$PROJECT_NAME"
-
-# 如果 task_plan.md 不存在则创建
-if [ ! -f "task_plan.md" ]; then
-    cat > task_plan.md << 'EOF'
-# 任务计划：[简要描述]
-
-## 目标
-[用一句话描述最终状态]
-
-## 当前阶段
-阶段 1
-
-## 各阶段
-
-### 阶段 1：需求与发现
-- [ ] 理解用户意图
-- [ ] 确定约束条件和需求
-- [ ] 将发现记录到 findings.md
-- **状态：** in_progress
-
-### 阶段 2：规划与结构
-- [ ] 确定技术方案
-- [ ] 如有需要创建项目结构
-- [ ] 记录决策及理由
-- **状态：** pending
-
-### 阶段 3：实现
-- [ ] 按计划逐步执行
-- [ ] 先将代码写入文件再执行
-- [ ] 增量测试
-- **状态：** pending
-
-### 阶段 4：测试与验证
-- [ ] 验证所有需求已满足
-- [ ] 将测试结果记录到 progress.md
-- [ ] 修复发现的问题
-- **状态：** pending
-
-### 阶段 5：交付
-- [ ] 检查所有输出文件
-- [ ] 确保交付物完整
-- [ ] 交付给用户
-- **状态：** pending
-
-## 已做决策
-| 决策 | 理由 |
-|------|------|
-
-## 遇到的错误
-| 错误 | 解决方案 |
-|------|---------|
-EOF
-    echo "已创建 task_plan.md"
-else
-    echo "task_plan.md 已存在，跳过"
-fi
-
-# 如果 findings.md 不存在则创建
-if [ ! -f "findings.md" ]; then
-    cat > findings.md << 'EOF'
-# 发现与决策
-
-## 需求
--
-
-## 研究发现
--
-
-## 技术决策
-| 决策 | 理由 |
-|------|------|
-
-## 遇到的问题
-| 问题 | 解决方案 |
-|------|---------|
-
-## 资源
--
-EOF
-    echo "已创建 findings.md"
-else
-    echo "findings.md 已存在，跳过"
-fi
-
-# 如果 progress.md 不存在则创建
-if [ ! -f "progress.md" ]; then
-    cat > progress.md << EOF
-# 进度日志
-
-## 会话：$DATE
-
-### 当前状态
-- **阶段：** 1 - 需求与发现
-- **开始时间：** $DATE
-
-### 已执行操作
--
-
-### 测试结果
-| 测试 | 预期 | 实际 | 状态 |
-|------|------|------|------|
-
-### 错误
-| 错误 | 解决方案 |
-|------|---------|
-EOF
-    echo "已创建 progress.md"
-else
-    echo "progress.md 已存在，跳过"
-fi
-
-echo ""
-echo "规划文件已初始化！"
-echo "文件：task_plan.md, findings.md, progress.md"

package/public/skills/planning-with-files/planning-with-files-zh/scripts/session-catchup.py

@@ -1,438 +0,0 @@
-#!/usr/bin/env python3
-"""
-planning-with-files 会话恢复脚本
-
-分析上一个会话，查找在最后一次规划文件更新后未同步的上下文。
-设计为在 SessionStart 时运行。
-
-用法：python3 session-catchup.py [项目路径]
-"""
-
-import json
-import sys
-import os
-from pathlib import Path
-from typing import Any, Dict, Iterable, List, Optional, Tuple
-
-try:
-    import orjson
-except ImportError:
-    orjson = None
-
-PLANNING_FILES = ['task_plan.md', 'progress.md', 'findings.md']
-MIN_SESSION_BYTES = 5000
-
-
-def json_loads(line: str) -> Optional[Dict[str, Any]]:
-    """Prefer optional orjson while keeping the hook dependency-free."""
-    try:
-        if orjson is not None:
-            data = orjson.loads(line)
-        else:
-            data = json.loads(line)
-    except (ValueError, TypeError, UnicodeDecodeError):
-        return None
-    return data if isinstance(data, dict) else None
-
-
-def normalize_for_compare(path_value: str) -> str:
-    expanded = os.path.expanduser(path_value)
-    try:
-        return str(Path(expanded).resolve())
-    except (OSError, ValueError):
-        return os.path.abspath(expanded)
-
-
-def normalize_path(project_path: str) -> str:
-    """Normalize project path to match Claude Code's internal representation.
-
-    Claude Code stores session directories using the Windows-native path
-    (e.g., C:\\Users\\...) sanitized with separators replaced by dashes.
-    Git Bash passes /c/Users/... which produces a DIFFERENT sanitized
-    string. This function converts Git Bash paths to Windows paths first.
-    """
-    p = project_path
-
-    # Git Bash / MSYS2: /c/Users/... -> C:/Users/...
-    if len(p) >= 3 and p[0] == '/' and p[2] == '/':
-        p = p[1].upper() + ':' + p[2:]
-
-    # Resolve to absolute path to handle relative paths and symlinks
-    try:
-        resolved = str(Path(p).resolve())
-        # On Windows, resolve() returns C:\Users\... which is what we want
-        if os.name == 'nt' or '\\' in resolved:
-            p = resolved
-    except (OSError, ValueError):
-        pass
-
-    return p
-
-
-def get_claude_project_dir(project_path: str) -> Path:
-    """Resolve Claude Code's project-specific session storage path."""
-    normalized = normalize_path(project_path)
-
-    # Claude Code's sanitization: replace path separators and : with -
-    sanitized = normalized.replace('\\', '-').replace('/', '-').replace(':', '-')
-    sanitized = sanitized.replace('_', '-')
-    # Strip leading dash if present (Unix absolute paths start with /)
-    if sanitized.startswith('-'):
-        sanitized = sanitized[1:]
-
-    return Path.home() / '.claude' / 'projects' / sanitized
-
-
-def get_sessions_sorted(project_dir: Path) -> List[Path]:
-    """Get all session files sorted by modification time (newest first)."""
-    sessions = list(project_dir.glob('*.jsonl'))
-    main_sessions = [s for s in sessions if not s.name.startswith('agent-')]
-    return sorted(main_sessions, key=safe_stat_mtime, reverse=True)
-
-
-def safe_stat_mtime(path: Path) -> float:
-    try:
-        return path.stat().st_mtime
-    except OSError:
-        return 0.0
-
-
-def is_substantial_session(session: Path) -> bool:
-    try:
-        return session.stat().st_size > MIN_SESSION_BYTES
-    except OSError:
-        return False
-
-
-def read_codex_meta(session_file: Path) -> Optional[Dict[str, Any]]:
-    """Read the first session_meta; later meta records may be copied parent context."""
-    try:
-        with open(session_file, 'r', encoding='utf-8', errors='replace') as f:
-            for line in f:
-                data = json_loads(line)
-                if not data or data.get('type') != 'session_meta':
-                    continue
-                payload = data.get('payload')
-                return payload if isinstance(payload, dict) else None
-    except OSError:
-        return None
-    return None
-
-
-def codex_meta_cwd(meta: Dict[str, Any]) -> Optional[str]:
-    cwd = meta.get('cwd')
-    return cwd if isinstance(cwd, str) else None
-
-
-def find_current_codex_session(sessions: List[Path]) -> Optional[Path]:
-    thread_id = os.getenv('CODEX_THREAD_ID', '').strip()
-    if not thread_id:
-        return None
-
-    for session in sessions:
-        if thread_id in session.name:
-            return session
-    return None
-
-
-def is_codex_project_session(session: Path, project_cmp: str) -> bool:
-    if not is_substantial_session(session):
-        return False
-
-    meta = read_codex_meta(session)
-    if not meta:
-        return False
-    source = meta.get('source')
-    if isinstance(source, dict) and 'subagent' in source:
-        return False
-    cwd = codex_meta_cwd(meta)
-    return bool(cwd and normalize_for_compare(cwd) == project_cmp)
-
-
-def get_codex_sessions(project_path: str) -> Iterable[Path]:
-    sessions_dir = Path(os.path.expanduser(os.getenv('CODEX_SESSIONS_DIR', '~/.codex/sessions')))
-    if not sessions_dir.exists():
-        return
-
-    project_cmp = normalize_for_compare(project_path)
-    sessions = sorted(sessions_dir.rglob('rollout-*.jsonl'), key=safe_stat_mtime, reverse=True)
-    current = find_current_codex_session(sessions)
-    if current and is_codex_project_session(current, project_cmp):
-        yield current
-
-    for session in sessions:
-        if session == current:
-            continue
-        if is_codex_project_session(session, project_cmp):
-            yield session
-
-
-def get_session_candidates(project_path: str) -> Tuple[str, Iterable[Path]]:
-    if '/.codex/' in Path(__file__).resolve().as_posix().lower():
-        return 'codex', get_codex_sessions(project_path)
-
-    claude_project_dir = get_claude_project_dir(project_path)
-    if claude_project_dir.exists():
-        return 'claude', get_sessions_sorted(claude_project_dir)
-    return 'claude', []
-
-
-def parse_session_messages(session_file: Path) -> List[Dict[str, Any]]:
-    """Parse all messages from a session file, preserving order."""
-    messages = []
-    with open(session_file, 'r', encoding='utf-8', errors='replace') as f:
-        for line_num, line in enumerate(f):
-            data = json_loads(line)
-            if data is not None:
-                data['_line_num'] = line_num
-                messages.append(data)
-    return messages
-
-
-def planning_file_from_path(path_value: Any) -> Optional[str]:
-    if not isinstance(path_value, str):
-        return None
-    for pf in PLANNING_FILES:
-        if path_value.endswith(pf):
-            return pf
-    return None
-
-
-def planning_file_from_paths(paths: Iterable[Any]) -> Optional[str]:
-    matches = {pf for path in paths if (pf := planning_file_from_path(path))}
-    for pf in PLANNING_FILES:
-        if pf in matches:
-            return pf
-    return None
-
-
-def codex_planning_update(payload: Dict[str, Any]) -> Optional[str]:
-    """Use Codex's structured apply_patch result instead of parsing tool text."""
-    if payload.get('type') != 'patch_apply_end' or payload.get('success') is not True:
-        return None
-    changes = payload.get('changes')
-    return planning_file_from_paths(changes.keys()) if isinstance(changes, dict) else None
-
-
-def find_last_planning_update(messages: List[Dict[str, Any]]) -> Tuple[int, Optional[str]]:
-    """
-    Find the last time a planning file was written/edited.
-    Returns (line_number, filename) or (-1, None) if not found.
-    """
-    last_update_line = -1
-    last_update_file = None
-
-    for msg in messages:
-        line_num = msg.get('_line_num')
-        if not isinstance(line_num, int):
-            continue
-        msg_type = msg.get('type')
-
-        if msg_type == 'assistant':
-            content = msg.get('message', {}).get('content', [])
-            if isinstance(content, list):
-                for item in content:
-                    if item.get('type') == 'tool_use':
-                        tool_name = item.get('name', '')
-                        tool_input = item.get('input', {})
-                        if not isinstance(tool_input, dict):
-                            tool_input = {}
-
-                        if tool_name in ('Write', 'Edit'):
-                            planning_file = planning_file_from_path(tool_input.get('file_path', ''))
-                            if planning_file:
-                                last_update_line = line_num
-                                last_update_file = planning_file
-
-        elif msg_type == 'event_msg':
-            payload = msg.get('payload')
-            if isinstance(payload, dict):
-                planning_file = codex_planning_update(payload)
-                if planning_file:
-                    last_update_line = line_num
-                    last_update_file = planning_file
-
-    return last_update_line, last_update_file
-
-
-def text_content(content: Any) -> str:
-    if isinstance(content, str):
-        return content
-    if not isinstance(content, list):
-        return ''
-    return '\n'.join(
-        item.get('text', '')
-        for item in content
-        if isinstance(item, dict) and isinstance(item.get('text'), str)
-    )
-
-
-def parse_codex_tool_args(payload: Dict[str, Any]) -> Tuple[Dict[str, Any], str]:
-    raw_args = payload.get('arguments', payload.get('input', ''))
-    if isinstance(raw_args, dict):
-        return raw_args, json.dumps(raw_args, ensure_ascii=True)
-    if not isinstance(raw_args, str):
-        return {}, ''
-    decoded = json_loads(raw_args)
-    return (decoded, raw_args) if isinstance(decoded, dict) else ({}, raw_args)
-
-
-def summarize_codex_tool(payload: Dict[str, Any]) -> str:
-    tool_name = payload.get('name', 'tool')
-    tool_args, raw_args = parse_codex_tool_args(payload)
-    if tool_name == 'exec_command':
-        command = tool_args.get('cmd', raw_args)
-        if isinstance(command, str):
-            return f"exec_command: {command[:80]}"
-    return str(tool_name)
-
-
-def extract_messages_after(messages: List[Dict[str, Any]], after_line: int) -> List[Dict[str, Any]]:
-    """Extract conversation messages after a certain line number."""
-    result = []
-    for msg in messages:
-        line_num = msg.get('_line_num')
-        if not isinstance(line_num, int) or line_num <= after_line:
-            continue
-
-        msg_type = msg.get('type')
-        is_meta = msg.get('isMeta', False)
-
-        if msg_type == 'user' and not is_meta:
-            content = text_content(msg.get('message', {}).get('content', ''))
-
-            if content:
-                if content.startswith(('<local-command', '<command-', '<task-notification')):
-                    continue
-                if len(content) > 20:
-                    result.append({'role': 'user', 'content': content, 'line': line_num})
-
-        elif msg_type == 'assistant':
-            msg_content = msg.get('message', {}).get('content', '')
-            text = text_content(msg_content)
-            tool_uses = []
-
-            if isinstance(msg_content, list):
-                for item in msg_content:
-                    if isinstance(item, dict) and item.get('type') == 'tool_use':
-                        tool_name = item.get('name', '')
-                        tool_input = item.get('input', {})
-                        if not isinstance(tool_input, dict):
-                            tool_input = {}
-                        if tool_name == 'Edit':
-                            tool_uses.append(f"Edit: {tool_input.get('file_path', 'unknown')}")
-                        elif tool_name == 'Write':
-                            tool_uses.append(f"Write: {tool_input.get('file_path', 'unknown')}")
-                        elif tool_name == 'Bash':
-                            cmd = tool_input.get('command', '')[:80]
-                            tool_uses.append(f"Bash: {cmd}")
-                        else:
-                            tool_uses.append(f"{tool_name}")
-
-            if text or tool_uses:
-                result.append({
-                    'role': 'assistant',
-                    'content': text[:600] if text else '',
-                    'tools': tool_uses,
-                    'line': line_num
-                })
-
-        elif msg_type == 'response_item':
-            payload = msg.get('payload')
-            if not isinstance(payload, dict):
-                continue
-
-            payload_type = payload.get('type')
-            if payload_type == 'message':
-                role = payload.get('role')
-                if role not in ('user', 'assistant'):
-                    continue
-                content = text_content(payload.get('content'))
-                if role == 'user':
-                    if content.startswith(('<local-command', '<command-', '<task-notification')):
-                        continue
-                    if len(content) > 20:
-                        result.append({'role': 'user', 'content': content, 'line': line_num})
-                elif content:
-                    result.append({
-                        'role': 'assistant',
-                        'content': content[:600],
-                        'tools': [],
-                        'line': line_num
-                    })
-            elif payload_type in ('function_call', 'custom_tool_call'):
-                result.append({
-                    'role': 'assistant',
-                    'content': '',
-                    'tools': [summarize_codex_tool(payload)],
-                    'line': line_num
-                })
-
-    return result
-
-
-def main():
-    project_path = sys.argv[1] if len(sys.argv) > 1 else os.getcwd()
-
-    # Check if planning files exist (indicates active task)
-    has_planning_files = any(
-        Path(project_path, f).exists() for f in PLANNING_FILES
-    )
-    if not has_planning_files:
-        # No planning files in this project; skip catchup to avoid noise.
-        return
-
-    runtime_name, sessions = get_session_candidates(project_path)
-
-    # Find a substantial previous session
-    target_session = None
-    for session in sessions:
-        if runtime_name == 'claude' and not is_substantial_session(session):
-            continue
-        target_session = session
-        break
-
-    if not target_session:
-        return
-
-    messages = parse_session_messages(target_session)
-    last_update_line, last_update_file = find_last_planning_update(messages)
-
-    # No planning updates in the target session; skip catchup output.
-    if last_update_line < 0:
-        return
-
-    # Only output if there's unsynced content
-    messages_after = extract_messages_after(messages, last_update_line)
-
-    if not messages_after:
-        return
-
-    # Output catchup report
-    print("\n[planning-with-files] 检测到会话恢复")
-    print(f"上一个会话：{target_session.stem}")
-    print(f"运行环境：{runtime_name}")
-
-    print(f"最后规划更新：{last_update_file} at message #{last_update_line}")
-    print(f"未同步消息：{len(messages_after)}")
-
-    print("\n--- 未同步的上下文 ---")
-    assistant_label = 'CODEX' if runtime_name == 'codex' else 'CLAUDE'
-    for msg in messages_after[-15:]:
-        if msg['role'] == 'user':
-            print(f"用户：{msg['content'][:300]}")
-        else:
-            if msg.get('content'):
-                print(f"{assistant_label}: {msg['content'][:300]}")
-            if msg.get('tools'):
-                print(f"  工具：{', '.join(msg['tools'][:4])}")
-
-    print("\n--- 建议 ---")
-    print("1. 运行：git diff --stat")
-    print("2. 读取：task_plan.md、progress.md、findings.md")
-    print("3. 根据上述上下文更新规划文件")
-    print("4. 继续执行任务")
-
-
-if __name__ == '__main__':
-    main()

package/public/skills/planning-with-files/planning-with-files-zh/templates/findings.md

@@ -1,29 +0,0 @@
-# 发现与决策
-
-## 需求
--
-
-## 研究发现
--
-
-## 技术决策
-| 决策 | 理由 |
-|------|------|
-|      |      |
-
-## 遇到的问题
-| 问题 | 解决方案 |
-|------|---------|
-|      |         |
-
-## 资源
--
-
-## 视觉/浏览器发现
-<!-- 关键：每执行2次查看/浏览器操作后必须更新此部分 -->
-<!-- 多模态内容必须立即以文本形式记录 -->
--
-
----
-*每执行2次查看/浏览器/搜索操作后更新此文件*
-*防止视觉信息丢失*

package/public/skills/planning-with-files/planning-with-files-zh/templates/progress.md

@@ -1,40 +0,0 @@
-# 进度日志
-
-## 会话：[日期]
-
-### 阶段 1：[标题]
-- **状态：** in_progress
-- **开始时间：** [时间戳]
-- 执行的操作：
-  -
-- 创建/修改的文件：
-  -
-
-### 阶段 2：[标题]
-- **状态：** pending
-- 执行的操作：
-  -
-- 创建/修改的文件：
-  -
-
-## 测试结果
-| 测试 | 输入 | 预期结果 | 实际结果 | 状态 |
-|------|------|---------|---------|------|
-|      |      |         |         |      |
-
-## 错误日志
-| 时间戳 | 错误 | 尝试次数 | 解决方案 |
-|--------|------|---------|---------|
-|        |      | 1       |         |
-
-## 五问重启检查
-| 问题 | 答案 |
-|------|------|
-| 我在哪里？ | 阶段 X |
-| 我要去哪里？ | 剩余阶段 |
-| 目标是什么？ | [目标声明] |
-| 我学到了什么？ | 见 findings.md |
-| 我做了什么？ | 见上方记录 |
-
----
-*每个阶段完成后或遇到错误时更新此文件*

package/public/skills/planning-with-files/planning-with-files-zh/templates/task_plan.md

@@ -1,58 +0,0 @@
-# 任务计划：[简要描述]
-
-## 目标
-[用一句话描述最终状态]
-
-## 当前阶段
-阶段 1
-
-## 各阶段
-
-### 阶段 1：需求与发现
-- [ ] 理解用户意图
-- [ ] 确定约束条件和需求
-- [ ] 将发现记录到 findings.md
-- **状态：** in_progress
-
-### 阶段 2：规划与结构
-- [ ] 确定技术方案
-- [ ] 如有需要创建项目结构
-- [ ] 记录决策及理由
-- **状态：** pending
-
-### 阶段 3：实现
-- [ ] 按计划逐步执行
-- [ ] 先将代码写入文件再执行
-- [ ] 增量测试
-- **状态：** pending
-
-### 阶段 4：测试与验证
-- [ ] 验证所有需求已满足
-- [ ] 将测试结果记录到 progress.md
-- [ ] 修复发现的问题
-- **状态：** pending
-
-### 阶段 5：交付
-- [ ] 检查所有输出文件
-- [ ] 确保交付物完整
-- [ ] 交付给用户
-- **状态：** pending
-
-## 关键问题
-1. [待回答的问题]
-2. [待回答的问题]
-
-## 已做决策
-| 决策 | 理由 |
-|------|------|
-|      |      |
-
-## 遇到的错误
-| 错误 | 尝试次数 | 解决方案 |
-|------|---------|---------|
-|      | 1       |         |
-
-## 备注
-- 随着进度更新阶段状态：pending → in_progress → complete
-- 做重大决策前重新读取此计划（注意力操纵）
-- 记录所有错误，避免重复