create-principles-disciple 1.104.0 → 1.104.2

package/plugin/dist/templates/workspace/.principles/models/swot.md

@@ -0,0 +1,60 @@
+# SWOT 分析
+
+## 简介
+
+SWOT 分析是一种战略规划工具，用于评估事物的优势、劣势、机会和威胁。
+
+## 核心框架
+
+### Strengths（优势）
+
+内部积极因素：
+
+- 有哪些核心竞争力？
+- 拥有哪些独特资源？
+- 哪方面做得比竞争对手好？
+- 客户为什么选择我们？
+
+### Weaknesses（劣势）
+
+内部消极因素：
+
+- 哪些方面需要改进？
+- 缺乏哪些资源？
+- 哪些方面不如竞争对手？
+- 客户投诉的常见问题是什么？
+
+### Opportunities（机会）
+
+外部积极因素：
+
+- 市场有哪些未满足的需求？
+- 行业趋势对业务有何帮助？
+- 竞争对手的弱点在哪里？
+- 政策环境有何利好？
+
+### Threats（威胁）
+
+外部消极因素：
+
+- 竞争对手有哪些新动作？
+- 市场需求是否在变化？
+- 政策法规有何限制？
+- 技术变革是否带来冲击？
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否客观评估了内部优劣势？
+- [ ] 是否全面扫描了外部环境？
+- [ ] 优势是否足以抓住机会？
+- [ ] 劣势是否会加剧威胁？
+- [ ] 是否制定了应对策略？
+
+## 常见陷阱
+
+1. **主观偏见**：高估优势、低估劣势
+2. **静态分析**：忽视环境动态变化
+3. **孤立看待**：未将四要素联系起来
+4. **行动缺失**：只分析不行动

package/plugin/dist/templates/workspace/.principles/models/user_story_map.md

@@ -0,0 +1,63 @@
+# 用户故事地图
+
+## 简介
+
+用户故事地图（User Story Mapping）是一种可视化产品规划工具，用于理解用户旅程、组织需求优先级。
+
+## 核心框架
+
+### 1. 用户画像
+
+- 目标用户是谁？
+- 用户的目标是什么？
+- 用户的痛点是什么？
+- 用户的能力和限制？
+
+### 2. 用户旅程骨架
+
+从左到右排列主要活动（Backbone）：
+
+```
+发现 → 了解 → 评估 → 购买 → 使用 → 推荐
+```
+
+### 3. 故事分解
+
+在每个活动下分解具体任务：
+
+```
+发现
+├── 搜索产品
+├── 看到广告
+├── 朋友推荐
+└── 社交媒体
+
+了解
+├── 浏览产品页
+├── 查看评价
+├── 观看视频
+└── 咨询客服
+```
+
+### 4. 优先级切片
+
+- **MVP（最小可行产品）**：最底层的核心故事
+- **V1.0**：MVP + 高优先级功能
+- **V2.0**：完整产品
+
+## 分析清单
+
+使用此模型时，依次检查：
+
+- [ ] 是否识别了所有用户角色？
+- [ ] 是否完整映射了用户旅程？
+- [ ] 是否分解到了可执行的任务？
+- [ ] 是否确定了合理的优先级？
+- [ ] MVP 是否真正"最小可行"？
+
+## 常见陷阱
+
+1. **角色不清**：忽视不同用户群体的差异
+2. **过度细节**：分解过细，失去全局视角
+3. **优先级混乱**：凭感觉而非价值排序
+4. **忽视反馈**：不根据用户反馈迭代

package/plugin/dist/templates/workspace/.state/WORKBOARD.json

@@ -0,0 +1,4 @@
+{
+  "updated_at": "",
+  "events": []
+}

package/plugin/dist/templates/workspace/AUDIT.md

@@ -0,0 +1,15 @@
+# AUDIT
+RESULT: PENDING
+UPDATED: 
+
+## Axiom Test
+-
+
+## System Test
+-
+
+## Via Negativa
+-
+
+## Must Fix
+-

package/plugin/dist/templates/workspace/okr/CURRENT_FOCUS.md

