principles-disciple 1.126.0 → 1.128.0

package/AGENT_INSTALL_EN.md

@@ -1,173 +0,0 @@
-# Principles Disciple - Agent Installation Guide
-
-> **Installation Guide for AI Agents** - Read carefully and follow the steps
-
----
-
-## 🚨 High-Risk Files Warning
-
-**The following files contain user-accumulated data and must NEVER be deleted or overwritten:**
-
-### User Accumulated Files (Highest Priority)
-
-| File | Content | Risk |
-|------|---------|------|
-| `.principles/PRINCIPLES.md` | User's accumulated principles and lessons | 🔴 **Delete = Lose all experience** |
-| `.principles/PROFILE.json` | User configuration and preferences | 🔴 Delete = Reset all settings |
-| `AGENTS.md` | Agent identity and memory | 🔴 Delete = Lose identity cognition |
-| `SOUL.md` | Agent core personality | 🔴 Delete = Lose personality |
-| `USER.md` | User preferences and context | 🟡 Delete = Lose user preferences |
-| `PLAN.md` | Current work plan | 🟡 Delete = Lose work context |
-| `MEMORY.md` | Long-term memory | 🔴 Delete = Lose long-term memory |
-
-### State Files (Do Not Delete)
-
-| Directory | Content | Risk |
-|-----------|---------|------|
-| `.state/` | Runtime state, trust score, evolution points | 🔴 Delete = Reset all progress |
-| `.state/evolution_points.json` | Evolution points record | 🔴 Delete = Points reset to zero |
-| `.state/AGENT_SCORECARD.json` | Trust score record | 🔴 Delete = Trust score reset |
-
-### Files Safe to Update/Overwrite
-
-| File | Description |
-|------|-------------|
-| `BOOT.md` | Boot template, can be updated |
-| `HEARTBEAT.md` | Heartbeat template, can be updated |
-| `IDENTITY.md` | Identity template, can be updated |
-| `.principles/THINKING_OS.md` | Thinking models, merge new models after update |
-| `.principles/models/*.md` | Thinking model library, can add new models |
-
-### Safe Operation Principles
-
-```
-1. When updating: Always use smart mode (default), generates .update files
-2. Before deleting: Confirm file is not a user accumulated file
-3. Before overwriting: Backup original file first
-4. When merging: Preserve all user customizations
-```
-
----
-
-## Quick Check: First Install vs Update
-
-```
-Check if ~/clawd/.principles/PRINCIPLES.md exists:
-├── Does not exist → First Install (skip to [First Install] section)
-└── Exists → Update (skip to [Update] section)
-```
-
----
-
-## First Install
-
-### Step 1: Run Installation Command
-
-```bash
-npx create-principles-disciple --non-interactive --lang en --workspace ~/clawd
-```
-
-### Step 2: Restart OpenClaw Gateway
-
-```bash
-openclaw gateway --force
-```
-
-### Step 3: Verify Installation
-
-```bash
-openclaw plugins list | grep -A 2 "Principles"
-```
-
-You should see `Principles` showing as `loaded`.
-
-### Step 4: Initialize Project
-
-Run in your project directory:
-
-```
-/init-strategy
-```
-
----
-
-## Update
-
-### ⚠️ Important Notice
-
-**Updates generate .update files, they will NOT directly overwrite your files!**
-
-### Step 1: Run Update Command
-
-```bash
-npx create-principles-disciple --non-interactive --lang en --workspace ~/clawd
-```
-
-### Step 2: Check Update Content
-
-```bash
-# View changelog
-cat ~/clawd/docs/CHANGELOG.md | head -100
-
-# List all .update files
-find ~/clawd -name "*.update" -type f
-```
-
-### Step 3: Merge Updates
-
-**You must manually merge .update files into original files!**
-
-```
-For each .update file:
-1. Read original file content
-2. Read .update file content
-3. Compare differences, merge valuable updates into original file
-4. Delete .update file
-```
-
-Example workflow:
-```
-1. Found AGENTS.md.update
-2. diff AGENTS.md AGENTS.md.update
-3. Identify new sections or modifications
-4. Merge needed updates into AGENTS.md
-5. rm AGENTS.md.update
-```
-
-### Step 4: Restart OpenClaw Gateway
-
-```bash
-openclaw gateway --force
-```
-
----
-
-## FAQ
-
-### Q: Error "Cannot find module 'micromatch'"
-
-Install dependencies manually:
-```bash
-cd ~/.openclaw/extensions/principles-disciple
-npm install micromatch@^4.0.8 @sinclair/typebox@^0.34.48
-```
-
-### Q: How to check current version?
-
-```bash
-cat ~/.openclaw/extensions/principles-disciple/package.json | grep version
-```
-
-### Q: How to view all updates?
-
-```bash
-cat ~/clawd/docs/CHANGELOG.md
-```
-
----
-
-## Version Info
-
-Current document version: 1.6.0
-
-Update this version number when updating this document.

