create-principles-disciple 1.76.0 → 1.78.0

package/core/dist/runtime-v2/workspace-guidance-migration.js

@@ -0,0 +1,193 @@
+const MIGRATION_RULES = [
+    {
+        pattern: /Physical interception|physical blocking|物理拦截/i,
+        description: 'Remove Physical interception / physical blocking / 物理拦截 references (AGENTS.md)',
+        filenameSuffixes: ['AGENTS.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /Single source of truth.*PLAN/i,
+        description: 'Remove Single source of truth PLAN references (AGENTS.md)',
+        filenameSuffixes: ['AGENTS.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /PLAN\.md` \(status: READY\)|PLAN\.md`（状态：READY）/,
+        description: 'Remove PLAN.md status: READY references (AGENTS.md, THINKING_OS.md)',
+        filenameSuffixes: ['AGENTS.md', 'THINKING_OS.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /project physical plan|项目物理计划/i,
+        description: 'Remove project physical plan / 项目物理计划 references (AGENTS.md)',
+        filenameSuffixes: ['AGENTS.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /L2 delegation.*(PLAN|gate|blocking)|L2 委派.*(PLAN|gate|拦截)/i,
+        description: 'Remove L2 delegation / L2 委派 tied to PLAN.md gate enforcement (AGENTS.md)',
+        filenameSuffixes: ['AGENTS.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: / or `PLAN\.md`/,
+        description: 'Replace "or PLAN.md" in T-02 PHYSICAL_MEMORY_PERSISTENCE (en)',
+        filenameSuffixes: ['THINKING_OS.md'],
+        actionType: 'replace',
+        replacement: '',
+    },
+    {
+        pattern: /或 `PLAN\.md`/,
+        description: 'Replace "或 PLAN.md" in T-02 PHYSICAL_MEMORY_PERSISTENCE (zh)',
+        filenameSuffixes: ['THINKING_OS.md'],
+        actionType: 'replace',
+        replacement: '',
+    },
+    {
+        pattern: /PLAN\.md mechanism protects|PLAN\.md 机制保护/,
+        description: 'Remove PLAN.md mechanism protects / PLAN.md 机制保护 lines (MEMORY.md)',
+        filenameSuffixes: ['MEMORY.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /STATUS: READY|STATUS：READY/,
+        description: 'Remove STATUS: READY references (MEMORY.md)',
+        filenameSuffixes: ['MEMORY.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /Ensure `PLAN\.md` contains `## Target Files` heading|确保 `PLAN\.md` 包含 `## Target Files` 标题/,
+        description: 'Remove PLAN.md Target Files heading checks (admin/SKILL.md)',
+        filenameSuffixes: ['admin/SKILL.md'],
+        actionType: 'remove-line',
+    },
+    {
+        pattern: /,\s*`PLAN\.md`\s*/,
+        description: 'Remove PLAN.md from list as trailing item (admin/SKILL.md, pd-grooming/SKILL.md)',
+        filenameSuffixes: ['admin/SKILL.md', 'pd-grooming/SKILL.md'],
+        actionType: 'replace',
+        replacement: '',
+    },
+    {
+        pattern: /`PLAN\.md`\s*,\s*/,
+        description: 'Remove PLAN.md from list as leading item (admin/SKILL.md, pd-grooming/SKILL.md)',
+        filenameSuffixes: ['admin/SKILL.md', 'pd-grooming/SKILL.md'],
+        actionType: 'replace',
+        replacement: '',
+    },
+    {
+        pattern: /Check `PLAN\.md` or early conversation/,
+        description: 'Replace Check PLAN.md or early conversation (en, reflection/SKILL.md)',
+        filenameSuffixes: ['reflection/SKILL.md'],
+        actionType: 'replace',
+        replacement: 'Check early conversation context',
+    },
+    {
+        pattern: /Update `PLAN\.md`/,
+        description: 'Replace Update PLAN.md with Update memory/.scratchpad.md (en, reflection/SKILL.md)',
+        filenameSuffixes: ['reflection/SKILL.md'],
+        actionType: 'replace',
+        replacement: 'Update `memory/.scratchpad.md`',
+    },
+    {
+        pattern: /检查 `PLAN\.md` 或早期对话/,
+        description: 'Replace Check PLAN.md or early conversation (zh, reflection/SKILL.md)',
+        filenameSuffixes: ['reflection/SKILL.md'],
+        actionType: 'replace',
+        replacement: '检查早期对话上下文',
+    },
+    {
+        pattern: /更新 `PLAN\.md`/,
+        description: 'Replace Update PLAN.md (zh, reflection/SKILL.md)',
+        filenameSuffixes: ['reflection/SKILL.md'],
+        actionType: 'replace',
+        replacement: '更新 `memory/.scratchpad.md`',
+    },
+    {
+        pattern: /, `PLAN\.md`, and /,
+        description: 'Remove PLAN.md from task descriptions (en, report/SKILL.md)',
+        filenameSuffixes: ['report/SKILL.md'],
+        actionType: 'replace',
+        replacement: ' and ',
+    },
+    {
+        pattern: /、`PLAN\.md` 和/,
+        description: 'Remove PLAN.md from task descriptions (zh, report/SKILL.md)',
+        filenameSuffixes: ['report/SKILL.md'],
+        actionType: 'replace',
+        replacement: '和',
+    },
+];
+export const STALE_PLAN_MD_PATTERNS = MIGRATION_RULES.map((rule) => ({ pattern: rule.pattern, description: rule.description }));
+function filenameMatches(filename, suffix) {
+    const normalized = filename.replace(/\\/g, '/');
+    return normalized === suffix || normalized.endsWith('/' + suffix);
+}
+export function migrateWorkspaceGuidance(content, filename) {
+    if (content.length === 0) {
+        return { migrated: content, changed: false };
+    }
+    const applicableRules = MIGRATION_RULES.filter((rule) => rule.filenameSuffixes.some((suffix) => filenameMatches(filename, suffix)));
+    if (applicableRules.length === 0) {
+        return { migrated: content, changed: false };
+    }
+    const removeLineRules = applicableRules.filter((r) => r.actionType === 'remove-line');
+    const replaceRules = applicableRules.filter((r) => r.actionType === 'replace');
+    const triggeredDescriptions = [];
+    let memoryMdContentRemoved = false;
+    const lines = content.split('\n');
+    const keptLines = [];
+    for (const line of lines) {
+        let shouldRemove = false;
+        for (const rule of removeLineRules) {
+            if (rule.pattern.test(line)) {
+                shouldRemove = true;
+                if (!triggeredDescriptions.includes(rule.description)) {
+                    triggeredDescriptions.push(rule.description);
+                }
+                if (filenameMatches(filename, 'MEMORY.md')) {
+                    memoryMdContentRemoved = true;
+                }
+                break;
+            }
+        }
+        if (!shouldRemove) {
+            keptLines.push(line);
+        }
+    }
+    let migrated = keptLines.join('\n');
+    for (const rule of replaceRules) {
+        const replacement = rule.replacement ?? '';
+        const before = migrated;
+        const flags = rule.pattern.flags.includes('g')
+            ? rule.pattern.flags
+            : rule.pattern.flags + 'g';
+        const globalPattern = new RegExp(rule.pattern.source, flags);
+        migrated = migrated.replace(globalPattern, replacement);
+        if (migrated !== before && !triggeredDescriptions.includes(rule.description)) {
+            triggeredDescriptions.push(rule.description);
+        }
+    }
+    if (memoryMdContentRemoved) {
+        const historicalNote = '[Historical: confirm-first gate was removed in PRI-286. This section is preserved for reference only.]';
+        if (!migrated.endsWith('\n')) {
+            migrated = migrated + '\n';
+        }
+        migrated = migrated + historicalNote;
+    }
+    const changed = migrated !== content;
+    const reason = changed
+        ? `Migrated stale PLAN.md guidance: ${triggeredDescriptions.join('; ')}`
+        : undefined;
+    return { migrated, changed, reason };
+}
+export function containsStalePlanMdGuidance(content, filename) {
+    const applicableRules = MIGRATION_RULES.filter((rule) => rule.filenameSuffixes.some((suffix) => filenameMatches(filename, suffix)));
+    for (const rule of applicableRules) {
+        if (rule.pattern.test(content)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=workspace-guidance-migration.js.map

package/core/dist/runtime-v2/workspace-guidance-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-guidance-migration.js","sourceRoot":"","sources":["../../src/runtime-v2/workspace-guidance-migration.ts"],"names":[],"mappings":"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"}

package/core/package.json

@@ -65,6 +65,10 @@
     "./runtime-v2": {
       "types": "./dist/runtime-v2/index.d.ts",
       "default": "./dist/runtime-v2/index.js"
+    },
+    "./runtime-v2/feedback": {
+      "types": "./dist/runtime-v2/feedback/index.d.ts",
+      "default": "./dist/runtime-v2/feedback/index.js"
     }
   },
   "files": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-principles-disciple",
-  "version": "1.76.0",
+  "version": "1.78.0",
   "description": "Interactive CLI installer for Principles Disciple OpenClaw plugin",
   "type": "module",
   "bin": {

package/plugin/dist/commands/context.js

@@ -185,7 +185,7 @@ function applyPreset(workspaceDir, preset, isZh) {
             break;
         case 'standard':
             config = {
-                thinkingOs: true,
+                thinkingOs: false,
                 projectFocus: 'off',
                 evolutionContext: { ...defaultContextConfig.evolutionContext }
             };
@@ -230,8 +230,8 @@ function showHelp(isZh) {
 
 **预设模式**:
 \`/pd-context minimal\` - 最小模式（仅核心原则）
-\`/pd-context standard\` - 标准模式（原则+思维模型）
-\`/pd-context full\` - 完整模式（全部开启）
+\`/pd-context standard\` - 标准模式（原则，不含思维模型）
+\`/pd-context full\` - 完整模式（原则+思维模型+项目上下文）
 
 **注意**: 核心原则始终注入，不可关闭。
 `.trim();
@@ -250,8 +250,8 @@ function showHelp(isZh) {
 
 **Presets**:
 \`/pd-context minimal\` - Minimal mode (core principles only)
-\`/pd-context standard\` - Standard mode (principles + thinking)
-\`/pd-context full\` - Full mode (all enabled)
+\`/pd-context standard\` - Standard mode (principles, no Thinking OS)
+\`/pd-context full\` - Full mode (principles + Thinking OS + project context)
 
 **Note**: Core Principles are always injected and cannot be disabled.
 `.trim();

package/plugin/dist/commands/strategy.d.ts

@@ -1,3 +1,2 @@
 import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
 export declare function handleInitStrategy(ctx: PluginCommandContext): PluginCommandResult;
-export declare function handleManageOkr(ctx: PluginCommandContext): PluginCommandResult;

package/plugin/dist/commands/strategy.js

@@ -14,17 +14,3 @@ export function handleInitStrategy(ctx) {
             `Then update \`${userContextPath}\` with key user preferences discovered.`,
     };
 }
-export function handleManageOkr(ctx) {
-    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'strategy:manageOkr');
-    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const focusPath = wctx.resolve('CURRENT_FOCUS').replace(workspaceDir, '').replace(/^\/+/, '');
-    const weekStatePath = wctx.resolve('WEEK_STATE').replace(workspaceDir, '').replace(/^\/+/, '');
-    return {
-        text: `📊 **OKR Management**\n\n` +
-            `The Agent will analyze recent work and align sub-agent objectives.\n\n` +
-            `**Instructions for Agent:** Read \`${focusPath}\` and \`${weekStatePath}\`. ` +
-            `Compare them against recent session history. ` +
-            `Update OKRs as needed and output a brief alignment report. ` +
-            `If OKRs are stale (>7 days), prompt the user for a re-alignment conversation.`,
-    };
-}

package/plugin/dist/core/runtime-v2-prompt-activation-reader.d.ts

@@ -1,15 +1,6 @@
-export declare const RUNTIME_V2_PRINCIPLE_BUDGET = 2000;
-export interface ActivatedPrinciple {
-    principleId: string;
-    text: string;
-    artifactId: string;
-    activationId: string;
-}
-export interface PromptActivationReaderResult {
-    principles: ActivatedPrinciple[];
-    warnings: string[];
-    source: 'runtime_v2';
-}
+import type { ActivatedPrinciple, PromptActivationReaderResult } from '@principles/core/runtime-v2';
+export { RUNTIME_V2_PRINCIPLE_BUDGET } from '@principles/core/runtime-v2';
+export type { ActivatedPrinciple, PromptActivationReaderResult };
 export interface PromptActivationReaderDeps {
     logger?: {
         warn?: (msg: string) => void;
@@ -22,6 +13,6 @@ export declare class PromptActivationReader {
     private readonly deps;
     constructor(workspaceDir: string, deps?: PromptActivationReaderDeps);
     readActivatedPrinciples(): Promise<PromptActivationReaderResult>;
+    private queryArtifactRow;
     private loadFeatureFlags;
-    private resolvePrincipleFromActivation;
 }

package/plugin/dist/core/runtime-v2-prompt-activation-reader.js

@@ -1,8 +1,8 @@
 import * as path from 'path';
 import * as fs from 'fs';
 import * as yaml from 'js-yaml';
-import { SqliteConnection, SqliteActivationStateStore, computeEffectiveFlags, DEFAULT_FEATURE_FLAGS } from '@principles/core/runtime-v2';
-export const RUNTIME_V2_PRINCIPLE_BUDGET = 2000;
+import { SqliteConnection, SqliteActivationStateStore, computeEffectiveFlags, DEFAULT_FEATURE_FLAGS, filterPromptActivations, resolvePrincipleFromArtifact } from '@principles/core/runtime-v2';
+export { RUNTIME_V2_PRINCIPLE_BUDGET } from '@principles/core/runtime-v2';
 const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 function isRecord(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -27,12 +27,27 @@ export class PromptActivationReader {
         try {
             sqliteConn = new SqliteConnection(this.workspaceDir);
             const store = new SqliteActivationStateStore(sqliteConn);
-            const activations = await store.listPromptActivations();
-            for (const activation of activations) {
-                if (activation.channel !== 'prompt' || activation.action !== 'prompt_activate') {
+            const allActivations = await store.listPromptActivations();
+            const promptActivations = filterPromptActivations(allActivations);
+            for (const activation of promptActivations) {
+                let artifactRow;
+                try {
+                    artifactRow = this.queryArtifactRow(sqliteConn, activation.artifactId);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    const warning = `artifact_query_failed: artifactId=${activation.artifactId} reason=${msg}; nextAction=check_pi_artifacts_table`;
+                    warnings.push(warning);
+                    this.deps.logger?.warn?.(`[PD:RuntimeV2] ${warning}`);
+                    continue;
+                }
+                if (artifactRow === null) {
+                    const warning = `artifact_not_found: artifactId=${activation.artifactId}; nextAction=check_pi_artifacts_table`;
+                    warnings.push(warning);
+                    this.deps.logger?.warn?.(`[PD:RuntimeV2] ${warning}`);
                     continue;
                 }
-                const result = this.resolvePrincipleFromActivation(sqliteConn, activation);
+                const result = resolvePrincipleFromArtifact(artifactRow, activation);
                 if (result.ok) {
                     principles.push(result.principle);
                 }
@@ -58,6 +73,21 @@ export class PromptActivationReader {
         }
         return { principles, warnings, source: 'runtime_v2' };
     }
+    queryArtifactRow(sqliteConn, artifactId) {
+        try {
+            const db = sqliteConn.getDb();
+            const row = db.prepare(`
+        SELECT artifact_id, artifact_kind, content_json, validation_status
+        FROM pi_artifacts
+        WHERE artifact_id = ?
+      `).get(artifactId);
+            return row ?? null;
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            throw new Error(`artifact_query_failed: artifactId=${artifactId} reason=${msg}; nextAction=check_pi_artifacts_table`);
+        }
+    }
     loadFeatureFlags() {
         const configPath = path.join(this.workspaceDir, '.pd', 'feature-flags.yaml');
         if (!fs.existsSync(configPath)) {
@@ -110,72 +140,4 @@ export class PromptActivationReader {
         }
         return result;
     }
-    resolvePrincipleFromActivation(sqliteConn, activation) {
-        const db = sqliteConn.getDb();
-        let contentJson;
-        try {
-            const row = db.prepare(`
-        SELECT artifact_id, artifact_kind, content_json, validation_status
-        FROM pi_artifacts
-        WHERE artifact_id = ?
-      `).get(activation.artifactId);
-            if (!isRecord(row)) {
-                return { ok: false, warning: `artifact_query_unexpected: artifactId=${activation.artifactId}; nextAction=check_pi_artifacts_table` };
-            }
-            const artifact_id = Object.hasOwn(row, 'artifact_id') && typeof row.artifact_id === 'string' && row.artifact_id.length > 0 ? row.artifact_id : null;
-            const artifact_kind = Object.hasOwn(row, 'artifact_kind') && typeof row.artifact_kind === 'string' ? row.artifact_kind : null;
-            const raw_content_json = Object.hasOwn(row, 'content_json') && typeof row.content_json === 'string' ? row.content_json : null;
-            const validation_status = Object.hasOwn(row, 'validation_status') && typeof row.validation_status === 'string' ? row.validation_status : null;
-            if (!artifact_id) {
-                return { ok: false, warning: `artifact_not_found: artifactId=${activation.artifactId} activationId=${activation.activationId}; nextAction=verify_artifact_exists_or_remove_stale_activation` };
-            }
-            if (artifact_kind !== 'principle') {
-                return { ok: false, warning: `artifact_not_principle: artifactId=${artifact_id} kind=${artifact_kind ?? 'missing'}; nextAction=skip_non_principle_activations` };
-            }
-            if (validation_status !== 'validated') {
-                return { ok: false, warning: `artifact_not_validated: artifactId=${artifact_id} status=${validation_status ?? 'missing'}; nextAction=skip_unvalidated_artifacts` };
-            }
-            if (raw_content_json === null) {
-                return { ok: false, warning: `artifact_missing_content_json: artifactId=${artifact_id}; nextAction=ensure_artifact_has_content_json` };
-            }
-            contentJson = raw_content_json;
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            return { ok: false, warning: `artifact_query_failed: artifactId=${activation.artifactId} reason=${msg}; nextAction=check_pi_artifacts_table` };
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(contentJson);
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            return { ok: false, warning: `artifact_content_json_parse_error: artifactId=${activation.artifactId} reason=${msg}; nextAction=fix_artifact_content_json` };
-        }
-        if (!isRecord(parsed)) {
-            return { ok: false, warning: `artifact_content_malformed: artifactId=${activation.artifactId} reason=parsed_to_non_object; nextAction=fix_artifact_content_json` };
-        }
-        const principleId = Object.hasOwn(parsed, 'principleId') && typeof parsed.principleId === 'string' ? parsed.principleId : undefined;
-        const text = Object.hasOwn(parsed, 'text') && typeof parsed.text === 'string' ? parsed.text : undefined;
-        const draftObj = Object.hasOwn(parsed, 'principleDraft') && isRecord(parsed.principleDraft) ? parsed.principleDraft : null;
-        const draftTitle = draftObj && Object.hasOwn(draftObj, 'title') && typeof draftObj.title === 'string' ? draftObj.title : undefined;
-        const draftStatement = draftObj && Object.hasOwn(draftObj, 'statement') && typeof draftObj.statement === 'string' ? draftObj.statement : undefined;
-        const resolvedPrincipleId = principleId && principleId.length > 0 ? principleId : draftTitle;
-        const resolvedText = text && text.length > 0 ? text : draftStatement;
-        if (!resolvedPrincipleId || resolvedPrincipleId.length === 0) {
-            return { ok: false, warning: `artifact_missing_principle_id: artifactId=${activation.artifactId}; nextAction=ensure_artifact_has_principleId_or_principleDraft_title` };
-        }
-        if (!resolvedText || resolvedText.length === 0) {
-            return { ok: false, warning: `artifact_missing_text: artifactId=${activation.artifactId} principleId=${resolvedPrincipleId}; nextAction=ensure_artifact_has_text_or_principleDraft_statement` };
-        }
-        return {
-            ok: true,
-            principle: {
-                principleId: resolvedPrincipleId,
-                text: resolvedText,
-                artifactId: activation.artifactId,
-                activationId: activation.activationId,
-            },
-        };
-    }
 }

package/plugin/dist/core/surface-guard.d.ts

@@ -0,0 +1,27 @@
+import { PLUGIN_SURFACE_REGISTRY, validateSurfaceRegistry, getSurfacesByCategory, type PluginSurfaceEntry, type MvpCategory } from '@principles/core/runtime-v2';
+import type { OpenClawPluginService } from '../openclaw-sdk.js';
+export interface SurfaceGuardResult {
+    passed: boolean;
+    enabledCoreSurfaces: string[];
+    disabledNonCoreSurfaces: string[];
+    violations: string[];
+    warnings: string[];
+}
+export declare function checkSurfaceGuard(): SurfaceGuardResult;
+export declare function getSurfaceIdForHook(hookEvent: string, label?: string): string;
+export declare function getSurfaceIdForService(serviceName: string): string;
+export declare function isSurfaceEnabled(surfaceId: string, overrides?: Record<string, boolean>): {
+    enabled: boolean;
+    reason?: string;
+};
+export type HookHandler<E, C, R> = (event: E, ctx: C) => R | Promise<R>;
+export declare function guardHook<E, C, R>(surfaceId: string, logger: {
+    info?: (msg: string) => void;
+    debug?: (msg: string) => void;
+} | undefined, handler: HookHandler<E, C, R>): HookHandler<E, C, R>;
+export declare function guardService<T extends OpenClawPluginService>(surfaceId: string, service: T, logger?: {
+    info?: (msg: string) => void;
+    debug?: (msg: string) => void;
+}): T | null;
+export { PLUGIN_SURFACE_REGISTRY, validateSurfaceRegistry, getSurfacesByCategory };
+export type { PluginSurfaceEntry, MvpCategory };

package/plugin/dist/core/surface-guard.js

@@ -0,0 +1,82 @@
+import { PLUGIN_SURFACE_REGISTRY, validateSurfaceRegistry, getSurfacesByCategory, } from '@principles/core/runtime-v2';
+export function checkSurfaceGuard() {
+    const validation = validateSurfaceRegistry(PLUGIN_SURFACE_REGISTRY);
+    const violations = [];
+    const warnings = [...validation.warnings];
+    const coreSurfaces = getSurfacesByCategory(PLUGIN_SURFACE_REGISTRY, 'core');
+    const enabledCore = coreSurfaces.filter(s => s.enabledByDefault);
+    const nonCoreEnabled = PLUGIN_SURFACE_REGISTRY.filter(s => s.category !== 'core' && s.enabledByDefault);
+    if (nonCoreEnabled.length > 0) {
+        for (const surface of nonCoreEnabled) {
+            violations.push(`non-core surface '${surface.id}' (${surface.category}) is enabledByDefault=true — must be false per ADR-0014`);
+        }
+    }
+    if (!validation.valid) {
+        violations.push(...validation.errors);
+    }
+    return {
+        passed: violations.length === 0,
+        enabledCoreSurfaces: enabledCore.map(s => s.id),
+        disabledNonCoreSurfaces: PLUGIN_SURFACE_REGISTRY
+            .filter(s => s.category !== 'core' && !s.enabledByDefault)
+            .map(s => s.id),
+        violations,
+        warnings,
+    };
+}
+export function getSurfaceIdForHook(hookEvent, label) {
+    if (label) {
+        return `hook:${hookEvent}.${label}`;
+    }
+    return `hook:${hookEvent}`;
+}
+export function getSurfaceIdForService(serviceName) {
+    return `service:${serviceName}`;
+}
+export function isSurfaceEnabled(surfaceId, overrides = {}) {
+    const entry = PLUGIN_SURFACE_REGISTRY.find(s => s.id === surfaceId);
+    if (!entry) {
+        return {
+            enabled: false,
+            reason: `surface '${surfaceId}' not found in registry — classify before enabling (PRI-289)`,
+        };
+    }
+    if (Object.hasOwn(overrides, surfaceId)) {
+        const override = overrides[surfaceId];
+        if (typeof override !== 'boolean') {
+            return { enabled: entry.enabledByDefault, reason: `override for '${surfaceId}' is not boolean, using default` };
+        }
+        if (entry.category === 'gone') {
+            return { enabled: false, reason: `surface '${surfaceId}' is gone and cannot be re-enabled` };
+        }
+        if (entry.category === 'core' && !override) {
+            return { enabled: true, reason: `surface '${surfaceId}' is core and cannot be disabled` };
+        }
+        return { enabled: override };
+    }
+    if (!entry.enabledByDefault && entry.disabledReason) {
+        return { enabled: false, reason: entry.disabledReason };
+    }
+    return { enabled: entry.enabledByDefault };
+}
+export function guardHook(surfaceId, logger, handler) {
+    const check = isSurfaceEnabled(surfaceId);
+    if (check.enabled) {
+        return handler;
+    }
+    const reason = check.reason ?? 'surface not enabled';
+    return (_event, _ctx) => {
+        logger?.info?.(`[PD:surface-guard] SKIP ${surfaceId}: ${reason}`);
+        return undefined;
+    };
+}
+export function guardService(surfaceId, service, logger) {
+    const check = isSurfaceEnabled(surfaceId);
+    if (check.enabled) {
+        return service;
+    }
+    const reason = check.reason ?? 'surface not enabled';
+    logger?.info?.(`[PD:surface-guard] SKIP service ${surfaceId}: ${reason}`);
+    return null;
+}
+export { PLUGIN_SURFACE_REGISTRY, validateSurfaceRegistry, getSurfacesByCategory };

package/plugin/dist/core/workspace-guidance-migrator.d.ts

@@ -0,0 +1,12 @@
+import type { OpenClawPluginApi } from '../openclaw-sdk.js';
+interface MigrationError {
+    file: string;
+    error: string;
+}
+export interface MigrationResult {
+    migratedFiles: string[];
+    skippedFiles: string[];
+    errors: MigrationError[];
+}
+export declare function migrateStaleWorkspaceGuidance(api: OpenClawPluginApi, workspaceDir: string): MigrationResult;
+export {};