[Feature Request] Add createdAt field to mavis cron task schema

[Sixone-L]

GitHub Issue: Add createdAt field to mavis cron task schema

目标仓库：<mavis 团队 GitHub repo URL>（请用户根据 mavis 项目实际情况填入）
作者：通过 MiniMax Code 提交（用户：Sixone-L）
时间：2026-06-26
相关 issue/PR：（首次提交，搜索历史无重复）

---

Title

[Feature Request] Add createdAt field to mavis cron task schema for audit and lifecycle tracking

---

Summary

mavis 的 cron 任务配置 schema 目前不记录任务创建时间（createdAt）。当用户问"这 cron 什么时候配的 / 谁加的"时，无法给出准确答案——只能反推文件 mtime 或 sessions.json 的"首次跑"时间（不准，且 sessions.json 在 cron 从未跑过时不存在）。

提议：在 cron 任务配置（crons/<name>.md 或等价的存储）增加 createdAt 字段（ISO 8601 时间戳），由 mavis 在 cron create 时自动填。

---

Problem

场景 1：用户问"这 cron 什么时候建的？"

• 用户的 mavis 配置了多个 cron 任务（6-10 个常见）
• 用户某天发现 realtime-chat-archive 在跑，但不记得什么时候配的
• 用户问 mavis / 翻配置文件都查不到 createdAt
• 只能通过文件 mtime 估算，但 mtime 不可靠（如果 mavis 升级或 schema 迁移会重写文件）

场景 2：审计 / 多人协作

• 团队多人都能配 cron
• 出问题排查时需要"谁加的 / 什么时候加的"
• 现在只能从 git blame + 文件 mtime 推，不准确也不直接

场景 3：清理孤儿 cron

• 维护时想删"很久没跑过的 cron"
• 没有 createdAt，无法判断"这 cron 是 1 周前新加的"还是"3 个月前历史遗留"
• 误删可能引发数据丢失

数据（真实场景）

2026-06-26：用户 Sixone-L 在 MiniMax Code 里发现 6 个 mavis 默认 cron 任务，问"什么时候建的"。mavis 提供的信息：

• mavis cron info 输出没有 createdAt 字段
• 配置文件 schema crons/<name>.md 没有 createdAt 字段
• 用户被迫查 crons/<name>.sessions.json 的 first session 推断（不准——cron 从未跑过时不存在）
• 也可查文件 mtime 推断（不准——文件被改过就丢）

真实数据：6 个 cron 的 first session 时间分布在 2026-06-25 19:30 UTC ~ 2026-06-26 07:06 UTC（跨 12 小时），说明不是同一次触发——没有 createdAt 字段就只能猜。

---

Proposed Solution

Schema 变更

在 crons/<name>.md 的 YAML frontmatter 增加一个字段：

---
name: realtime-chat-archive
schedule: '* * * * *'
timezone: Asia/Shanghai
createdAt: 2026-06-26T15:06:00+08:00    # ← 新增
createdBy: user:sixone-l                # ← 可选：审计用
report_to_root: false
---

Run: node M:\MiniMax\ObsidianVault\.scripts\realtime-monitor.js

CLI 行为变更

# 现在
$ mavis cron info mavis realtime-chat-archive
{
  "cronName": "realtime-chat-archive",
  "schedule": "* * * * *",
  "timezone": "Asia/Shanghai",
  "enabled": true,
  "prompt": "...",
  "status": "idle",
  "lastRun": ...,
  "lastResult": "success",
  "nextRun": ...
}

# 提议
$ mavis cron info mavis realtime-chat-archive
{
  "cronName": "realtime-chat-archive",
  "schedule": "* * * * *",
  "timezone": "Asia/Shanghai",
  "enabled": true,
  "createdAt": "2026-06-26T15:06:00+08:00",   # ← 新增
  "createdBy": "user:sixone-l",                 # ← 可选
  "prompt": "...",
  "status": "idle",
  "lastRun": ...,
  "lastResult": "success",
  "nextRun": ...
}

