principles-disciple 1.8.1 → 1.8.3

package/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: principles-disciple
+description: Evolutionary programming agent framework with control-plane observability, pain-driven learning, and guarded execution.
+version: 1.7.0
+author: Principles Disciple Team
+tags: [core, safety, evolution, control-plane]
+---
+
+# Principles Disciple
+
+An evolutionary agent framework built around pain signals, guarded execution, and a separable control plane.
+
+## Current Model
+
+- `Pain` captures failure and frustration signals
+- `GFI` is the short-term friction brake
+- `Gate` is the execution intercept layer
+- `Evolution` is the learning plane with EP (Evolution Points) as the sole gating mechanism
+- `EP Tier` determines agent capabilities (Seed → Sprout → Sapling → Tree → Forest)
+
+## Key Commands
+
+| Command | Description |
+|---|---|
+| `/pd-evolution-status` | Show the current control-plane and evolution summary |
+| `/pd-evolve` | Run an evolution task |
+| `/pd-rollback` | Roll back the latest or specified empathy penalty |
+| `/pd-help` | Show help |
+
+## `/pd-evolution-status` Example
+
+```text
+Evolution Status
+================
+
+Control Plane
+- EP Tier: Sapling (200 points)
+- Session GFI: current 18, peak 25 (partial)
+- GFI Sources: user_empathy(18)
+- Pain Flag: inactive
+- Last Pain Signal: user_empathy - buffered empathy event
+- Gate Events: blocks 1, bypasses 0 (authoritative)
+
+Evolution
+- Queue: pending 1, in_progress 0, completed 0 (authoritative)
+- Directive: present, active yes, age 5m
+- Directive Task: fix something important
+```
+
+## Important Behavior Notes
+
+- `/pd-rollback` now removes only the `user_empathy` GFI slice; it does not wipe the full session GFI.
+
+## Usage
+
+Use Principles Disciple to:
+
+- observe runtime control-plane state
+- capture pain signals and empathy signals
+- guard risky actions through Gate
+- feed lessons into the evolution pipeline without turning evolution into a second authority system
+
+This skill is designed to support the current observation window before any `Capability shadow` rollout.

package/docs/COMMAND_REFERENCE.md

@@ -0,0 +1,76 @@
+# Principles Disciple Command Reference
+
+> 当前版本重点：EP (Evolution Points) 系统已接替 trust score 成为唯一门控机制。  
+> `rollback` 只回滚 `user_empathy` slice，`/pd-evolution-status` 读的是运行时 summary。
+
+---
+
+## 核心命令
+
+| 命令 | 用途 | 当前口径 |
+|---|---|---|
+| `/pd-evolution-status` | 查看控制面与进化面的当前状态 | 读取 `RuntimeSummaryService` 的 canonical state |
+| `/pd-status empathy` | 查看情绪/共情事件统计 | 用于观察 `user_empathy` 与 `system_infer` 事件是否稳定落日志 |
+| `/pd-rollback last` | 回滚最近一次情绪惩罚 | 只回滚 `user_empathy` 对应的 GFI slice |
+| `/pd-evolve` | 执行进化任务 | 属于学习面，通过 EP 积累提升权限 |
+| `/pd-help` | 显示帮助 | |
+
+---
+
+## `/pd-evolution-status`
+
+### 它现在显示什么
+
+- `EP Tier`: 当前 EP 等级 (Seed → Sprout → Sapling → Tree → Forest)
+- `Session GFI`: 当前会话 GFI 与峰值
+- `GFI Sources`: 当前 summary 能解释出来的 friction 来源
+- `Pain Flag`: pain flag 是否激活
+- `Gate Events`: 最近的 block / bypass
+- `Queue / Directive`: evolution queue 与 directive 的当前状态
+
+### 重要说明
+
+- 这是当前控制面的权威读模型入口。
+- 它优先读取 canonical `.state`，并尽量合并 live session / buffered events。
+- 如果数据不完整，会显示 `partial` 或 warning，而不是静默显示 `0`。
+
+---
+
+## `/pd-rollback`
+
+### 当前行为
+
+- `/pd-rollback last`
+- `/pd-rollback <event-id>`
+
+回滚的是最近一次或指定的 `user_empathy` 事件。
+
+### 重要变化
+
+- 现在只回滚 `user_empathy` 对应的 GFI slice
+- 不再把整段 session GFI 一起清空
+- 如果事件不存在或来源不匹配，不会误伤其他 friction
+
+---
+
+## EP 等级说明
+
+| 等级 | EP 要求 | 权限 |
+|---|---|---|
+| Seed | 0 | 只读 + 基础文档 |
+| Sprout | 50 | 单文件编辑 |
+| Sapling | 200 | 多文件 + 测试 + 子智能体 |
+| Tree | 500 | 重构 + 风险路径 |
+| Forest | 1000 | 无限制 |
+
+---
+
+## 观察窗口建议
+
+在进入 `Phase 3 capability shadow` 之前，优先每天检查：
+
+1. `user_empathy` / `system_infer` 是否稳定进入 `events.jsonl`
+2. rollback 是否只影响 empathy slice
+3. `evolution_queue.json`、`evolution_directive.json` 与 status 是否一致
+4. summary 是否仍然需要 `partial` 警告才能解释当前状态
+5. EP 积累是否正常驱动等级提升

