create-principles-disciple 1.73.0 → 1.75.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Principles Disciple Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Principles Disciple Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -94,6 +94,30 @@ If an update fails, the installer automatically restores the previous working in
 
 If the installer cannot restore the backup (rare), re-run the installer with `--force`.
 
+## Updating
+
+PD supports updating through the Web UI:
+
+1. Open PD Console (http://localhost:3100)
+2. Navigate to Settings → Update
+3. Check for updates and review version info
+4. Click "Update Now" to apply
+
+### Update Options
+
+- **Merge Strategy**: How to handle workspace file changes
+  - `smart`: Generate .update files for manual merge
+  - `overwrite`: Force overwrite workspace files
+  - `keep`: Keep existing workspace files unchanged
+- **Backup**: Create backup before update (recommended for rollback support)
+
+### API Endpoints
+
+- `GET /api/update/check` — Check for available updates
+- `POST /api/update/apply` — Apply an update
+- `GET /api/update/status` — Get current update status
+- `POST /api/update/rollback` — Rollback to previous version
+
 ## Commands
 
 - `install` — Install PD (default command)

package/console/dist/server/index.js

@@ -20,6 +20,8 @@ import { handlePrinciplesRoute, disposePrinciplesModels } from './routes/princip
 import { createWorkspacesRoutes } from './routes/workspaces.js';
 import { createCentralRoutes } from './routes/central.js';
 import { handleAgentsRoute, disposeAgentModels } from './routes/agents.js';
+import { handleUpdateRoute } from './routes/update.js';
+import { handleUpdateHistoryRoute } from './routes/update-history.js';
 import { handleStateRoute } from './routes/state.js';
 import { sendJson, sendSuccess, sendError, sendNotFound, sendUnauthorized } from './utils/response.js';
 import { parseDiagnosticianOutput, parseDiagnosticInput, parseSeverityFromDiagnostic, parseReasonSummaryFromDiagnostic, parseRecommendationKind } from './utils/diagnostic-parser.js';
@@ -344,6 +346,17 @@ function handleRequest(services) {
                 asyncHandler(() => handleAgentsRoute(req, res, services.workspaceDir, subPath))(req, res);
                 return;
             }
+            // GET /api/update/history (MUST be before update catch-all)
+            if (urlPath === '/api/update/history') {
+                asyncHandler(() => handleUpdateHistoryRoute(req, res, services.workspaceDir, ''))(req, res);
+                return;
+            }
+            // Update routes: GET /api/update/check, POST /api/update/apply, GET /api/update/status, POST /api/update/rollback
+            if (urlPath === '/api/update' || urlPath.startsWith('/api/update/')) {
+                const subPath = urlPath.slice('/api/update'.length);
+                asyncHandler(() => handleUpdateRoute(req, res, services.workspaceDir, subPath))(req, res);
+                return;
+            }
             // GET /api/v1/state, /api/v1/state/:taskId
             if (urlPath === '/api/v1/state' || urlPath.startsWith('/api/v1/state/')) {
                 const subPath = urlPath.slice('/api/v1/state'.length);
@@ -448,7 +461,6 @@ function handleRequest(services) {
                             principle_candidate_intake: '原则候选录入',
                             dreamer: '深度反思',
                             keyword_optimization: '关键词优化',
-                            sleep_reflection: '夜间反思',
                         };
                         return {
                             id: t.taskId,

package/console/dist/server/routes/agents.js

@@ -15,7 +15,7 @@ const AGENT_REGISTRY = [
         taskKind: null,
         prompt: 'N/A - Heartbeat-driven scheduler, no LLM prompt',
         tools: ['processCompilationBackfill', 'processEvolutionQueue', 'processDetectionQueue', 'sweepExpiredWorkflows', 'runWorkflowWatchdog'],
-        subAgents: ['nocturnal-reflection', 'correction-observer'],
+        subAgents: ['correction-observer'],
     },
     {
         id: 'diagnostician',
@@ -30,58 +30,6 @@ const AGENT_REGISTRY = [
         tools: ['PainSignalBridge', 'DiagnosticianRunner', 'SqliteContextAssembler'],
         subAgents: [],
     },
-    {
-        id: 'nocturnal-reflection',
-        name: 'Nocturnal Reflection',
-        nameZh: '夜间反思',
-        description: 'Deep reflection pipeline that runs Trinity (Dreamer→Philosopher→Scribe) to generate high-quality decision alternatives',
-        descriptionZh: '深度反思管线，运行 Trinity（梦想家→哲学家→书记员）生成高质量决策替代方案',
-        icon: 'Moon',
-        category: 'reflector',
-        taskKind: 'sleep_reflection',
-        prompt: 'Nocturnal Dreamer — Candidate Generation\nNocturnal Philosopher — 6D Scoring & Risk Ranking\nNocturnal Scribe — Tournament Selection & Comparative Analysis',
-        tools: ['NocturnalTargetSelector', 'NocturnalTrajectoryExtractor', 'TrinityRunner', 'NocturnalArbiter', 'NocturnalExecutability', 'NocturnalArtificer'],
-        subAgents: ['trinity-dreamer', 'trinity-philosopher', 'trinity-scribe'],
-    },
-    {
-        id: 'trinity-dreamer',
-        name: 'Trinity Dreamer',
-        nameZh: 'Trinity 梦想家',
-        description: 'Generates 2-3 candidate correction alternatives from session trajectory analysis',
-        descriptionZh: '从会话轨迹分析中生成 2-3 个候选纠正方案',
-        icon: 'Sparkles',
-        category: 'sub-process',
-        taskKind: null,
-        prompt: 'You are a principles analyst specializing in identifying decision alternatives.\nYour task is to analyze a session trajectory and generate 2-3 candidate corrections.\nOutput: {"valid": true, "candidates": [...]}',
-        tools: ['runEmbeddedPiAgent'],
-        subAgents: [],
-    },
-    {
-        id: 'trinity-philosopher',
-        name: 'Trinity Philosopher',
-        nameZh: 'Trinity 哲学家',
-        description: 'Evaluates and ranks candidates using 6-dimensional scoring and risk assessment',
-        descriptionZh: '使用 6 维评分和风险评估对候选方案进行评估和排名',
-        icon: 'Scale',
-        category: 'sub-process',
-        taskKind: null,
-        prompt: 'You are a principles philosopher.\nEvaluate candidates against existing principles.\nScore each on 6 dimensions: correctness, specificity, actionability, non-redundancy, safety, generalizability.',
-        tools: ['runEmbeddedPiAgent'],
-        subAgents: [],
-    },
-    {
-        id: 'trinity-scribe',
-        name: 'Trinity Scribe',
-        nameZh: 'Trinity 书记员',
-        description: 'Performs tournament selection and produces the final structured artifact draft',
-        descriptionZh: '执行锦标赛选择，产出最终结构化 artifact 草稿',
-        icon: 'PenTool',
-        category: 'sub-process',
-        taskKind: null,
-        prompt: 'You are a principles scribe.\nPerform tournament selection among ranked candidates.\nProduce a final structured artifact with comparative analysis.',
-        tools: ['runEmbeddedPiAgent'],
-        subAgents: [],
-    },
     {
         id: 'correction-observer',
         name: 'Correction Observer',
@@ -281,66 +229,7 @@ class AgentConsoleModel {
             db?.close();
         }
     }
-    getTrinitySubAgentStatus(agentId, workflows) {
-        const stageMap = {
-            'trinity-dreamer': 'dreamer',
-            'trinity-philosopher': 'philosopher',
-            'trinity-scribe': 'scribe',
-        };
-        const stage = stageMap[agentId];
-        if (!stage)
-            return { status: 'unknown', lastRunAt: null };
-        const stageOrder = ['dreamer', 'philosopher', 'scribe'];
-        const stageIndex = stageOrder.indexOf(stage);
-        for (const wf of workflows) {
-            if (wf.workflow_type !== 'nocturnal')
-                continue;
-            const eventStates = this.getStageEvents(wf.workflow_id);
-            const stageEvent = eventStates[stage];
-            if (stageEvent === 'failed') {
-                return { status: 'failed', lastRunAt: new Date(wf.updated_at).toISOString() };
-            }
-            if (stageEvent === 'completed') {
-                return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-            }
-            for (let i = stageOrder.length - 1; i >= 0; i--) {
-                const s = stageOrder[i];
-                if (eventStates[s] === 'completed') {
-                    if (i === stageIndex)
-                        return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-                    if (i > stageIndex)
-                        return { status: 'running', lastRunAt: new Date(wf.updated_at).toISOString() };
-                    return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-                }
-                if (eventStates[s] === 'running' || eventStates[s] === 'started') {
-                    if (i === stageIndex)
-                        return { status: 'running', lastRunAt: new Date(wf.updated_at).toISOString() };
-                    if (i < stageIndex)
-                        return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-                    return { status: 'running', lastRunAt: new Date(wf.updated_at).toISOString() };
-                }
-            }
-            if (wf.state === 'active' || wf.state === 'pending') {
-                if (stageIndex === 0)
-                    return { status: 'running', lastRunAt: new Date(wf.updated_at).toISOString() };
-                return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-            }
-            if (wf.state === 'completed') {
-                return { status: 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-            }
-            if (wf.state === 'terminal_error') {
-                if (eventStates.dreamer === 'failed') {
-                    return { status: stageIndex === 0 ? 'failed' : 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-                }
-                if (eventStates.philosopher === 'failed') {
-                    return { status: stageIndex <= 1 ? (stageIndex === 1 ? 'failed' : 'idle') : 'idle', lastRunAt: new Date(wf.updated_at).toISOString() };
-                }
-                return { status: 'failed', lastRunAt: new Date(wf.updated_at).toISOString() };
-            }
-        }
-        return { status: 'unknown', lastRunAt: null };
-    }
-    async buildAgentInfo(agent, allTasks, workflows) {
+    async buildAgentInfo(agent, allTasks, _workflows) {
         let status = 'unknown';
         let lastRunAt = null;
         let lastStatus = null;
@@ -350,7 +239,7 @@ class AgentConsoleModel {
         if (agent.id === 'evolution-worker') {
             const workerStatus = this.getEvolutionWorkerStatus();
             ({ status, lastRunAt } = workerStatus);
-            const queueTasks = allTasks.filter(t => t.taskKind === 'diagnostician' || t.taskKind === 'sleep_reflection' || t.taskKind === 'keyword_optimization');
+            const queueTasks = allTasks.filter(t => t.taskKind === 'diagnostician' || t.taskKind === 'keyword_optimization');
             recentTaskCount = queueTasks.length;
             failedTaskCount = queueTasks.filter(t => t.status === 'failed').length;
             if (queueTasks.length > 0) {
@@ -376,10 +265,6 @@ class AgentConsoleModel {
                 status = 'idle';
             }
         }
-        else if (agent.id === 'trinity-dreamer' || agent.id === 'trinity-philosopher' || agent.id === 'trinity-scribe') {
-            const subStatus = this.getTrinitySubAgentStatus(agent.id, workflows);
-            ({ status, lastRunAt } = subStatus);
-        }
         else if (agent.id === 'pain-diagnostic-gate') {
             status = 'idle';
         }

package/console/dist/server/routes/update-history.d.ts

@@ -0,0 +1,12 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+interface UpdateHistoryEntry {
+    id: string;
+    timestamp: string;
+    fromVersion: string;
+    toVersion: string;
+    success: boolean;
+    backupPath?: string;
+}
+export declare function appendUpdateHistory(workspaceDir: string, entry: Omit<UpdateHistoryEntry, 'id' | 'timestamp'>): void;
+export declare function handleUpdateHistoryRoute(req: IncomingMessage, res: ServerResponse, workspaceDir: string, _subPath: string): Promise<void>;
+export {};

package/console/dist/server/routes/update-history.js

@@ -0,0 +1,52 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { sendSuccess, sendMethodNotAllowed } from '../utils/response.js';
+function getHistoryPath(workspaceDir) {
+    return path.join(workspaceDir, '.pd', 'update-history.json');
+}
+function loadHistory(historyPath) {
+    if (fs.existsSync(historyPath)) {
+        try {
+            const raw = fs.readFileSync(historyPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed)) {
+                return parsed.filter((e) => typeof e === 'object' && e !== null &&
+                    typeof e.fromVersion === 'string' &&
+                    typeof e.toVersion === 'string' &&
+                    typeof e.success === 'boolean');
+            }
+        }
+        catch (err) {
+            console.warn(`[update-history] Failed to parse update history file (${historyPath}):`, err instanceof Error ? err.message : err);
+        }
+    }
+    return [];
+}
+export function appendUpdateHistory(workspaceDir, entry) {
+    const historyPath = getHistoryPath(workspaceDir);
+    const history = loadHistory(historyPath);
+    history.push({
+        ...entry,
+        id: `update-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+    });
+    // Keep last 50 entries
+    if (history.length > 50) {
+        history.splice(0, history.length - 50);
+    }
+    const dir = path.dirname(historyPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(historyPath, JSON.stringify(history, null, 2));
+}
+/* eslint-disable @typescript-eslint/max-params */
+export async function handleUpdateHistoryRoute(req, res, workspaceDir, _subPath) {
+    if (req.method !== 'GET') {
+        sendMethodNotAllowed(res);
+        return;
+    }
+    const historyPath = getHistoryPath(workspaceDir);
+    const history = loadHistory(historyPath);
+    sendSuccess(res, history);
+}

package/console/dist/server/routes/update.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Update API — provides backend for the Web UI update feature.
+ *
+ * GET  /check    — Check for updates
+ * POST /apply    — Apply an update
+ * GET  /status   — Get current update status
+ * POST /rollback — Rollback an update
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare function handleUpdateRoute(req: IncomingMessage, res: ServerResponse, workspaceDir: string, subPath: string): Promise<void>;