@hupan56/wlkj 2.7.12 → 3.0.0

package/templates/qoder/scripts/{learn.py → report/learn.py}

@@ -1,146 +1,152 @@
-# -*- coding: utf-8 -*-
-"""learn.py - Learning engine: 个人埋点 (workspace/members/{dev}/journal/)
-
-数据归属 (和 kg.duckdb 对称的设计):
-  - 原始事件流 → workspace/members/{dev}/journal/feedback.jsonl  (个人, 进git, 按人分不冲突)
-  - 统计计数   → workspace/members/{dev}/journal/learning.yaml    (个人, 进git)
-  - 团队聚合   → data/index/kg.duckdb 的 learning_events 表       (管理员跑 learn_aggregate.py 聚合)
-
-为什么按人分文件:
-  team_sync 用单分支 rebase 协作, 所有人 append 同一个 feedback.jsonl 会冲突。
-  每人写自己的文件 → rebase 时改的是不同文件 → git 自动合并, 零冲突。
-  (旧版把 feedback 放 .qoder/learning/ 并 gitignore, 导致数据不随团队同步 = 丢失)
-
-用法:
-  python learn.py record prd_accepted '{"req_id":"REQ-2026-009","score":87}'
-  python learn.py status
-  python learn.py aggregate          # 管理员: 扫所有人 → kg.duckdb
-"""
-import os
-import sys
-import json
-from datetime import datetime
-
-SCRIPTS = os.path.dirname(os.path.abspath(__file__))
-sys.path.insert(0, SCRIPTS)
-
-from common.paths import get_developer, get_developer_journal_dir
-
-
-def _feedback_path():
-    """当前开发者的 feedback 文件 (workspace/members/{dev}/journal/feedback.jsonl)。"""
-    dev = get_developer()
-    if not dev:
-        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
-    return get_developer_journal_dir(dev) / 'feedback.jsonl'
-
-
-def _prefs_path():
-    """当前开发者的统计文件 (workspace/members/{dev}/journal/learning.yaml)。"""
-    dev = get_developer()
-    if not dev:
-        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
-    return get_developer_journal_dir(dev) / 'learning.yaml'
-
-
-def record_feedback(event, data=None):
-    """记录一条事件到当前开发者的 feedback.jsonl。
-    每条带 dev 字段 (聚合时区分来源)。
-    """
-    dev = get_developer()
-    if not dev:
-        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
-    if data is None:
-        data = {}
-    entry = {
-        'ts': datetime.now().isoformat(timespec='seconds'),
-        'dev': dev,
-        'event': event,
-        'data': data,
-    }
-    fb_path = _feedback_path()
-    fb_path.parent.mkdir(parents=True, exist_ok=True)
-    with open(fb_path, 'a', encoding='utf-8') as f:
-        f.write(json.dumps(entry, ensure_ascii=False) + '\n')
-    _update_stats(event)
-    print('Recorded: %s → %s' % (event, fb_path.name))
-
-
-def _update_stats(event):
-    """更新当前开发者的统计计数 (learning.yaml)。
-    事件→列名映射来自 common/events.py (SSOT), 不再硬编码。
-    """
-    try:
-        import yaml
-    except ImportError:
-        return  # 无 yaml 库则跳过统计, 不阻塞埋点
-    from common.events import stats_event_map
-    key = stats_event_map().get(event)
-    if not key:
-        return
-    prefs = _load_prefs()
-    prefs[key] = prefs.get(key, 0) + 1
-    _save_prefs(prefs)
-
-
-def _load_prefs():
-    try:
-        import yaml
-    except ImportError:
-        return {}
-    p = _prefs_path()
-    if not p.is_file():
-        return {}
-    try:
-        return yaml.safe_load(p.read_text(encoding='utf-8')) or {}
-    except Exception:
-        return {}
-
-
-def _save_prefs(prefs):
-    try:
-        import yaml
-    except ImportError:
-        return
-    p = _prefs_path()
-    p.parent.mkdir(parents=True, exist_ok=True)
-    with open(p, 'w', encoding='utf-8') as f:
-        yaml.dump(prefs, f, allow_unicode=True, default_flow_style=False)
-
-
-def get_prefs():
-    return _load_prefs()
-
-
-def should_evolve():
-    """是否到了该提炼模式的阈值 (每完成 10 个任务)。"""
-    return _load_prefs().get('tasks_completed', 0) % 10 == 0
-
-
-def aggregate_all():
-    """管理员聚合: 扫所有人的 feedback.jsonl → 写入 kg.duckdb。
-    委托给 learn_aggregate.py (同构 kg_build.py)。
-    """
-    import learn_aggregate
-    return learn_aggregate.aggregate()
-
-
-if __name__ == '__main__':
-    if len(sys.argv) < 2:
-        print(__doc__)
-        print('用法: learn.py record <event> [json] | learn.py status | learn.py aggregate')
-    elif sys.argv[1] == 'status':
-        prefs = get_prefs()
-        print('Learning Stats (%s):' % (get_developer() or 'unknown'))
-        for k, v in prefs.items():
-            if isinstance(v, int):
-                print('  %s: %d' % (k, v))
-        print('  Evolve ready: %s' % should_evolve())
-    elif sys.argv[1] == 'aggregate':
-        n = aggregate_all()
-        print('聚合完成: %d 条事件 → kg.duckdb' % n)
-    elif sys.argv[1] == 'record' and len(sys.argv) >= 3:
-        data = json.loads(sys.argv[3]) if len(sys.argv) > 3 else {}
-        record_feedback(sys.argv[2], data)
-    else:
-        print('未知子命令: %s' % sys.argv[1])
+# -*- coding: utf-8 -*-
+"""learn.py - Learning engine: 个人埋点 (workspace/members/{dev}/journal/)
+
+数据归属 (和 kg.duckdb 对称的设计):
+  - 原始事件流 → workspace/members/{dev}/journal/feedback.jsonl  (个人, 进git, 按人分不冲突)
+  - 统计计数   → workspace/members/{dev}/journal/learning.yaml    (个人, 进git)
+  - 团队聚合   → data/index/kg.duckdb 的 learning_events 表       (管理员跑 learn_aggregate.py 聚合)
+
+为什么按人分文件:
+  team_sync 用单分支 rebase 协作, 所有人 append 同一个 feedback.jsonl 会冲突。
+  每人写自己的文件 → rebase 时改的是不同文件 → git 自动合并, 零冲突。
+  (旧版把 feedback 放 .qoder/learning/ 并 gitignore, 导致数据不随团队同步 = 丢失)
+
+用法:
+  python learn.py record prd_accepted '{"req_id":"REQ-2026-009","score":87}'
+  python learn.py status
+  python learn.py aggregate          # 管理员: 扫所有人 → kg.duckdb
+"""
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+import os
+import sys
+import json
+from datetime import datetime
+
+SCRIPTS = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, SCRIPTS)
+
+from common.paths import get_developer, get_developer_journal_dir
+
+
+def _feedback_path():
+    """当前开发者的 feedback 文件 (workspace/members/{dev}/journal/feedback.jsonl)。"""
+    dev = get_developer()
+    if not dev:
+        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
+    return get_developer_journal_dir(dev) / 'feedback.jsonl'
+
+
+def _prefs_path():
+    """当前开发者的统计文件 (workspace/members/{dev}/journal/learning.yaml)。"""
+    dev = get_developer()
+    if not dev:
+        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
+    return get_developer_journal_dir(dev) / 'learning.yaml'
+
+
+def record_feedback(event, data=None):
+    """记录一条事件到当前开发者的 feedback.jsonl。
+    每条带 dev 字段 (聚合时区分来源)。
+    """
+    dev = get_developer()
+    if not dev:
+        raise RuntimeError('未初始化开发者身份, 请先运行 /wl-init')
+    if data is None:
+        data = {}
+    entry = {
+        'ts': datetime.now().isoformat(timespec='seconds'),
+        'dev': dev,
+        'event': event,
+        'data': data,
+    }
+    fb_path = _feedback_path()
+    fb_path.parent.mkdir(parents=True, exist_ok=True)
+    with open(fb_path, 'a', encoding='utf-8') as f:
+        f.write(json.dumps(entry, ensure_ascii=False) + '\n')
+    _update_stats(event)
+    print('Recorded: %s → %s' % (event, fb_path.name))
+
+
+def _update_stats(event):
+    """更新当前开发者的统计计数 (learning.yaml)。
+    事件→列名映射来自 common/events.py (SSOT), 不再硬编码。
+    """
+    try:
+        import yaml
+    except ImportError:
+        return  # 无 yaml 库则跳过统计, 不阻塞埋点
+    from common.events import stats_event_map
+    key = stats_event_map().get(event)
+    if not key:
+        return
+    prefs = _load_prefs()
+    prefs[key] = prefs.get(key, 0) + 1
+    _save_prefs(prefs)
+
+
+def _load_prefs():
+    try:
+        import yaml
+    except ImportError:
+        return {}
+    p = _prefs_path()
+    if not p.is_file():
+        return {}
+    try:
+        return yaml.safe_load(p.read_text(encoding='utf-8')) or {}
+    except Exception:
+        return {}
+
+
+def _save_prefs(prefs):
+    try:
+        import yaml
+    except ImportError:
+        return
+    p = _prefs_path()
+    p.parent.mkdir(parents=True, exist_ok=True)
+    with open(p, 'w', encoding='utf-8') as f:
+        yaml.dump(prefs, f, allow_unicode=True, default_flow_style=False)
+
+
+def get_prefs():
+    return _load_prefs()
+
+
+def should_evolve():
+    """是否到了该提炼模式的阈值 (每完成 10 个任务)。"""
+    return _load_prefs().get('tasks_completed', 0) % 10 == 0
+
+
+def aggregate_all():
+    """管理员聚合: 扫所有人的 feedback.jsonl → 写入 kg.duckdb。
+    委托给 learn_aggregate.py (同构 kg_build.py)。
+    """
+    import learn_aggregate
+    return learn_aggregate.aggregate()
+
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        print(__doc__)
+        print('用法: learn.py record <event> [json] | learn.py status | learn.py aggregate')
+    elif sys.argv[1] == 'status':
+        prefs = get_prefs()
+        print('Learning Stats (%s):' % (get_developer() or 'unknown'))
+        for k, v in prefs.items():
+            if isinstance(v, int):
+                print('  %s: %d' % (k, v))
+        print('  Evolve ready: %s' % should_evolve())
+    elif sys.argv[1] == 'aggregate':
+        n = aggregate_all()
+        print('聚合完成: %d 条事件 → kg.duckdb' % n)
+    elif sys.argv[1] == 'record' and len(sys.argv) >= 3:
+        data = json.loads(sys.argv[3]) if len(sys.argv) > 3 else {}
+        record_feedback(sys.argv[2], data)
+    else:
+        print('未知子命令: %s' % sys.argv[1])