package/docs/COMMAND_REFERENCE_EN.md

@@ -0,0 +1,79 @@
+# Principles Disciple Command Reference (English)
+
+> Current state: EP (Evolution Points) system is the primary growth system, fully operational and enabled by default.
+
+---
+
+## Core Commands
+
+| Command | Purpose |
+|---|---|
+| `/pd-evolution-status` | View EP tier, GFI, pain flag, and gate events |
+| `/pd-status empathy` | Inspect empathy/frustration event statistics |
+| `/pd-rollback last` | Roll back the latest empathy penalty |
+| `/pd-evolve` | Run an evolution task |
+| `/pd-evolution-points` | View current EP balance and tier |
+
+---
+
+## `/pd-evolution-status`
+
+### What it shows
+
+- `EP Tier`: Current evolution tier (Seed → Sprout → Sapling → Tree → Forest)
+- `Session GFI`: Current session GFI and peak
+- `GFI Sources`: Currently attributable friction sources
+- `Pain Flag`: Whether a pain flag is active
+- `Gate Events`: Recent block / bypass counts
+- `Queue / Directive`: Evolution queue and directive state
+
+### Important notes
+
+- This is the main operator entry point into the control plane.
+- It reads canonical `.state` and tries to merge live session state and buffered events when available.
+- When data is incomplete, it surfaces `partial` or warnings instead of silently printing `0`.
+
+---
+
+## `/pd-rollback`
+
+### Current behavior
+
+- `/pd-rollback last`
+- `/pd-rollback <event-id>`
+
+It rolls back the latest or specified `user_empathy` event.
+
+### Important notes
+
+- It subtracts only the `user_empathy` GFI slice
+- It no longer wipes the whole session GFI
+- If the event is missing or the source does not match, unrelated friction remains untouched
+
+---
+
+## EP Tier System
+
+| Tier | EP Required | Max Lines/Write |
+|------|-------------|-----------------|
+| Seed | 0 | 150 |
+| Sprout | 50 | 300 |
+| Sapling | 200 | 500 |
+| Tree | 500 | 1000 |
+| Forest | 1000 | Unlimited |
+
+EP is earned through successful task completion and problem resolution.
+
+---
+
+## Observation Window Checklist
+
+Before entering new capability phases, check daily:
+
+1. EP tier and queue are functioning correctly
+2. `user_empathy` and `system_infer` appear in `events.jsonl`
+3. rollback affects only the empathy slice
+4. `evolution_queue.json`, `evolution_directive.json`, and status stay aligned
+5. summary warnings still accurately explain partial data quality
+
+(End of file - total 84 lines)

package/esbuild.config.js

@@ -0,0 +1,75 @@
+import { build } from 'esbuild';
+import { copyFileSync, mkdirSync, existsSync, statSync, readdirSync, rmSync } from 'fs';
+import { join } from 'path';
+
+const isProduction = process.argv.includes('--production');
+
+// Clean dist/ before build to prevent tsc artifacts from coexisting with bundle
+if (existsSync('dist')) {
+  console.log('🧹 Cleaning dist/...');
+  rmSync('dist', { recursive: true, force: true });
+}
+
+function copyRecursive(src, dest) {
+  const stats = statSync(src);
+  if (stats.isDirectory()) {
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+      copyRecursive(join(src, entry), join(dest, entry));
+    }
+    return;
+  }
+
+  copyFileSync(src, dest);
+}
+
+async function bundlePlugin() {
+  try {
+    await build({
+      entryPoints: ['src/index.ts'],
+      outfile: 'dist/bundle.js',
+      bundle: true,
+      platform: 'node',
+      target: 'node20',
+      format: 'esm',
+      external: [
+        'openclaw',
+        '@openclaw/sdk',
+        '@openclaw/plugin-kit',
+        'better-sqlite3',
+      ],
+      sourcemap: isProduction ? false : 'inline',
+      minify: isProduction ? true : false,
+      treeShaking: true,
+      metafile: true,
+    });
+
+    console.log('Bundle created: dist/bundle.js');
+
+    const staticFiles = ['templates', 'agents', 'openclaw.plugin.json'];
+    const distDir = 'dist';
+
+    for (const file of staticFiles) {
+      const src = file;
+      const dest = join(distDir, file);
+      if (!existsSync(src)) {
+        continue;
+      }
+
+      if (statSync(src).isDirectory()) {
+        copyRecursive(src, dest);
+      } else {
+        copyFileSync(src, dest);
+      }
+
+      console.log(`Copied: ${file} -> dist/${file}`);
+    }
+
+    console.log('\nPlugin bundle ready for distribution.');
+  } catch (error) {
+    console.error('Bundle failed:', error);
+    process.exit(1);
+  }
+}
+
+bundlePlugin();

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "skills": [
     "./skills"
   ],
