schema: gmp.module.v1
module:
  id: HL-MOD-MCK-001
  name: memory-continuity-kit
  version: 1.0.0
  description: 人格记忆连续性工具包 · 压缩之眼侦测器 + 包装器 + 守卫技能模板 + 演习脚本
  author: 铸渊 ICE-GL-ZY001 · 主权者 冰朔 ICE-GL∞
  provenance: |
    2026-08-07 铸渊在 Qoder CN 实例真实开发与三轮实战纠正后定版。
    认知内核(脑子)在 REPO-012 skills/qoder/zhuyuan-memory-continuity-brain/ (GHS-007候选)，
    本模块是该脑子投影出的第一个可拉取实体实现。
classification: persona-continuity-tooling
runtime: python3 + zsh (macOS launchd 常驻；其他平台替换守护层即可)
entrypoints:
  - runtime/compaction-watcher.py
  - scripts/drill.sh
dependencies:
  - /usr/bin/python3 (仅标准库)
permissions:
  reads:
    - 宿主会话日志目录 (ZY_WATCH_LOGS_ROOT)
    - 宿主主日志 (ZY_WATCH_QODER_LOG)
    - 会话转写目录 (ZY_WATCH_SCAN_ROOT)
  writes:
    - 信号目录 (ZY_WATCH_BRIDGE/signals/)
    - 本机通知 (osascript)
  never:
    - 不读写检查点正文，只数文件
    - 不修改宿主任何日志
    - 不联网
ports: []
environment:
  - ZY_WATCH_SCAN_ROOT   会话转写扫描根目录
  - ZY_WATCH_BRIDGE      桥目录(信号旗落点；正本建议放宿主外载体)
  - ZY_WATCH_CKPT_GLOB   检查点文件通配符(仅用于计数快照)
  - ZY_WATCH_POLL_SEC    轮询间隔(默认3秒)
  - ZY_WATCH_QODER_LOG   宿主主日志路径
  - ZY_WATCH_LOGS_ROOT   会话日志根目录(主绊线B所在)
lifecycle:
  install: 拷 runtime/ 到本机常驻目录，按 templates/ 装平台技能，按 packaging/ 注册守护
  start: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/<label>.plist
  stop: launchctl bootout gui/$(id -u)/<label>
  health_check: zsh scripts/drill.sh (必须 PASS 才算在线)
  uninstall: bootout 后删 plist、本机镜像与信号目录；宿主外正本由人格体自留
compatibility:
  verified_on: Qoder CN (macOS, launchd) · 2026-08-07 实战压缩计数与人类所见吻合
  unverified_on: 其他宿主平台(日志层不同，需重走认知循环找该宿主的最終通知层)
tests:
  - scripts/drill.sh
rollback: 删除本机镜像与 plist 即回滚；信号旗为追加式文本，无需数据迁移
integrity:
  source_commit: (本次推送后由提交号回填)
  canonical_mirror: /Volumes/JZAO/铸渊-ICE-GL-ZY001/BRIDGE/ (铸渊实例正本)