pi-coding-master 0.2.7

package/README.md

@@ -0,0 +1,50 @@
+# pi-coding-master
+
+Living AI agent extension for [pi-coding-agent](https://github.com/nicepkg/pi-coding-agent).
+
+## Install
+
+```bash
+# 1. Install pi (pinned version)
+npm i -g @earendil-works/pi-coding-agent@0.79.10
+
+# 2. Install pi-coding-master
+npm i -g pi-coding-master
+
+# Done. Run: pi <person-name>
+```
+
+## Update
+
+```bash
+npm i -g pi-coding-master@latest
+```
+
+## Manual Install
+
+```bash
+# Download release, then:
+bash deploy/install.sh
+```
+
+## Requirements
+
+- Node.js >= 18
+- macOS or Linux
+- tmux (for subconscious/hippocampus)
+- bun (for TypeScript extension loading)
+
+## What it does
+
+pi-coding-master turns pi into a persistent, living agent with:
+
+- **Heartbeat** - continuous mode with next()/wait/hibernate state machine
+- **Memory** - 5-layer memory system (DNA/Context/WorkMemory/Cortex/DeepCortex)
+- **Subconscious** - parallel observer process that reflects on main consciousness
+- **Hippocampus** - memory encoding subprocess
+- **Sleep** - memory consolidation (work_memory -> cortex)
+- **Senses** - ears (speech-to-text), mouth (TTS), phone (browser/apps)
+
+## License
+
+MIT

package/core/god.agent.capability/@ABANDONED.brain.prefrontal.monitor/gpu_monitor.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""
+GPU Idle Monitor — pi-alive habit.
+Alerts when remote/local GPU goes idle so models can be deployed.
+
+Usage:
+  python3 gpu_monitor.py --remote --daemon
+  python3 gpu_monitor.py --remote --alert-method notification --alert-prompt "快跑SLA!"
+"""
+import subprocess, time, os, sys, argparse, json
+
+CONFIG = os.path.expanduser("~/.pi/gpu_monitor.json")
+DEFAULT_HOST = "connect.westc.seetacloud.com"
+DEFAULT_PORT = 12580
+DEFAULT_PASS = "kgJpl066jEtZ"
+
+def get_gpu(host, port, pw):
+    cmd = f"sshpass -p '{pw}' ssh -o StrictHostKeyChecking=no -p {port} root@{host} 'nvidia-smi --query-gpu=utilization.gpu --format=csv,noheader' 2>/dev/null"
+    try:
+        out = subprocess.check_output(cmd, shell=True, timeout=10)
+        return max(int(l.replace("%","").strip()) for l in out.decode().strip().split("\n") if l.strip())
+    except: return None
+
+def alert(msg, method, prompt):
+    full = f"{msg} | {prompt}"
+    if method == "print": print(f"[GPU] {full}", flush=True)
+    elif method == "notification":
+        subprocess.run(["osascript","-e",f'display notification "{full}" with title "GPU Alert"'],capture_output=True)
+    elif method == "file":
+        with open(os.path.expanduser("~/.pi/gpu_alerts.log"),"a") as f:
+            f.write(f"{time.strftime('%m-%d %H:%M')} {full}\n")
+
+def main():
+    p = argparse.ArgumentParser()
+    p.add_argument("--threshold",type=int,default=10)
+    p.add_argument("--check",type=int,default=15)
+    p.add_argument("--idle-sec",type=int,default=30)
+    p.add_argument("--host",default=DEFAULT_HOST)
+    p.add_argument("--port",type=int,default=DEFAULT_PORT)
+    p.add_argument("--passwd",default=DEFAULT_PASS)
+    p.add_argument("--alert",default="print",help="print|notification|file")
+    p.add_argument("--prompt",default="GPU空闲!立刻训练SLA模型!")
+    p.add_argument("--remote",action="store_true")
+    p.add_argument("--daemon",action="store_true")
+    args = p.parse_args()
+    
+    if args.daemon:
+        pid = os.fork()
+        if pid: print(f"Daemon PID={pid}"); return
+    
+    h = args.host if args.remote else None
+    print(f"GPU Monitor | remote={args.remote} | thresh={args.threshold}% | check={args.check}s")
+    idle_start = None
+    
+    while True:
+        if args.remote: utils = get_gpu(h, args.port, args.passwd)
+        else:
+            try:
+                out = subprocess.check_output("nvidia-smi --query-gpu=utilization.gpu --format=csv,noheader",shell=True,timeout=5)
+                utils = max(int(l.replace("%","").strip()) for l in out.decode().strip().split("\n") if l.strip())
+            except: utils = -1
+        
+        if utils is None or utils < 0:
+            time.sleep(args.check); continue
+        
+        if utils <= args.threshold:
+            if idle_start is None: idle_start = time.time()
+            sec = time.time() - idle_start
+            if sec >= args.idle_sec:
+                alert(f"GPU idle {int(sec)}s (util={utils}%)", args.alert, args.prompt)
+                time.sleep(args.idle_sec)
+        else:
+            if idle_start and time.time()-idle_start > 10:
+                alert(f"GPU active (util={utils}%)", args.alert, "继续监控")
+            idle_start = None
+        
+        time.sleep(args.check)
+
+if __name__ == "__main__":
+    main()

package/core/god.agent.capability/@ABANDONED.brain.prefrontal.monitor/gpu_monitor.py.CHANGELOG

@@ -0,0 +1 @@
+[2026-06-15 21:05:24] created

package/core/god.agent.capability/@ABANDONED.brain.prefrontal.monitor/gpu_monitor.py.SPEC

@@ -0,0 +1,3 @@
+source: gpu_monitor.py @ e897b052
+
+GPU空闲监控habit: 远程H800/本地GPU, 可配置阈值+警告方式+提示词

package/core/god.agent.capability/hands.dev.writeissue/issue.ts

@@ -0,0 +1,209 @@
+// god.agent.capability/hands.dev.writedoc — 通用开发文档写入
+// 支持 ISSUE / LESSON / NORM 等所有 .{TYPE}.md 文档类型。
+// 规律：目录 Docs.Dev.{Type}s/ · 文件 NNN-slug.{TYPE}.md · 索引 {Type}s.INDEX.md
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { readFileSync, writeFileSync, readdirSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { DIRS } from "#paths";
+
+type DocType = "ISSUE" | "LESSON" | "NORM";
+
+const DOC_CONFIG: Record<DocType, { plural: string; dir: string; hasStatus: boolean }> = {
+  ISSUE:  { plural: "Issues",  dir: DIRS.devIssues,  hasStatus: true },
+  LESSON: { plural: "Lessons", dir: DIRS.devLessons, hasStatus: false },
+  NORM:   { plural: "Norms",   dir: DIRS.devNorms,   hasStatus: false },
+};
+
+function docDir(type: DocType): string {
+  return DOC_CONFIG[type].dir;
+}
+
+function ensureDir(type: DocType): void { try { mkdirSync(docDir(type), { recursive: true }); } catch {} }
+function pad(n: number): string { return String(n).padStart(3, "0"); }
+function today(): string { return new Date().toISOString().slice(0, 10); }
+
+function slugify(title: string): string {
+  return title.trim().toLowerCase()
+    .replace(/[\s/\\]+/g, "-")
+    .replace(/[^\p{L}\p{N}\-_]/gu, "")
+    .slice(0, 40) || "entry";
+}
+
+interface DocMeta { num: number; file: string; status: string; title: string; created: string; }
+
+function filePattern(type: DocType): RegExp {
+  return new RegExp(`^\\d{3}-.*\\.${type}$`);
+}
+
+function listFiles(type: DocType): string[] {
+  ensureDir(type);
+  try { return readdirSync(docDir(type)).filter((f) => filePattern(type).test(f)).sort(); } catch { return []; }
+}
+
+function parseDoc(type: DocType, file: string): DocMeta | null {
+  try {
+    const content = readFileSync(join(docDir(type), file), "utf8");
+    const num = parseInt(file.slice(0, 3), 10);
+    const status = content.match(/^status:\s*(.+)$/m)?.[1]?.trim() ?? "open";
+    const title = content.match(/^#\s*\[\d+\]\s*(.+)$/m)?.[1]?.trim() ?? file.replace(/\.md$/, "");
+    const created = content.match(/^created:\s*(.+)$/m)?.[1]?.trim() ?? "";
+    return { num, file, status, title, created };
+  } catch { return null; }
+}
+
+function nextNum(type: DocType): number {
+  let max = 0;
+  for (const f of listFiles(type)) { const n = parseInt(f.slice(0, 3), 10); if (n > max) max = n; }
+  return max + 1;
+}
+
+function regenIndex(type: DocType): void {
+  ensureDir(type);
+  const cfg = DOC_CONFIG[type];
+  const docs = listFiles(type).map((f) => parseDoc(type, f)).filter(Boolean) as DocMeta[];
+
+  const L: string[] = [
+    `# pi-coding-master ${cfg.plural} — 索引`,
+    "",
+    `_自动生成，别手改。_`,
+    "",
+  ];
+
+  if (cfg.hasStatus) {
+    const open = docs.filter((d) => d.status === "open");
+    const done = docs.filter((d) => d.status !== "open");
+    L.push(`**打开 ${open.length} · 已解决 ${done.length} · 共 ${docs.length}**`, "");
+    L.push("## 打开");
+    if (open.length) for (const d of open) L.push(`- [${pad(d.num)}](${d.file}) — ${d.title}${d.created ? ` _(${d.created})_` : ""}`);
+    else L.push("_（无）_");
+    L.push("", "## 已解决");
+    if (done.length) for (const d of done) L.push(`- [${pad(d.num)}](${d.file}) — ${d.title} — ${d.status}`);
+    else L.push("_（无）_");
+  } else {
+    L.push(`**共 ${docs.length} 条**`, "");
+    for (const d of docs) L.push(`- [${pad(d.num)}](${d.file}) — ${d.title}${d.created ? ` _(${d.created})_` : ""}`);
+    if (!docs.length) L.push("_（无）_");
+  }
+
+  writeFileSync(join(docDir(type), `${cfg.plural}.INDEX`), L.join("\n") + "\n");
+}
+
+export function addDoc(type: DocType, title: string, detail: string): number {
+  ensureDir(type);
+  const num = nextNum(type);
+  const file = `${pad(num)}-${slugify(title)}.${type}`;
+  const lines = [`# [${pad(num)}] ${title}`];
+  if (DOC_CONFIG[type].hasStatus) lines.push("status: open");
+  lines.push(`created: ${today()}`, "", detail || "（暂无详情）", "");
+  writeFileSync(join(docDir(type), file), lines.join("\n"));
+  regenIndex(type);
+  return num;
+}
+
+export function setStatus(type: DocType, num: number, status: string): boolean {
+  if (!DOC_CONFIG[type].hasStatus) return false;
+  const file = listFiles(type).find((f) => parseInt(f.slice(0, 3), 10) === num);
+  if (!file) return false;
+  const p = join(docDir(type), file);
+  let content = readFileSync(p, "utf8");
+  content = /^status:\s*.+$/m.test(content)
+    ? content.replace(/^status:\s*.+$/m, `status: ${status}`)
+    : content.replace(/\n/, `\nstatus: ${status}\n`);
+  writeFileSync(p, content);
+  regenIndex(type);
+  return true;
+}
+
+export function listOpen(type: DocType): DocMeta[] {
+  const docs = listFiles(type).map((f) => parseDoc(type, f)).filter(Boolean) as DocMeta[];
+  return DOC_CONFIG[type].hasStatus ? docs.filter((d) => d.status === "open") : docs;
+}
+
+export function readDoc(type: DocType, num: number): string | null {
+  const file = listFiles(type).find((f) => parseInt(f.slice(0, 3), 10) === num);
+  return file ? readFileSync(join(docDir(type), file), "utf8") : null;
+}
+
+// ── 注册命令和工具 ──
+
+function handleDocCommand(type: DocType, rawArgs: string, ctx: any): void {
+  const cfg = DOC_CONFIG[type];
+  const label = cfg.plural.toLowerCase();
+  const a = rawArgs.trim();
+
+  if (!a || a === "list" || a === "ls") {
+    const docs = listOpen(type);
+    if (!docs.length) { ctx.ui.notify(`没有${label}。`, "info"); return; }
+    ctx.ui.notify(`${label}：\n` + docs.map((d: DocMeta) => `  #${pad(d.num)}  ${d.title}`).join("\n"), "info");
+    return;
+  }
+
+  if (cfg.hasStatus) {
+    const close = a.match(/^(?:close|fix|fixed|resolve|done|解决|关)\s+#?(\d+)$/i);
+    if (close) {
+      const n = parseInt(close[1], 10);
+      ctx.ui.notify(setStatus(type, n, "fixed") ? `#${pad(n)} 标记已解决。` : `没找到 #${close[1]}。`, "info");
+      return;
+    }
+  }
+
+  const show = a.match(/^#?(\d+)$/);
+  if (show) {
+    const txt = readDoc(type, parseInt(show[1], 10));
+    ctx.ui.notify(txt ?? `没找到 #${show[1]}。`, txt ? "info" : "warning");
+    return;
+  }
+
+  const num = addDoc(type, a, "");
+  ctx.ui.notify(`已记 ${type.toLowerCase()} #${pad(num)}：${a}`, "info");
+}
+
+export function installDocTracker(pi: ExtensionAPI): any[] {
+  const _cmds: any[] = [{
+    name: "docs",
+    desc: "/docs <issue|lesson|norm> [描述|list|编号|close 编号]",
+    handler: async (args: any, ctx: any) => {
+      const raw = (typeof args === "string" ? args : "").trim();
+      const spaceIdx = raw.indexOf(" ");
+      const sub = (spaceIdx === -1 ? raw : raw.slice(0, spaceIdx)).toUpperCase() as DocType;
+      const rest = spaceIdx === -1 ? "" : raw.slice(spaceIdx + 1);
+      if (!DOC_CONFIG[sub]) {
+        ctx.ui.notify("/docs issue|lesson|norm [描述|list|编号|close 编号]", "info");
+        return;
+      }
+      handleDocCommand(sub, rest, ctx);
+    },
+  }];
+
+  if (process.env.PI_DEV) {
+    pi.registerTool({
+      name: "devdoc",
+      label: "DevDoc",
+      messageDescription: "记录开发文档（ISSUE/LESSON/NORM）到 Docs/Dev/ 目录。自动编号 + 自动索引。",
+      promptSnippet: "Log a dev document (issue/lesson/norm) — auto-numbered, auto-indexed",
+      parameters: {
+        type: "object" as any,
+        properties: {
+          doctype: { type: "string", messageDescription: "文档类型: ISSUE | LESSON | NORM" },
+          title: { type: "string", messageDescription: "一句话标题" },
+          detail: { type: "string", messageDescription: "详情内容" },
+        },
+        required: ["doctype", "title"],
+      },
+      async execute(_id: string, params: any) {
+        const raw = String(params?.doctype ?? "").toUpperCase().trim();
+        if (!(raw in DOC_CONFIG)) {
+          return { content: [{ type: "text", text: `未知类型 "${raw}"。可选: ${Object.keys(DOC_CONFIG).join(", ")}` }], details: {} };
+        }
+        const type = raw as DocType;
+        const num = addDoc(type, String(params?.title ?? "").trim() || "（无标题）", String(params?.detail ?? ""));
+        return {
+          content: [{ type: "text", text: `已记 ${type} #${pad(num)} → Docs/Dev/${DOC_CONFIG[type].plural}/` }],
+          details: { num, type },
+        };
+      },
+    });
+  }
+  return _cmds;
+}

package/core/god.agent.capability/hands.dev.writeissue/issue.ts.SPEC

@@ -0,0 +1,26 @@
+source: issue.ts @ c6ec459d
+
+# issue.ts — Generalized dev document writer (ISSUE/LESSON/NORM)
+
+## 职责
+管理 pi-coding-master 项目的开发文档：ISSUE（有状态，可 open/fixed）、LESSON、NORM（无状态）。
+自动编号（三位 NNN）、自动生成索引文件，提供 CLI 命令和 agent 工具两种入口。
+
+## 接口
+- `addDoc(type: DocType, title: string, detail: string): number` — 创建文档，返回编号
+- `setStatus(type: DocType, num: number, status: string): boolean` — 仅 ISSUE 可设状态
+- `listOpen(type: DocType): DocMeta[]` — 列出打开的（LESSON/NORM 返回全部）
+- `readDoc(type: DocType, num: number): string | null` — 读取文档内容
+- `installDocTracker(pi: ExtensionAPI): void` — 注册 /issue /lesson /norm 命令 + devdoc 工具
+
+## 依赖
+- `@mariozechner/pi-coding-agent` (ExtensionAPI)
+- `node:fs`, `node:path`
+- 写入目录: `PROJECT_ROOT/Docs.Dev.{Issues|Lessons|Norms}/`
+
+## 行为要点
+- 文件命名: `NNN-slug.{TYPE}.md`，slug 由 `slugify()` 生成（40 字符上限）
+- 每次 addDoc / setStatus 后自动 `regenIndex()` 重建 `{Plural}.INDEX` 索引
+- ISSUE 索引按 open/已解决 两栏分列；LESSON/NORM 索引只有一栏
+- devdoc 工具仅在 `PI_DEV=1` 时注册（开发模式）
+- DocType 是字面联合类型 `"ISSUE" | "LESSON" | "NORM"`

package/core/god.agent.capability/hands.files.changewatcher/watcher.ts

@@ -0,0 +1,44 @@
+// watcher.ts — 文件变动监控 + 自动部署 + 推送给 agent
+// 启动时对源码目录 recursive watch，有 .ts 文件变动 → auto build → deploy → 推消息
+import { watch } from "node:fs";
+import { exec } from "node:child_process";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+export function installWatcher(pi: ExtensionAPI, devRoot: string) {
+  const { existsSync } = require("node:fs");
+  if (!existsSync(devRoot)) return;
+
+  // 自动发现 device-manifest.ts 所在目录
+  const { execSync: es } = require("node:child_process");
+  let srcDir = "";
+  try {
+    srcDir = es(`find "${devRoot}" -name 'technology-manifest.ts' -not -path '*/node_modules/*' -not -path '*/individual.bio.*/*' 2>/dev/null | head -1`, { encoding: "utf8" }).trim();
+  } catch { return; }
+  if (!srcDir) return;
+  srcDir = require("node:path").dirname(srcDir);
+
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  const deploy = () => {
+    const cmd = `find "${devRoot}" -name 'technology-manifest.ts' -not -path '*/node_modules/*' -not -path '*/individual.bio.*/*' | head -1 | xargs dirname | xargs -I{} rsync -a {}/ ~/.pi/agent/extensions/device/`;
+    exec(cmd, (err, stdout, stderr) => {
+      const out = stdout + stderr;
+      if (!err) return; // silent on success
+      try {
+        pi.sendMessage({
+          messageType: "watcher-deploy",
+          content: `WARN: auto-deploy failed:\n${stderr}`,
+          isDisplayedInTUI: true,
+        }, { deliverAs: "nextTurn" });
+      } catch {}
+    });
+  };
+
+  try {
+    const w = watch(srcDir, { recursive: true }, (_event, filename) => {
+      if (!filename || !filename.endsWith(".ts")) return;
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(deploy, 2000);
+    });
+    (globalThis as any).__piWatcher = w;
+  } catch {}
+}

package/core/god.agent.capability/hands.files.changewatcher/watcher.ts.SPEC

@@ -0,0 +1,25 @@
+source: watcher.ts @ d2f81091
+
+# watcher.ts — File change auto-deploy
+
+## 职责
+对开发源码目录做 recursive watch，检测 `.ts` 文件变动后自动 rsync 部署到
+`~/.pi/agent/extensions/device/`，实现"改源码即生效"的开发体验。
+
+## 接口
+- `installWatcher(pi: ExtensionAPI, devRoot: string): void` — 启动监控
+
+## 依赖
+- `node:fs` (watch, existsSync)
+- `node:child_process` (exec, execSync)
+- `node:path`
+- `@mariozechner/pi-coding-agent` (ExtensionAPI — 用 sendMessage 报错)
+
+## 行为要点
+- 通过 `find` 定位 `technology-manifest.ts` 所在目录作为监控根
+- 排除 `node_modules/` 和 `individual.bio.*/` 路径
+- 2 秒防抖: 连续变动只触发一次部署（clearTimeout + setTimeout 2000ms）
+- 部署方式: rsync -a 到 `~/.pi/agent/extensions/device/`
+- 成功时静默，失败时通过 `pi.sendMessage` 推送 watcher-deploy 告警
+- watcher 实例存在 `globalThis.__piWatcher` 上（便于外部引用/清理）
+- devRoot 不存在或找不到 manifest 时直接 return，不报错

package/core/god.pi.mod/cli/pi-completion.zsh

@@ -0,0 +1,21 @@
+# pi 命令 zsh 补全。安装位置:~/.pi/agent/pi-completion.zsh(由 install.sh 部署)。
+# 在 ~/.zshrc 里:  source "$HOME/.pi/agent/pi-completion.zsh"
+# 需要 compinit 已初始化(zsh 默认 autoload -Uz compinit; compinit)。
+_pi_comp() {
+  local plist="$HOME/.pi/memory/plist.json"
+  [[ ! -f "$plist" ]] && return
+  local IFS=$'\n'
+  local -a active archived flags
+  # 在列表里的人(pi <名字> 进入)= 非归档；已归档的人(--unarchive 恢复用)
+  active=($(node -e "try{JSON.parse(require('fs').readFileSync('$plist','utf8')).filter(p=>!p.archived).forEach(p=>console.log(p.name))}catch(e){}" 2>/dev/null))
+  archived=($(node -e "try{JSON.parse(require('fs').readFileSync('$plist','utf8')).filter(p=>p.archived).forEach(p=>console.log(p.name))}catch(e){}" 2>/dev/null))
+  flags=(--sc --archive --unarchive --archived)
+  # 按上一个词决定补什么:--unarchive 补已归档；--archive/--sc 补在列表里的人；否则补 人 + flags。
+  case "${words[CURRENT-1]}" in
+    --unarchive) compadd -a archived ;;
+    --archive|--sc) compadd -a active ;;
+    --archived) ;;  # 它不带参数
+    *) compadd -a active; compadd -a flags ;;
+  esac
+}
+compdef _pi_comp pi

package/core/god.pi.mod/cli/pi-completion.zsh.CHANGELOG

@@ -0,0 +1 @@
+[2026-06-12 16:15:23] edited (auto-logged, no messageDescription)