@@ -0,0 +1,57 @@
+# 🎯 CURRENT_FOCUS
+
+> **版本**: v1 | **状态**: INIT | **更新**: {YYYY-MM-DD}
+
+---
+
+## 📍 状态快照
+
+| 维度 | 值 |
+|------|-----|
+| 当前阶段 | 初始化 |
+| 信任分数 | 85/100 |
+| 认知卫生 | ✅ 清爽 |
+
+---
+
+## 🔄 当前任务
+
+### P0（阻塞/紧急）
+<!-- 阻塞项，需要立即处理 -->
+- [ ] 无
+
+### P1（进行中）
+<!-- 当前正在进行的核心任务，最多 3 项 -->
+- [ ] {任务描述} ← 当前
+
+### P2（待办）
+<!-- 优先级较低的待办事项 -->
+- [ ] {任务描述}
+
+---
+
+## ➡️ 下一步
+
+<!-- 下一步行动，按优先级排序 -->
+1. {下一步行动1}
+2. {下一步行动2}
+
+---
+
+## 📎 参考
+
+| 资源 | 路径 |
+|------|------|
+| 详细计划 | `memory/tasks/{任务目录}/PLAN.md` |
+| 历史版本 | `memory/okr/.history/` |
+| 任务列表 | `memory/okr/WEEK_TASKS.json` |
+
+---
+
+<!--
+编辑指南：
+1. 版本号每次压缩时 +1
+2. 状态可选：INIT | PLANNING | EXECUTING | BLOCKED | DONE
+3. 压缩时备份到 .history/CURRENT_FOCUS.v{N}.{date}.md
+4. 目标：< 40 行，超过时压缩已完成任务到 MEMORY.md
+-->

package/plugin/dist/templates/workspace/okr/RECOVERY_PROTOCOL.md

@@ -0,0 +1,56 @@
+# 🔄 Recovery Protocol - Read After Session Restart
+
+> **永久存在文件** — 会话重启后必读，不要删除此文件。
+
+---
+
+## Step 1: Read Current State
+
+1. Read `memory/okr/WEEK_TASKS.json` → Current task list
+2. Read `memory/okr/TASK_CHANGES.jsonl` → Recent changes (last 10 lines)
+3. Read `memory/okr/WEEK_STATE.json` → Week progress
+
+## Step 2: Verify In-Progress Tasks
+
+For each `in_progress` or `done` task:
+- PR merged? → `git log --oneline | grep "Merge"`
+- Document exists? → `ls -la <path>`
+- Tests passing? → `npm test | grep "passed"`
+
+## Step 3: Resume Execution
+
+| Situation | Action |
+|-----------|--------|
+| Has pending tasks | Continue execution |
+| Task queue empty | Execute autonomous derivation (see below) |
+| OKR complete | Notify user for new direction |
+
+---
+
+## Autonomous Derivation Flow
+
+When task queue is empty:
+
+1. Read `memory/STRATEGY.md` → Project vision and strategy
+2. Read `memory/okr/CURRENT_FOCUS.md` → Current milestones
+3. Identify incomplete milestones → Derive 3-5 concrete tasks
+4. Write to `WEEK_TASKS.json`
+5. Notify user: "I have planned tasks for this week, please confirm"
+
+**Important**: Do NOT invent new goals without user confirmation. Only derive tasks from existing OKRs and strategy.
+
+---
+
+## Files to Check
+
+| File | Purpose | Update Frequency |
+|------|---------|-----------------|
+| `WEEK_TASKS.json` | Structured task list | On task changes |
+| `TASK_CHANGES.jsonl` | Append-only change log | On every change |
+| `WEEK_STATE.json` | Week progress metrics | Weekly governance |
+| `WEEK_EVENTS.jsonl` | System events | On events |
+| `CURRENT_FOCUS.md` | Human-readable summary | Weekly governance |
+
+---
+
+*Last updated: 2026-03-15*

package/plugin/dist/templates/workspace/okr/TASK_CHANGES.jsonl

@@ -0,0 +1,6 @@
+# Append-only task change log
+# Format: {"type": "add|status|remove", "taskId": "...", ...}
+# Example entries (uncomment to use):
+# {"type": "add", "taskId": "T1", "desc": "完成 PR #4", "by": "wesley", "at": "2026-03-12T09:00:00Z"}
+# {"type": "status", "taskId": "T1", "from": "pending", "to": "in_progress", "by": "agent", "at": "..."}
+# {"type": "status", "taskId": "T1", "from": "in_progress", "to": "done", "evidence": "...", "by": "agent", "at": "..."}