package/CHANGELOG.md

@@ -1,26 +0,0 @@
-# principles-disciple
-
-## 1.10.0
-
-### Minor Changes
-
-- 650ae5a: ## v1.9.1: WebUI Data Source Fixes
-
-  ### Phase 16-20 Complete
-
-  - **Phase 16**: Data Source Tracing - mapped all 4 WebUI pages to API endpoints
-  - **Phase 17**: Overview Page Fix - fixed `/api/central/overview`, `/api/overview`, `/api/overview/health`
-  - **Phase 18**: Loop/Samples + Feedback Fix - fixed `/api/samples`, `/api/feedback/*` data sources
-  - **Phase 19**: Gate Monitor Frontend - fixed `/api/gate/stats`, `/api/gate/blocks` types
-  - **Phase 20**: E2E Validation - 19 regression tests added for all API endpoints
-
-  ### Bug Fixes
-
-  - Fixed `evolution-worker.ts` missing `runtimeAdapter` parameter
-  - Fixed `nocturnal-train.ts` mode field type annotation
-  - Fixed `sync-version.sh` to include `create-principles-disciple` package
-
-  ### Infrastructure
-
-  - Added `@changesets/cli` for monorepo version management
-  - Added `data-endpoints-regression.test.ts` with 19 tests

package/INSTALL.md

