@thinkingai/ae-cli 1.0.30 → 6.0.16

package/dist/tracking/i18n/resources/cli/ko.json

@@ -0,0 +1,153 @@
+{
+  "auth": {
+    "token_captured": "[auth] {browser}에서 토큰을 가져왔습니다",
+    "token_instructions_title": "다음 단계에 따라 AE 토큰을 획득하세요:",
+    "token_instructions_step1": "1. 브라우저에서 AE 열고 로그인: {host}",
+    "token_instructions_step2": "2. F12 키로 개발자 도구 열기",
+    "token_instructions_step3": "3. Application → Local Storage → ACCESS_TOKEN 찾기",
+    "token_instructions_step4": "4. 토큰 값 복사 (앞뒤 따옴표 제거)",
+    "paste_prompt": "토큰 붙여넣기: ",
+    "token_refreshed": "[auth] {host} 토큰이 갱신되었습니다",
+    "token_cached": "ok: {host} 토큰이 캐시되었습니다",
+    "no_cached_tokens": "(캐시된 토큰 없음)",
+    "cache_cleared": "ok: 캐시가 삭제되었습니다",
+    "no_tab_found": "[ae-tracking] Chrome/Safari에서 AE 탭을 찾을 수 없습니다. {host} 열기 ...",
+    "please_login": "[ae-tracking] Chrome 또는 Safari에서 로그인하면 토큰이 자동으로 가져와집니다.",
+    "other_browser_hint": "[ae-tracking] (다른 브라우저 사용 시 AE_TOKEN 환경 변수를 수동 설정하세요)",
+    "could_not_open_browser": "[ae-tracking] Chrome/Safari를 열 수 없습니다. 수동으로 {host}를 열어주세요.",
+    "token_captured_from_browser": "[ae-tracking] {browser}에서 {host}의 토큰을 가져왔습니다.",
+    "polling_timeout": "[ae-tracking] {seconds}초 후 폴링 시간이 초과되었습니다.",
+    "no_ae_host": "AE 호스트가 설정되지 않았습니다. 실행: npx tsx scripts/te-token.ts set-host <url>",
+    "cannot_obtain_token": "{host}의 토큰을 가져올 수 없습니다. AE_TOKEN 환경 변수를 설정하세요.",
+    "empty_token": "토큰이 비어 있습니다",
+    "token_expired_api": "AE 토큰이 만료되었거나 유효하지 않습니다 (return_code -1001). Chrome에서 다시 로그인 후 실행: ae-tracking auth login",
+    "no_cached_token": "{host}의 토큰이 캐시되지 않았습니다. 먼저 'ae-tracking auth login --host {host}'를 실행하세요",
+    "js_permission_error": "브라우저 JS-from-AppleEvents가 비활성화되어 있습니다. {browser} → 보기 → 개발자 → Apple Events의 JavaScript 허용을 활성화하세요.",
+    "not_mac_error": "토큰 자동 획득은 macOS만 지원합니다 (Chrome/Safari). 대신 AE_TOKEN 환경 변수를 설정하세요."
+  },
+  "plan": {
+    "no_cached_token_auth": "[auth] 캐시된 토큰 없음, 자동 갱신 시도 중...",
+    "draft_autofixed": "[plan-draft] 자동 수정됨: {items}",
+    "draft_validation_failed_attempting_fix": "[plan-draft] 검증 실패, 수정 시도 중...",
+    "draft_fixed": "[plan-draft] 수정됨: {items}",
+    "wrote_xlsx": "{path} 작성 완료 ({counts})",
+    "validate_passed": "✅ 초안 검증 통과",
+    "validate_failed": "❌ 초안 검증 실패",
+    "attempting_auto_fix": "🔧 자동 수정 시도 중...",
+    "fixed_items": "수정됨: {items}",
+    "updated_file": "업데이트됨: {path}",
+    "validate_passed_after_fix": "✅ 수정 후 검증 통과",
+    "validate_still_errors_after_fix": "❌ 수정 후에도 오류가 있습니다: {error}",
+    "no_auto_fix_available": "이 오류들에 대한 자동 수정이 불가능합니다",
+    "checking_conflicts": "[plan-upload] 기존 계획과 충돌 확인 중...",
+    "cannot_append_mode": "❌ 추가 모드로 진행할 수 없습니다. --replace로 덮어쓰거나 draft.json의 속성 유형을 수정하세요.",
+    "append_continue_note": "추가 중 (같은 이름의 기존 이벤트는 덮어쓰지 않음)...",
+    "token_expired_refreshing": "[auth] 토큰 만료, 자동 갱신 중...",
+    "no_existing_plan": "[plan-upload] 기존 계획을 찾을 수 없음, 업로드 계속 진행",
+    "deleted_existing_plan": "[plan-upload] 기존 계획 삭제됨: {message}; 일관성 확보를 위해 5초 대기 중...",
+    "upload_has_validation_errors": "❌ 업로드에 검증 오류가 있습니다. --auto-fix로 자동 수정하세요.",
+    "auto_fixing_retry": "🔧 업로드 오류 자동 수정 중 ({current}/{max}회째)...",
+    "no_auto_fix_upload": "이 오류들에 대한 자동 수정이 불가능합니다",
+    "regenerated_xlsx": "[plan-upload] 재생성됨: {path}",
+    "max_fix_retries": "⚠️ 최대 재시도 횟수에 도달했습니다. 수동 조치가 필요합니다.",
+    "language_mismatch_hint": "테이블/언어 불일치가 감지되었습니다. xlsx 헤더 언어는 \"{locale}\"이지만 AE 시스템은 현재 다른 언어일 수 있습니다. AE 페이지에서 언어를 확인하고 전환하세요.",
+    "ae_lang_mismatch": "AE 시스템 현재 언어는 \"{aeLang}\"이지만 xlsx는 \"{xlsxLang}\"입니다.",
+    "ae_lang_switch_hint": "--switch-lang을 추가하여 재실행하면 AE 언어를 자동 전환합니다.",
+    "ae_lang_switched": "AE 언어가 {aeLang}(으)로 전환되었습니다.",
+    "ae_lang_manual_refresh": "  (브라우저를 자동으로 업데이트할 수 없습니다. 수동으로 AE 페이지 언어를 전환한 후 새로고침하세요.)",
+    "archive_exists": "❌ 아카이브 파일이 이미 존재합니다: {path}",
+    "remove_or_rename": "기존 파일을 삭제하거나 다른 계획 이름을 사용하세요.",
+    "archived_to": "✅ 아카이브됨: {path}",
+    "draft_updated_archived": "   초안 업데이트됨: archived_at={stamp}",
+    "no_templates_found": "템플릿을 찾을 수 없습니다: {dirs}",
+    "templates_found": "{count}개의 템플릿을 찾았습니다:",
+    "template_md_label": "(md)",
+    "template_xlsx_label": "(xlsx)"
+  },
+  "init": {
+    "skipped_wiki": "· wiki 건너뜀 (이미 링크됨)",
+    "installed_wiki": "✓ wiki 설치됨",
+    "installed_wiki_forced": "✓ wiki 설치됨 (강제)",
+    "conflict_wiki": "! wiki 충돌 — --force 사용 또는 수동 삭제 필요",
+    "uninstalled_wiki": "✗ wiki 제거됨",
+    "skipped_agents_md": "· AGENTS.md 건너뜀 (이미 링크됨)",
+    "installed_agents_md": "✓ AGENTS.md → CLAUDE.md 설치됨",
+    "installed_agents_md_forced": "✓ AGENTS.md 설치됨 (강제)",
+    "conflict_agents_md": "! AGENTS.md 충돌 — --force 사용 또는 수동 삭제 필요",
+    "uninstalled_agents_md": "✗ AGENTS.md 제거됨",
+    "installed_skill": "✓ {name} 설치됨",
+    "skipped_skill": "· {name} 건너뜀 (이미 링크됨)",
+    "conflict_skill": "! {name} 충돌 — --force 사용 또는 수동 삭제 필요",
+    "uninstalled_skill": "✗ {name} 제거됨"
+  },
+  "debug": {
+    "no_devices": "(디바이스 없음)",
+    "device_header": "deviceId\tdeviceName\tlastClearTime",
+    "device_added": "ok: 디바이스 {deviceId} 추가됨",
+    "device_selected": "ok: 디바이스 {deviceId} 선택됨",
+    "device_removed": "ok: 디바이스 {deviceId} 제거됨",
+    "validation_passed": "✓ 검증 성공: receiver + appId + 데이터 형식 OK",
+    "validation_failed": "✗ 검증 실패: {message}",
+    "no_events_received": "({since} 이후 이벤트 없음)",
+    "event_list_header": "# 이벤트 목록 ({count}건):",
+    "device_data_header": "# 디바이스 데이터 목록 ({count}건):",
+    "raw_header": "# 원시 데이터"
+  },
+  "code": {
+    "inferred_sdk_mode": "[import-xlsx] sdk_integration_mode 추론: {mode}",
+    "default_sdk_mode": "[import-xlsx] sdk_integration_mode: {mode} (기본값, xlsx에 platform 정보 없음)",
+    "wrote_events": "[import-xlsx] {count}개 이벤트를 {path}에 작성했습니다"
+  },
+  "wiki": {
+    "sync_not_supported": "wiki sync: 리포지토리 체크아웃 내에서 실행하세요 (scripts/wiki-plan.ts);",
+    "not_in_published_package": "이 기능은 공개 npm 패키지에서 사용할 수 없습니다."
+  },
+  "conflict": {
+    "existing_plan_title": "프로젝트에 기존 추적 계획이 있습니다:",
+    "events_count": "- 이벤트 수: {count}",
+    "event_props_count": "- 이벤트 속성 수: {count}",
+    "common_props_count": "- 공통 속성 수: {count}",
+    "user_props_count": "- 사용자 속성 수: {count}",
+    "severe_conflict_title": "⚠️ 심각한 충돌: 동일 이름 속성 유형 불일치",
+    "type_conflict_explanation": "다음 속성들은 기존 계획과 새 계획에서 유형이 다릅니다. 추가 업로드 시 데이터가 거부됩니다:",
+    "suggestion": "제안:",
+    "suggestion_fix_types": "1. 새 계획의 속성 유형을 기존 계획과 일치하도록 수정하세요",
+    "suggestion_use_replace": "2. 또는 --replace 모드로 덮어쓰고 새 유형 정의를 사용하세요",
+    "warning_event_exists_title": "⚠️ 알림: 다음 이벤트가 이미 프로젝트에 존재합니다 (추가 모드에서 덮어쓰지 않음)",
+    "event_exists_detail": "- {name} (기존: {existingCount} 속성, 새 계획: {newCount} 속성)",
+    "append_note": "추가 후:",
+    "append_note_1": "- 기존 이벤트의 속성 연결은 변경되지 않습니다",
+    "append_note_2": "- 기존 이벤트의 새 속성은 추가되지 않습니다",
+    "append_note_3": "- 새 이벤트는 정상적으로 추가됩니다",
+    "type_conflict_table_header": "| 속성명 | 기존 유형 | 새 유형 |"
+  },
+  "error": {
+    "ae_error": "AE 오류 {code}",
+    "fetch_failed": "AE 계획 가져오기 실패 ({statusCode}): {body}",
+    "fetch_return_code": "AE 계획 가져오기 return_code {code}: {message}",
+    "fetch_no_data": "AE 계획 가져오기에서 데이터가 반환되지 않았습니다 (return_code 0이지만 data가 비어 있음). Host: {host}",
+    "sitemap_fetch_failed": "사이트맵 가져오기 실패: {statusCode}",
+    "installation_menu_not_found": "사이트맵에서 installation_menu를 찾을 수 없습니다",
+    "xlsx_read_failed": "xlsx 파일 \"{path}\" 읽기 실패: {error}",
+    "output_path_is_directory": "{option}은(는) 파일 경로여야 합니다. 디렉터리를 사용할 수 없습니다: {path}",
+    "input_path_is_directory": "{option}은(는) 파일 경로여야 합니다. 디렉터리를 사용할 수 없습니다: {path}",
+    "input_path_not_found": "{option} 파일을 찾을 수 없습니다: {path}",
+    "package_root_not_found": "getPackageRoot: 상위 디렉터리에서 ae-tracking package.json을 찾을 수 없습니다"
+  },
+  "fix": {
+    "display_name_dedup": "중복 표시 이름 수정",
+    "array_row_consistency": "객체 배열 하위 속성 일관성 수정",
+    "unknown_prop_ref": "알 수 없는 이벤트 속성 참조 수정",
+    "event_prop_name_invalid": "이벤트 속성 이름 수정 (snake_case로 변환)",
+    "event_name_duplicate": "중복 이벤트 제거",
+    "detail_suffix": "（상세）",
+    "auto_fix_suffix": "（자동 수정）"
+  },
+  "user_id": {
+    "account_id_display": "계정 ID",
+    "distinct_id_display": "게스트 ID",
+    "system_property": "시스템 속성",
+    "set_to": "{field}(으)로 설정",
+    "auto_generated": "SDK 자동 생성 또는 기기 관련 ID"
+  }
+}