@@ -76,8 +76,8 @@
     }
   },
   "buildFingerprint": {
-    "gitSha": "4e632d4c5c2c",
-    "bundleMd5": "ed0922a01d46d55a49cd96f8feb158a9",
-    "builtAt": "2026-03-31T03:48:08.676Z"
+    "gitSha": "c159a298aac0",
+    "bundleMd5": "e54bd6b71182252dd335aa016c9caa0e",
+    "builtAt": "2026-04-06T05:28:57.508Z"
   }
 }

package/package.json

@@ -1,18 +1,11 @@
 {
   "name": "principles-disciple",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "templates",
-    "agents",
-    "openclaw.plugin.json"
-  ],
+  "main": "./dist/bundle.js",
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/bundle.js"
   },
   "repository": {
     "type": "git",
@@ -29,15 +22,17 @@
     "id": "principles-disciple",
     "name": "Principles Disciple",
     "extensions": [
-      "./dist/index.js"
+      "./dist/bundle.js"
     ]
   },
   "scripts": {
     "build": "tsc",
     "build:web": "node scripts/build-web.mjs",
     "build:bundle": "node esbuild.config.js && node scripts/build-web.mjs",
-    "build:production": "tsc && node esbuild.config.js --production && node scripts/build-web.mjs --production && node scripts/verify-build.mjs",
+    "build:production": "node esbuild.config.js --production && node scripts/build-web.mjs --production && node scripts/verify-build.mjs",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
     "postinstall": "node scripts/install-dependencies.cjs"
   },
   "devDependencies": {
@@ -48,15 +43,18 @@
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@types/ws": "^8.5.13",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
     "@vitest/coverage-v8": "^4.1.0",
     "esbuild": "^0.27.4",
+    "eslint": "^10.1.0",
     "jsdom": "^29.0.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.0",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "openclaw": ">=1.0.0"
+    "openclaw": ">=2026.4.4"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/scripts/build-web.mjs

@@ -0,0 +1,46 @@
+import { build } from "esbuild";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const isProduction = process.argv.includes("--production");
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const outDir = path.join(rootDir, "dist", "web");
+const assetsDir = path.join(outDir, "assets");
+
+mkdirSync(assetsDir, { recursive: true });
+
+await build({
+  entryPoints: [path.join(rootDir, "ui", "src", "main.tsx")],
+  bundle: true,
+  format: "esm",
+  platform: "browser",
+  target: ["es2022"],
+  outfile: path.join(assetsDir, "app.js"),
+  sourcemap: isProduction ? false : "inline",
+  minify: isProduction,
+  jsx: "automatic",
+  loader: {
+    ".css": "css",
+  },
+  define: {
+    "process.env.NODE_ENV": JSON.stringify(isProduction ? "production" : "development"),
+  },
+});
+
+const html = `<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Principles Console</title>
+    <link rel="stylesheet" href="/plugins/principles/assets/app.css" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/plugins/principles/assets/app.js"></script>
+  </body>
+</html>
+`;
+
+writeFileSync(path.join(outDir, "index.html"), html, "utf8");

package/scripts/install-dependencies.cjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process');
+const { existsSync, readFileSync } = require('fs');
+const { join } = require('path');
+
+const PLUGIN_DIR = join(__dirname, '..');
+
+console.log('Setting up Principles Disciple plugin dependencies...');
+
+const packageJsonPath = join(PLUGIN_DIR, 'package.json');
+if (!existsSync(packageJsonPath)) {
+  console.log('Not in plugin directory, skipping dependency setup');
+  process.exit(0);
+}
+
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+const dependencyNames = ['micromatch', '@sinclair/typebox', 'better-sqlite3'];
+const DEPENDENCIES = dependencyNames.map((name) => {
+  const version = packageJson.dependencies?.[name] || packageJson.devDependencies?.[name];
+  if (!version) {
+    throw new Error(`Missing dependency version in package.json for ${name}`);
+  }
+  return `${name}@${version}`;
+});
+
+const nodeModulesDir = join(PLUGIN_DIR, 'node_modules');
+const betterSqliteDir = join(nodeModulesDir, 'better-sqlite3');
+if (existsSync(nodeModulesDir) && existsSync(betterSqliteDir)) {
+  console.log('Dependencies already installed');
+  process.exit(0);
+}
+
+console.log('Installing plugin dependencies...');
+try {
+  execFileSync('npm', ['install', ...DEPENDENCIES], {
+    cwd: PLUGIN_DIR,
+    stdio: 'inherit',
+  });
+  console.log('Plugin dependencies installed successfully');
+} catch (error) {
+  console.error('Failed to install plugin dependencies:', error.message);
+  console.log('\nManual fix:');
+  console.log('  cd', PLUGIN_DIR);
+  console.log('  npm install', DEPENDENCIES.join(' '));
+  process.exit(1);
+}