@@ -1,254 +0,0 @@
-# Installation Guide
-
-## ⚠️ Known Issue: Plugin Dependencies
-
-### Problem
-
-When installing the plugin from source, you may encounter errors like:
-
-```bash
-Error: Cannot find module 'micromatch'
-Error: Cannot find module '@sinclair/typebox'
-```
-
-**Root Cause**: The plugin depends on external npm packages that are not automatically installed when using `openclaw plugins install` with a local path.
-
----
-
-## ✅ Solution
-
-### Option 1: Automated Installation Script (Recommended)
-
-Run the provided installation script:
-
-```bash
-cd /path/to/principles
-./packages/openclaw-plugin/scripts/install.sh
-```
-
-This script will:
-1. ✅ Build the plugin
-2. ✅ Install all dependencies
-3. ✅ Copy files to the correct location
-4. ✅ Verify installation
-
----
-
-### Option 2: Manual Installation
-
-If the script doesn't work, follow these steps:
-
-#### Step 1: Build the plugin
-
-```bash
-cd /path/to/principles/packages/openclaw-plugin
-npm install
-npm run build
-```
-
-#### Step 2: Install plugin dependencies
-
-```bash
-# Create the plugin directory
-mkdir -p ~/.openclaw/extensions/principles-disciple
-
-# Install dependencies in the plugin directory
-cd ~/.openclaw/extensions/principles-disciple
-npm install micromatch@^4.0.8 @sinclair/typebox@^0.34.48
-```
-
-#### Step 3: Copy plugin files
-
-```bash
-# Copy built files
-cp -r /path/to/principles/packages/openclaw-plugin/dist/* \
-    ~/.openclaw/extensions/principles-disciple/
-
-# Copy plugin metadata
-cp /path/to/principles/packages/openclaw-plugin/openclaw.plugin.json \
-    ~/.openclaw/extensions/principles-disciple/
-```
-
-#### Step 4: Verify installation
-
-```bash
-openclaw plugins list | grep -A 2 "Principles"
-```
-
-You should see:
-```
-│ Principles   │ principl │ loaded   │ ...
-```
-
----
-
-### Option 3: Install from npm (Future)
-
-In future releases, the plugin will be published to npm:
-
-```bash
-npm install -g @openclaw/principles-disciple
-openclaw plugins install principles-disciple
-```
-
-This will automatically handle all dependencies.
-
----
-
-## 📁 Workspace Configuration
-
-Principles Disciple needs to know where your agent's workspace directory is located. This is configured during installation.
-
-### Automatic Configuration
-
-The installer will automatically detect your OpenClaw workspace directory. You can also specify a custom directory:
-
-```bash
-# Run installer with custom workspace
-./install-openclaw.sh
-# Select "Custom directory" when prompted
-```
-
-### Manual Configuration
-
-If you skipped configuration during installation, you can set it up manually:
-
-#### Option 1: Configuration File (Recommended)
-
-Create `~/.openclaw/principles-disciple.json`:
-
-```json
-{
-  "workspace": "/path/to/your/workspace",
-  "state": "/path/to/your/workspace/.state",
-  "debug": false
-}
-```
-
-#### Option 2: Environment Variables
-
-```bash
-# Add to your shell profile (~/.bashrc, ~/.zshrc)
-export PD_WORKSPACE_DIR=/path/to/your/workspace
-export PD_STATE_DIR=/path/to/your/workspace/.state
-
-# Or set when starting OpenClaw
-PD_WORKSPACE_DIR=/path/to/your/workspace openclaw-gateway start
-```
-
-#### Option 3: Debug Mode
-
-To enable debug logging for path resolution:
-
-```bash
-export DEBUG=true
-```
-
-This will show detailed logs like:
-
-```
-[PD:PathResolver] Using workspace from config file: /home/user/workspace
-[PD:WorkspaceContext] Normalized workspaceDir: /home/user/clawd/memory -> /home/user/clawd
-```
-
-### Configuration Priority
-
-Configuration is resolved in this order (highest to lowest):
-
-1. Environment variables (`PD_WORKSPACE_DIR`, `PD_STATE_DIR`)
-2. Configuration file (`~/.openclaw/principles-disciple.json`)
-3. OpenClaw environment (`OPENCLAW_WORKSPACE`)
-4. Default (`~/.openclaw/workspace`)
-
----
-
-## 🔍 Troubleshooting
-
-### Plugin fails to load
-
-**Error**: `Cannot find module 'micromatch'`
-
-**Solution**:
-```bash
-cd ~/.openclaw/extensions/principles-disciple
-npm install micromatch@^4.0.8
-```
-
-### Plugin version mismatch
-
-**Error**: Plugin shows old version
-
-**Solution**:
-```bash
-# Remove old version
-rm -rf ~/.openclaw/extensions/principles-disciple
-
-# Reinstall
-cd /path/to/principles
-./packages/openclaw-plugin/scripts/install.sh
-```
-
-### Configuration errors
-
-**Error**: `Invalid config: plugin not found: principles-disciple`
-
-**Solution**:
-```bash
-# Reset OpenClaw config
-openclaw doctor --fix
-
-# Reinstall plugin
-./packages/openclaw-plugin/scripts/install.sh
-```
-
----
-
-## 📦 Dependencies
-
-The plugin requires the following npm packages:
-
-| Package | Version | Purpose |
-|---------|---------|---------|
-| `micromatch` | ^4.0.8 | Glob pattern matching for PLAN whitelist |
-| `@sinclair/typebox` | ^0.34.48 | Type definitions and validation |
-
-These are **not** included in the plugin bundle to keep the distribution size small. They must be installed separately in the plugin directory.
-
----
-
-## 🚀 Quick Start
-
-After installation, enable the PLAN whitelist feature:
-
-1. Edit your workspace's `docs/PROFILE.json`:
-
-```json
-{
-  "progressive_gate": {
-    "enabled": true,
-    "plan_approvals": {
-      "enabled": true,
-      "max_lines_override": -1,
-      "allowed_patterns": ["docs/**", "skills/**"],
-      "allowed_operations": ["write", "edit"]
-    }
-  }
-}
-```
-
-2. Restart your agent session
-
-Now even Stage 1 agents can edit files when a READY plan exists!
-
----
-
-## 📞 Support
-
-If you encounter issues not covered here:
-
-1. Check the [GitHub Issues](https://github.com/csuzngjh/principles/issues)
-2. Create a new issue with:
-   - Error message
-   - OpenClaw version (`openclaw --version`)
-   - Plugin version (check in `openclaw plugins list`)
-   - Installation method used

package/SKILL.md

@@ -1,63 +0,0 @@
----
-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/esbuild.config.js

@@ -1,104 +0,0 @@
-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 {
-    // 1. Build the main bundle for OpenClaw
-    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('Main bundle created: dist/bundle.js');
-
-    // 2. Build core tools for CLI usage (bootstrap-rules, etc)
-    // We keep these separate and un-minified for easier debugging and CLI importing
-    await build({
-      entryPoints: {
-        'core/bootstrap-rules': 'src/core/bootstrap-rules.ts',
-        'core/principle-tree-ledger': 'src/core/principle-tree-ledger.ts',
-        'core/principle-training-state': 'src/core/principle-training-state.ts',
-        'core/principle-compiler/index': 'src/core/principle-compiler/index.ts',
-        'core/trajectory/index': 'src/core/trajectory.ts',
-      },
-      outdir: 'dist',
-      bundle: true,
-      platform: 'node',
-      target: 'node20',
-      format: 'esm',
-      outbase: 'src',
-      external: [
-        'openclaw',
-        '@openclaw/sdk',
-        '@openclaw/plugin-kit',
-        'better-sqlite3',
-      ],
-      sourcemap: false,
-      minify: false,
-    });
-
-    console.log('Core CLI tools built in dist/core/');
-
-    const staticFiles = ['templates', '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 build ready for distribution.');
-  } catch (error) {
-    console.error('Build failed:', error);
-    process.exit(1);
-  }
-}
-
-bundlePlugin();