# 现在
$ mavis cron list mavis
NAME                  SCHEDULE      ENABLED   STATUS
...

# 提议（可选加 CREATED 列）
$ mavis cron list mavis
NAME                          SCHEDULE       ENABLED   CREATED                STATUS
realtime-chat-archive         * * * * *      yes       2026-06-26T15:06:00   idle
...

---

Implementation Notes（思路，不强求）

1. 存储：在 crons/<name>.md 的 frontmatter 加 createdAt 字段（无需新文件）
2. 写入：在 cron create 命令执行时，由 mavis 自动写当前时间（ISO 8601 with timezone）
3. 读取：cron info / cron list 直接读 frontmatter 字段
4. 可选：createdBy 字段（用户/agent/系统），审计场景用
5. 不需要 new API endpoint——现有 schema 增量扩展

---

Migration（向后兼容）

已有 6+ 个原 cron 怎么办？

方案 A（推荐）：mavis 启动时检查——如果 frontmatter 没有 createdAt，用 crons/<name>.md 的文件 mtime 或 sessions.json 的 first createdAt 估算，自动回填。

方案 B：在 mavis cron 加一个 migrate 子命令（一次性），由用户手动跑。

方案 C：不迁移，已有任务不补 createdAt，新增任务才有。

推荐 A——零用户操作 + 估算值比"没值"好。

迁移逻辑伪代码

def migrate_cron_config(cron_md_path):
    fm = read_frontmatter(cron_md_path)
    if 'createdAt' in fm:
        return  # already migrated
    
    # 优先级 1: sessions.json first createdAt
    sessions_json = cron_md_path.with_suffix('.sessions.json')
    if sessions_json.exists():
        first = read_json(sessions_json)['sessions'][0]
        fm['createdAt'] = format_iso8601(first['createdAt'])
    
    # 优先级 2: 文件 mtime（cron 从未跑过的情况）
    else:
        fm['createdAt'] = format_iso8601(os.path.getmtime(cron_md_path))
    
    write_frontmatter(cron_md_path, fm)

---

Use Cases（实施后解锁的能力）

1. 审计：查看"过去 30 天新增的 cron"（mavis cron list --since 30d）
2. 清理：识别"超过 1 年没碰的孤儿 cron"，提醒用户确认删除
3. 协作：明确"这 cron 是哪个 session 加的"
4. 用户视角："数据管理员每 30 分钟整理一次数据"——管理员能精确说"这个 cron 配了多久"
5. 未来扩展：可加 updatedAt 字段追踪"上次修改"，进一步丰富审计

---

Why Now

• mavis 已成熟使用（MiniMax Code 用户群），cron 任务越来越多
• 用户真实遇到问题（2026-06-26 用户提问"第一个什么时候创建的"，无解）
• 字段轻量——只是 schema 增量，不需要破坏性变更
• 迁移成本低（自动估算回填）

---

Priority

Medium——不是紧急 bug，但影响所有 mavis 重度用户的运维体验。建议排到下个 minor release。

---

Labels (建议)

• enhancement
• area/cron
• good first issue（实现简单，适合新人）

---

Related

• 用户工作流参考：<贴用户 vault 的 created-at 索引文件链接>
• 实际场景日志：2026-06-26 用户 Sixone-L 在 MiniMax Code 里发现 6 个原 cron 没法查 createdAt
• 相关讨论：（首次提交，无相关 issue）

---

Checklist (for maintainers)

• 决定 createdAt 字段名（建议 createdAt，与生态对齐）
• 决定是否加 createdBy（可选字段）
• 决定迁移策略（A/B/C）
• 实现 cron create 自动写 createdAt
• 实现 cron info / cron list 读 createdAt
• 实现迁移工具（自动回填）
• 更新 mavis 文档（crons 配置章节）
• 在 release notes 标注 schema 变更
• 通知用户"可以删 vault 内的伪索引文件了"