package/dist/tracking/i18n/resources/cli/zh.json

@@ -0,0 +1,153 @@
+{
+  "auth": {
+    "token_captured": "[auth] 从 {browser} 获取到 token",
+    "token_instructions_title": "请按以下步骤获取 AE Token：",
+    "token_instructions_step1": "1. 在浏览器打开并登录 AE 系统：{host}",
+    "token_instructions_step2": "2. 按 F12 打开开发者工具",
+    "token_instructions_step3": "3. 进入 Application → Local Storage → 找到 ACCESS_TOKEN",
+    "token_instructions_step4": "4. 复制 token 值（去掉首尾引号）",
+    "paste_prompt": "粘贴 token: ",
+    "token_refreshed": "[auth] token 已刷新: {host}",
+    "token_cached": "ok: token 已缓存: {host}",
+    "no_cached_tokens": "(无缓存 token)",
+    "cache_cleared": "ok: 缓存已清除",
+    "no_tab_found": "[ae-tracking] 未在 Chrome/Safari 中找到 AE 页面，正在打开 {host} ...",
+    "please_login": "[ae-tracking] 请在 Chrome 或 Safari 中登录，token 将自动获取。",
+    "other_browser_hint": "[ae-tracking] （如使用其他浏览器，请手动设置 AE_TOKEN 环境变量）",
+    "could_not_open_browser": "[ae-tracking] 无法打开 Chrome/Safari，请手动打开 {host}。",
+    "token_captured_from_browser": "[ae-tracking] 已从 {browser} 获取 {host} 的 token。",
+    "polling_timeout": "[ae-tracking] 等待超时（{seconds} 秒）。",
+    "no_ae_host": "未配置 AE host。运行: npx tsx scripts/te-token.ts set-host <url>",
+    "cannot_obtain_token": "无法获取 {host} 的 token，请设置 AE_TOKEN 环境变量。",
+    "empty_token": "token 为空",
+    "token_expired_api": "AE token 已过期或无效 (return_code -1001)。请在 Chrome 中重新登录后运行: ae-tracking auth login",
+    "no_cached_token": "未缓存 {host} 的 token，请先运行 'ae-tracking auth login --host {host}'",
+    "js_permission_error": "浏览器 JS-from-AppleEvents 未启用。请在 {browser} → 视图 → 开发者 → 允许 Apple Events 的 JavaScript 中开启。",
+    "not_mac_error": "自动获取 token 仅支持 macOS (Chrome/Safari)，请改用 AE_TOKEN 环境变量。"
+  },
+  "plan": {
+    "no_cached_token_auth": "[auth] 无缓存 token，尝试自动刷新...",
+    "draft_autofixed": "[plan-draft] 自动修复: {items}",
+    "draft_validation_failed_attempting_fix": "[plan-draft] 校验失败，尝试修复...",
+    "draft_fixed": "[plan-draft] 已修复: {items}",
+    "wrote_xlsx": "已写入 {path}（{counts}）",
+    "validate_passed": "✅ Draft 校验通过",
+    "validate_failed": "❌ Draft 校验失败",
+    "attempting_auto_fix": "🔧 尝试自动修复",
+    "fixed_items": "已修复: {items}",
+    "updated_file": "已更新: {path}",
+    "validate_passed_after_fix": "✅ 修复后校验通过",
+    "validate_still_errors_after_fix": "❌ 修复后仍有错误: {error}",
+    "no_auto_fix_available": "没有可用的自动修复方案",
+    "checking_conflicts": "[plan-upload] 正在检查既有方案冲突...",
+    "cannot_append_mode": "❌ 无法以追加模式继续。请使用 --replace 覆盖，或修改 draft.json 中的属性类型。",
+    "append_continue_note": "继续追加（同名事件不会覆盖）...",
+    "token_expired_refreshing": "[auth] token 已过期，自动刷新...",
+    "no_existing_plan": "[plan-upload] 未找到既有方案，继续上传",
+    "deleted_existing_plan": "[plan-upload] 已删除既有方案: {message}；等待 5 秒确保一致性...",
+    "upload_has_validation_errors": "❌ 上传存在校验错误，使用 --auto-fix 自动修复。",
+    "auto_fixing_retry": "🔧 自动修复上传错误（第 {current}/{max} 次）",
+    "no_auto_fix_upload": "没有可用的自动修复方案",
+    "regenerated_xlsx": "[plan-upload] 已重新生成: {path}",
+    "max_fix_retries": "⚠️ 已达最大重试次数，需要人工处理。",
+    "language_mismatch_hint": "检测到表格/语言不匹配。xlsx 表头语言为 \"{locale}\"，但 AE 系统当前可能为其他语言，请前往 AE 页面确认和切换语言。",
+    "ae_lang_mismatch": "AE 系统当前语言为 \"{aeLang}\"，但 xlsx 为 \"{xlsxLang}\"。",
+    "ae_lang_switch_hint": "加上 --switch-lang 参数重新运行即可自动切换 AE 语言。",
+    "ae_lang_switched": "AE 语言已切换为 {aeLang}。",
+    "ae_lang_manual_refresh": "  （无法自动更新浏览器，请手动切换 AE 页面语言后刷新。）",
+    "archive_exists": "❌ 归档文件已存在: {path}",
+    "remove_or_rename": "请删除已有文件或使用其他方案名称。",
+    "archived_to": "✅ 已归档至: {path}",
+    "draft_updated_archived": "   Draft 已更新: archived_at={stamp}",
+    "no_templates_found": "未找到模板: {dirs}",
+    "templates_found": "找到 {count} 个模板:",
+    "template_md_label": "(md)",
+    "template_xlsx_label": "(xlsx)"
+  },
+  "init": {
+    "skipped_wiki": "· 跳过 wiki（已链接）",
+    "installed_wiki": "✓ 已安装 wiki",
+    "installed_wiki_forced": "✓ 已安装 wiki（强制）",
+    "conflict_wiki": "! 冲突 wiki — 使用 --force 或手动删除",
+    "uninstalled_wiki": "✗ 已卸载 wiki",
+    "skipped_agents_md": "· 跳过 AGENTS.md（已链接）",
+    "installed_agents_md": "✓ 已安装 AGENTS.md → CLAUDE.md",
+    "installed_agents_md_forced": "✓ 已安装 AGENTS.md（强制）",
+    "conflict_agents_md": "! 冲突 AGENTS.md — 使用 --force 或手动删除",
+    "uninstalled_agents_md": "✗ 已卸载 AGENTS.md",
+    "installed_skill": "✓ 已安装 {name}",
+    "skipped_skill": "· 跳过 {name}（已链接）",
+    "conflict_skill": "! 冲突 {name} — 使用 --force 或手动删除",
+    "uninstalled_skill": "✗ 已卸载 {name}"
+  },
+  "debug": {
+    "no_devices": "（无设备）",
+    "device_header": "deviceId\tdeviceName\tlastClearTime",
+    "device_added": "ok: 设备 {deviceId} 已添加",
+    "device_selected": "ok: 设备 {deviceId} 已选中",
+    "device_removed": "ok: 设备 {deviceId} 已移除",
+    "validation_passed": "✓ 验证通过: receiver + appId + 数据格式正常",
+    "validation_failed": "✗ 验证失败: {message}",
+    "no_events_received": "（自 {since} 起无事件）",
+    "event_list_header": "# 事件列表（{count}）:",
+    "device_data_header": "# 设备数据列表（{count}）:",
+    "raw_header": "# 原始数据"
+  },
+  "code": {
+    "inferred_sdk_mode": "[import-xlsx] 推断 sdk_integration_mode: {mode}",
+    "default_sdk_mode": "[import-xlsx] sdk_integration_mode: {mode}（默认，xlsx 无 platform 信息）",
+    "wrote_events": "[import-xlsx] 写入 {count} 个事件至 {path}"
+  },
+  "wiki": {
+    "sync_not_supported": "wiki sync: 需要在仓库 checkout 中运行（scripts/wiki-plan.ts）；",
+    "not_in_published_package": "此功能在发布的 npm 包中不可用。"
+  },
+  "conflict": {
+    "existing_plan_title": "项目已有埋点方案：",
+    "events_count": "- 事件数：{count}",
+    "event_props_count": "- 事件属性数：{count}",
+    "common_props_count": "- 公共属性数：{count}",
+    "user_props_count": "- 用户属性数：{count}",
+    "severe_conflict_title": "⚠️ 严重冲突：同名属性类型不一致",
+    "type_conflict_explanation": "以下属性在既有方案和新方案中类型不同，追加上传会导致上报数据被抛弃：",
+    "suggestion": "建议：",
+    "suggestion_fix_types": "1. 修改新方案的属性类型，与既有方案一致",
+    "suggestion_use_replace": "2. 或选择「替换」模式重新定义类型",
+    "warning_event_exists_title": "⚠️ 提醒：以下事件已存在于项目中（追加模式不会覆盖）",
+    "event_exists_detail": "- {name}（既有：{existingCount} 属性，新方案：{newCount} 属性）",
+    "append_note": "追加后：",
+    "append_note_1": "- 既有事件的属性关联不会改变",
+    "append_note_2": "- 既有事件的新属性不会被添加",
+    "append_note_3": "- 新事件会正常添加",
+    "type_conflict_table_header": "| 属性名 | 既有类型 | 新方案类型 |"
+  },
+  "error": {
+    "ae_error": "AE 错误 {code}",
+    "fetch_failed": "AE 方案获取失败（{statusCode}）: {body}",
+    "fetch_return_code": "AE 方案获取 return_code {code}: {message}",
+    "fetch_no_data": "AE 方案获取无数据（return_code 0 但 data 为空）。Host: {host}",
+    "sitemap_fetch_failed": "获取 sitemap 失败: {statusCode}",
+    "installation_menu_not_found": "sitemap 中未找到 installation_menu",
+    "xlsx_read_failed": "读取 xlsx 文件 \"{path}\" 失败: {error}",
+    "output_path_is_directory": "{option} 必须是文件路径，不能是目录: {path}",
+    "input_path_is_directory": "{option} 必须是文件路径，不能是目录: {path}",
+    "input_path_not_found": "{option} 文件不存在: {path}",
+    "package_root_not_found": "getPackageRoot: 在上级目录中未找到 ae-tracking package.json"
+  },
+  "fix": {
+    "display_name_dedup": "修复显示名重复",
+    "array_row_consistency": "修复对象组子属性不一致",
+    "unknown_prop_ref": "修复未知事件属性引用",
+    "event_prop_name_invalid": "修复事件属性名（转为snake_case）",
+    "event_name_duplicate": "移除重复事件",
+    "detail_suffix": "（详情）",
+    "auto_fix_suffix": "（自动修复命名）"
+  },
+  "user_id": {
+    "account_id_display": "账户ID",
+    "distinct_id_display": "访客ID",
+    "system_property": "系统属性",
+    "set_to": "设置为{field}",
+    "auto_generated": "SDK自动生成或设备相关ID"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.30",
+  "version": "6.0.16",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -11,11 +11,13 @@
     "bin/",
     "dist/",
     "skills/",
+    "wiki/",
+    "tracking-plan-template/",
     "README.md"
   ],
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsup src/index.ts --format esm --outDir dist",
+    "build": "tsup src/index.ts --format esm --outDir dist && node scripts/copy-tracking-assets.mjs",
     "verify:config": "node test/config-commands.test.mjs",
     "verify:analysis-tools": "tsx scripts/verify-te-analysis-tools.mjs",
     "verify:analysis-cluster-routing": "node scripts/verify-analysis-cluster-routing.mjs",
@@ -26,6 +28,7 @@
     "verify:analysis-common-tools": "node scripts/verify-te-common-tools.mjs",
     "verify:team-tools": "node scripts/verify-te-team-tools.mjs",
     "verify:agent-tools": "node scripts/verify-agent-tools.mjs",
+    "verify:tracking-tools": "node test/tracking-client.test.mjs && node test/tracking-commands.test.mjs",
     "verify:self-check-overlay": "node test/self-check-overlay.test.mjs",
     "verify:update-check": "npx tsx test/update-check.test.mjs",
     "self-check": "node self-check/scan.mjs",
@@ -52,9 +55,12 @@
     "@types/json-bigint": "^1.0.4",
     "cli-table3": "^0.6.5",
     "commander": "^12.1.0",
+    "exceljs": "^4.4.0",
     "json-bigint": "^1.0.0",
     "turndown": "^7.2.4",
-    "ws": "^8.18.0"
+    "undici": "^6.19.0",
+    "ws": "^8.18.0",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/skills/ae-agent/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ae-agent
 version: 1.0.0
-description: "AE Agent platform resource management CLI for adding/removing/listing/toggling custom models, MCP servers, Skills, and uploading sandbox files to the attachment library. Use when the user asks to manage Agent platform resources: add a custom model, configure an MCP server, create or toggle a Skill, or upload generated files to the attachment library for download. Must use ae-cli agent commands."
+description: "AE Agent platform resource management CLI for listing Agents, creating and updating automations, adding/removing/listing/toggling custom models, MCP servers, Skills, and uploading sandbox files to the attachment library. Use when the user asks to manage Agent platform resources or create scheduled Agent automations. Must use ae-cli agent commands."
 ---
 
 # ae-agent
@@ -14,7 +14,7 @@ ae-cli agent +<command> [options]
 
 ## Global Rules
 
-- Use this skill for Agent platform resource management: models, MCP servers, Skills, and attachments.
+- Use this skill for Agent platform resource management: Agents, automations, models, MCP servers, Skills, and attachments.
 - Read operations can run directly. Write operations require explicit user intent and normally keep the confirmation prompt unless `--yes` is passed.
 - Prefer `--dry-run` before destructive writes.
 - Only personal scope resources can be created or deleted; company/system resources are read-only in the CLI.
@@ -25,40 +25,52 @@ ae-cli agent +<command> [options]
 
 ## Commands
 
+### Agents
+
+| Command        | Risk | Purpose                                                        |
+| -------------- | ---: | -------------------------------------------------------------- |
+| `+list-agents` | read | List Agents visible to current user (personal/company/system). |
+
+### Automations
+
+| Command              |  Risk | Purpose                                |
+| -------------------- | ----: | -------------------------------------- |
+| `+create-automation` | write | Create an Agent automation task. |
+
 ### Models
 
-| Command | Risk | Purpose |
-|---|---:|---|
-| `+list-models` | read | List models visible to current user (personal/company/system). |
-| `+add-model` | write | Add a custom model (personal scope). |
-| `+del-model` | write | Delete a personal model. |
-| `+toggle-model` | write | Enable or disable a model. |
+| Command         |  Risk | Purpose                                                        |
+| --------------- | ----: | -------------------------------------------------------------- |
+| `+list-models`  |  read | List models visible to current user (personal/company/system). |
+| `+add-model`    | write | Add a custom model (personal scope).                           |
+| `+del-model`    | write | Delete a personal model.                                       |
+| `+toggle-model` | write | Enable or disable a model.                                     |
 
 ### MCP Servers
 
-| Command | Risk | Purpose |
-|---|---:|---|
-| `+list-mcps` | read | List MCP servers visible to current user. |
-| `+add-mcp` | write | Add an MCP server (personal scope). |
-| `+del-mcp` | write | Delete a personal MCP server. |
-| `+toggle-mcp` | write | Enable or disable an MCP server. |
+| Command       |  Risk | Purpose                                   |
+| ------------- | ----: | ----------------------------------------- |
+| `+list-mcps`  |  read | List MCP servers visible to current user. |
+| `+add-mcp`    | write | Add an MCP server (personal scope).       |
+| `+del-mcp`    | write | Delete a personal MCP server.             |
+| `+toggle-mcp` | write | Enable or disable an MCP server.          |
 
 ### Skills
 
-| Command | Risk | Purpose |
-|---|---:|---|
-| `+list-skills` | read | List Skills visible to current user. |
-| `+add-skill` | write | Create a custom Skill (personal scope). |
-| `+del-skill` | write | Delete a personal Skill (physical delete). |
-| `+toggle-skill` | write | Enable or disable a Skill. |
+| Command         |  Risk | Purpose                                    |
+| --------------- | ----: | ------------------------------------------ |
+| `+list-skills`  |  read | List Skills visible to current user.       |
+| `+add-skill`    | write | Create a custom Skill (personal scope).    |
+| `+del-skill`    | write | Delete a personal Skill (physical delete). |
+| `+toggle-skill` | write | Enable or disable a Skill.                 |
 
 ### Attachments
 
-| Command | Risk | Purpose |
-|---|---:|---|
-| `+list-attachments` | read | List user attachments (paginated). |
-| `+add-attachment` | write | Upload sandbox file(s) to attachment library. |
-| `+del-attachment` | write | Soft-delete an attachment. |
+| Command             |  Risk | Purpose                                       |
+| ------------------- | ----: | --------------------------------------------- |
+| `+list-attachments` |  read | List user attachments (paginated).            |
+| `+add-attachment`   | write | Upload sandbox file(s) to attachment library. |
+| `+del-attachment`   | write | Soft-delete an attachment.                    |
 
 ## Usage Examples
 
@@ -69,6 +81,33 @@ ae-cli agent +list-models
 ae-cli agent +list-models --scope personal --format table
 ```
 
+### List all visible Agents
+
+```bash
+ae-cli agent +list-agents
+ae-cli agent +list-agents --scope personal --q "daily"
+```
+
+### Create an enabled daily automation
+
+```bash
+ae-cli agent +create-automation \
+  --name "Daily AI Brief" \
+  --schedule-kind daily \
+  --time 09:00 \
+  --message "Summarize yesterday's AI news" \
+  --yes
+
+# Create but keep paused when the user explicitly asks not to enable it.
+ae-cli agent +create-automation \
+  --name "Daily AI Brief" \
+  --schedule-kind daily \
+  --time 09:00 \
+  --message "Summarize yesterday's AI news" \
+  --enabled false \
+  --yes
+```
+
 ### Add a custom model
 
 ```bash
@@ -128,6 +167,7 @@ ae-cli agent +toggle-model --id <model-cuid> --enabled false
 ## Notes
 
 - Only `personal` scope resources can be created or deleted via CLI.
+- Automations are enabled by default; pass `--enabled false` only when the user explicitly asks to create or update the task without enabling it. Use `+list-automations` to find the target ID internally, but do not show automation IDs, raw JSON, or concrete detail paths in user-facing replies.
 - MCP creation does NOT validate server connectivity — an unreachable URL is accepted at create time and only fails when the agent actually calls the MCP at runtime. Double-check the URL.
 - Attachment upload supports files up to 50MB each, with a 1GB user quota.
 - Batch attachment uploads support partial success — individual file failures don't affect others.