package/plugin/dist/templates/workspace/okr/WEEK_TASKS.json

@@ -0,0 +1,6 @@
+{
+  "week": "2026-W11",
+  "createdAt": "2026-03-15T00:00:00Z",
+  "createdBy": "wesley",
+  "tasks": []
+}

package/plugin/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "principles-disciple",
   "name": "Principles Disciple",
-  "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.74.1",
+  "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
+  "version": "1.202.1",
   "activation": {
     "onCapabilities": [
       "hook"
@@ -58,8 +58,8 @@
     }
   },
   "buildFingerprint": {
-    "gitSha": "6a8d91ab50bb",
-    "bundleMd5": "0351a5287c1f3fbf74b3988e04a2541e",
-    "builtAt": "2026-05-20T11:40:04.688Z"
+    "gitSha": "f9dc8b9f7aec",
+    "bundleMd5": "5e78aea084b9afac6f064b13f4137ebb",
+    "builtAt": "2026-07-04T22:43:12.642Z"
   }
 }

package/plugin/package.json

@@ -1,7 +1,7 @@
 {
   "name": "principles-disciple",
-  "version": "1.74.1",
-  "description": "Native OpenClaw plugin for Principles Disciple",
+  "version": "1.202.1",
+  "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,6 +26,7 @@
     "dist",
     "scripts",
     "templates",
+    "assets",
     "openclaw.plugin.json"
   ],
   "publishConfig": {
@@ -41,12 +42,23 @@
     "setupEntry": "./dist/bundle.js",
     "extensions": [
       "./dist/bundle.js"
-    ]
+    ],
+    "compat": {
+      "pluginApi": ">=2026.4.4"
+    },
+    "build": {
+      "openclawVersion": "2026.4.4"
+    },
+    "install": {
+      "minHostVersion": ">=2026.4.4"
+    }
   },
   "scripts": {
     "build": "tsc",
     "build:bundle": "node esbuild.config.js",
     "build:production": "node esbuild.config.js --production && node scripts/verify-build.mjs",
+    "build:types": "tsc --emitDeclarationOnly",
+    "prepack": "npm run build:production && npm run build:types",
     "test": "vitest run",
     "test:unit": "vitest run --config vitest.unit.config.ts tests/core tests/service tests/hooks tests/commands tests/utils tests/scripts --exclude tests/commands/evolver.test.ts",
     "test:integration": "vitest run tests/integration/",
@@ -58,20 +70,20 @@
     "sync-plugin": "node scripts/sync-plugin.mjs"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
+    "@types/better-sqlite3": "^9.6.0",
     "@types/js-yaml": "^4.0.9",
     "@types/micromatch": "^4.0.10",
-    "@types/node": "^26.0.1",
+    "@types/node": "^26.1.2",
     "@types/ws": "^8.5.13",
-    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
     "@typescript-eslint/parser": "^8.58.0",
     "@vitest/coverage-v8": "^4.1.9",
     "esbuild": "^0.28.1",
     "eslint": "^10.5.0",
-    "jsdom": "^29.1.1",
-    "typescript": "^6.0.3",
+    "jsdom": "^30.0.1",
+    "typescript": "^7.0.2",
     "vite": "^8.0.16",
-    "vitest": "^4.1.9",
+    "vitest": "^4.1.10",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
@@ -85,7 +97,7 @@
   "dependencies": {
     "@principles/core": "file:./core",
     "@sinclair/typebox": "^0.34.48",
-    "better-sqlite3": "^12.9.0",
+    "better-sqlite3": "^13.0.3",
     "commander": "^12.0.0",
     "js-yaml": "^5.2.0",
     "micromatch": "^4.0.8"

package/plugin/scripts/bootstrap-rules.mjs

@@ -58,7 +58,11 @@ async function run() {
       console.log(`  Validation: ${valid ? 'PASS' : 'FAIL'}`);
     }
   } catch (err) {
-    console.error(`\nBootstrap failed: ${err.message}`);
+    if (err && typeof err === 'object' && 'code' in err && err.code === 'NO_DETERMINISTIC_PRINCIPLES') {
+      console.log('\nNothing to bootstrap yet; the workspace has no deterministic principles.');
+      return;
+    }
+    console.error(`\nBootstrap failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
 }

package/plugin/scripts/postinstall.cjs

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+/**
+ * PRI-343: postinstall hook — auto-configure allowConversationAccess.
+ *
+ * Runs during `npm install` (i.e. `openclaw plugins install principles-disciple`).
+ * Sets plugins.entries['principles-disciple'].hooks.allowConversationAccess = true
+ * in ~/.openclaw/openclaw.json so users never need to manually run
+ * `openclaw config set ... allowConversationAccess true`.
+ *
+ * Design constraints:
+ *  - Idempotent: safe to run multiple times.
+ *  - BOM-resistant: strip U+FEFF before JSON.parse (PowerShell UTF8 writes add BOM).
+ *  - Atomic write: temp file + rename to avoid partial writes.
+ *  - File-locked: uses O_EXCL lock file to prevent races with concurrent writers.
+ *  - Never fail the install: all errors are caught and logged to stderr.
+ *  - No dependencies: pure Node.js built-ins (fs, path, os).
+ */
+'use strict';
+
+const { existsSync, readFileSync, writeFileSync, renameSync, unlinkSync, openSync, closeSync, statSync, writeSync, fsyncSync, constants } = require('fs');
+const { join } = require('path');
+const { homedir } = require('os');
+
+const PLUGIN_ID = 'principles-disciple';
+const CONFIG_PATH = join(homedir(), '.openclaw', 'openclaw.json');
+const LOCK_PATH = CONFIG_PATH + '.lock';
+const LOCK_MAX_RETRIES = 20;
+const LOCK_BASE_DELAY_MS = 25;
+
+function log(msg) {
+  process.stderr.write(`[PD:postinstall] ${msg}\n`);
+}
+
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function tryAcquireLock() {
+  try {
+    const flags = constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL;
+    const fd = openSync(LOCK_PATH, flags, 0o600);
+    try {
+      writeSync(fd, String(process.pid));
+      fsyncSync(fd);
+    } finally {
+      closeSync(fd);
+    }
+    return true;
+  } catch (err) {
+    if (err.code === 'EEXIST') return false;
+    throw err;
+  }
+}
+
+function readLockPid() {
+  try {
+    const content = readFileSync(LOCK_PATH, 'utf8');
+    const pid = parseInt(content.trim(), 10);
+    return Number.isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
+
+function cleanupStaleLock() {
+  try {
+    const stat = statSync(LOCK_PATH);
+    const pid = readLockPid();
+    const isStale = Date.now() - stat.mtimeMs > 10000;
+    const isDead = pid === null || !isProcessAlive(pid);
+    if (isStale || isDead) {
+      try {
+        unlinkSync(LOCK_PATH);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+function acquireLockSync() {
+  for (let attempt = 0; attempt < LOCK_MAX_RETRIES; attempt++) {
+    if (tryAcquireLock()) return true;
+    if (!cleanupStaleLock()) {
+      const delay = LOCK_BASE_DELAY_MS * Math.pow(2, Math.min(attempt, 5));
+      const jitter = delay * 0.2 * Math.random();
+      const waitUntil = Date.now() + delay + jitter;
+      while (Date.now() < waitUntil) { /* spin */ }
+      continue;
+    }
+    if (tryAcquireLock()) return true;
+  }
+  return false;
+}
+
+function releaseLock() {
+  try {
+    const pid = readLockPid();
+    if (pid === process.pid) {
+      unlinkSync(LOCK_PATH);
+    }
+  } catch {
+    // best effort
+  }
+}
+
+try {
+  if (!existsSync(CONFIG_PATH)) {
+    log(`No openclaw.json at ${CONFIG_PATH} — skipping (will auto-fix on first load).`);
+    process.exit(0);
+  }
+
+  const locked = acquireLockSync();
+  if (!locked) {
+    log(`Could not acquire config lock — skipping (will auto-fix on first load).`);
+    process.exit(0);
+  }
+
+  let exitCode = 0;
+  try {
+    // BOM-resistant read
+    const raw = readFileSync(CONFIG_PATH, 'utf8').replace(/^\uFEFF/, '');
+    const cfg = JSON.parse(raw);
+
+    if (!isRecord(cfg)) {
+      log(`openclaw.json is not a JSON object — skipping.`);
+    } else {
+      // Ensure plugins.entries path exists
+      if (!isRecord(cfg.plugins)) cfg.plugins = {};
+      if (!isRecord(cfg.plugins.entries)) cfg.plugins.entries = {};
+
+      const rawEntry = cfg.plugins.entries[PLUGIN_ID];
+      const entry = isRecord(rawEntry) ? rawEntry : { enabled: true };
+
+      if (!isRecord(entry.hooks)) entry.hooks = {};
+
+      if (entry.hooks.allowConversationAccess !== true) {
+        // Set allowConversationAccess = true
+        entry.hooks.allowConversationAccess = true;
+        cfg.plugins.entries[PLUGIN_ID] = entry;
+
+        // Atomic write: temp file + rename
+        const tmpPath = CONFIG_PATH + '.tmp.' + Date.now();
+        writeFileSync(tmpPath, JSON.stringify(cfg, null, 2), 'utf8');
+        renameSync(tmpPath, CONFIG_PATH);
+
+        log(`allowConversationAccess auto-configured to true in ${CONFIG_PATH}`);
+      }
+    }
+  } catch (innerErr) {
+    log(`Auto-configuration failed: ${innerErr instanceof Error ? innerErr.message : String(innerErr)}`);
+    log(`The plugin will retry on first load. If it still fails, run:`);
+    log(`  openclaw config set plugins.entries.principles-disciple.hooks.allowConversationAccess true`);
+  } finally {
+    releaseLock();
+  }
+  process.exit(exitCode);
+} catch (err) {
+  // Never fail the install — the plugin's module-level auto-fix will retry on load.
+  log(`Auto-configuration failed: ${err instanceof Error ? err.message : String(err)}`);
+  log(`The plugin will retry on first load. If it still fails, run:`);
+  log(`  openclaw config set plugins.entries.principles-disciple.hooks.allowConversationAccess true`);
+  process.exit(0);
+}

package/plugin/scripts/sync-plugin.mjs

@@ -925,7 +925,16 @@ function injectLocalWorkspacePackages() {
 function installTargetDependencies() {
     console.log('\n📦 Installing production dependencies in target...');
     try {
-        execSync('npm install --omit=dev --no-audit --no-fund --prefer-offline', {
+        // --legacy-peer-deps: the plugin's devDependencies include @typescript-eslint
+        // (peer typescript <6.1) which npm 7+ strictly validates even under --omit=dev,
+        // causing ETARGET. Since production install omits devDeps anyway, legacy peer
+        // resolution is safe and only bypasses the over-strict peer check.
+        //
+        // --prefer-offline removed: it caused ETARGET for better-sqlite3@^13.0.1 when
+        // the local npm cache was stale (registry had 13.0.3 but cache only had an
+        // older resolution). Letting npm use its default offline/online heuristic
+        // avoids the stale-cache hard failure.
+        execSync('npm install --omit=dev --no-audit --no-fund --legacy-peer-deps', {
             cwd: INSTALL_DIR,
             stdio: 'inherit'
         });
@@ -1400,6 +1409,7 @@ function main() {
     if (args.restart) {
         const restarted = restartGateway();
         if (!restarted) {
+            process.exitCode = 1;
             console.warn('\n⚠️  Plugin files installed but gateway restart was not confirmed.');
             console.warn('   The gateway may already be running. Verify with:');
             console.warn('     PowerShell: openclaw gateway status');
@@ -1411,6 +1421,7 @@ function main() {
             console.warn('     Then: openclaw gateway start');
             console.warn('');
             console.warn('   Or simply restart from PowerShell (not affected by the cygpath bug).');
+            console.error('\nINSTALLATION INCOMPLETE: plugin files were copied, but the running product was not verified.');
         }
     } else {
         console.log('\n💡 Restart OpenClaw Gateway to load the new version.');