create-principles-disciple 1.104.0 → 1.104.2

package/plugin/dist/commands/rollback-impl.js

@@ -1,180 +0,0 @@
-/**
- * Rollback Implementation Command — CLI `/pd-rollback-impl`
- * ==========================================================
- *
- * PURPOSE: Revert the current active implementation and restore the previous one.
- *
- * FLOW:
- *   1. List active implementations
- *   2. On confirm: current -> disabled, previous -> active
- *
- * SAFETY:
- *   - If no previous active: current -> disabled (degrades to hard-boundary gates)
- *   - Rollback records persisted with full audit trail
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { withLock } from '../utils/file-lock.js';
-import { atomicWriteFileSync } from '../utils/io.js';
-import { WorkspaceContext } from '../core/workspace-context.js';
-import { refreshPrincipleLifecycle } from '../core/principle-internalization/lifecycle-refresh.js';
-import { loadLedger, transitionImplementationState, } from '../core/principle-tree-ledger.js';
-import { normalizeCommandArgs } from '../utils/io.js';
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-/**
- * Get all implementations from the ledger.
- */
-function getAllImplementations(stateDir) {
-    const ledger = loadLedger(stateDir);
-    return Object.values(ledger.tree.implementations);
-}
-/**
- * Handle the /pd-rollback-impl command.
- *
- * Usage:
- *   /pd-rollback-impl list                          - List active implementations
- *   /pd-rollback-impl <implId>                      - Rollback current active
- *   /pd-rollback-impl <implId> --reason "<reason>"  - Rollback with reason
- */
-export function handleRollbackImplCommand(ctx) {
-    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'rollback-impl');
-    const { stateDir } = WorkspaceContext.fromHookContext({ ...ctx, workspaceDir });
-    const lang = ctx.config?.language || 'en';
-    const isZh = lang === 'zh';
-    const args = normalizeCommandArgs(ctx.args).trim();
-    // Parse args
-    const subcommand = args.split(/\s+/)[0] || '';
-    const implId = subcommand === 'list' ? '' : subcommand;
-    const reasonMatch = (/--reason\s+"([^"]+)"/.exec(args)) || (/--reason\s+(\S+)/.exec(args));
-    const reason = reasonMatch ? (reasonMatch[1] ?? null) : null;
-    // List active
-    if (subcommand === 'list' || subcommand === '') {
-        return _handleListActiveRollback(stateDir, isZh);
-    }
-    return _handleRollbackImpl(workspaceDir, stateDir, implId, reason, isZh, ctx.sessionId);
-}
-function _handleListActiveRollback(stateDir, isZh) {
-    const allImpls = getAllImplementations(stateDir);
-    const activeImpls = allImpls.filter((impl) => impl.lifecycleState === 'active');
-    if (activeImpls.length === 0) {
-        return {
-            text: isZh
-                ? '\n\u2139\ufe0f \u6ca1\u6709\u6d3b\u8dc3\u5b9e\u73b0\u53ef\u56de\u6eda\u3002'
-                : '\n\u2139\ufe0f No active implementations to rollback.',
-        };
-    }
-    let output = isZh ? '\n\ud83d\udccb \u53ef\u56de\u6eda\u6d3b\u8dc3\u5b9e\u73b0\n' : '\n\ud83d\udccb Active Implementations Available for Rollback\n';
-    output += `${'='.repeat(50)}\n`;
-    for (const impl of activeImpls) {
-        const hasPrevious = impl.previousActive ? '\u2705' : '\u26a0\ufe0f \u65e0\u524d\u4e00\u4e2a';
-        output += `  ${impl.id}\n`;
-        output += `    Rule: ${impl.ruleId} | Version: ${impl.version}\n`;
-        output += `    Has previous: ${hasPrevious}\n`;
-        if (impl.previousActive) {
-            output += `    Previous: ${impl.previousActive}\n`;
-        }
-        output += '\n';
-    }
-    output += isZh
-        ? '\u7528\u6cd5: /pd-rollback-impl <implId> --reason "\u539f\u56e0"'
-        : 'Usage: /pd-rollback-impl <implId> --reason "reason"';
-    return { text: output };
-}
-function _handleRollbackImpl(workspaceDir, stateDir, implId, reason, isZh, sessionId) {
-    const allImpls = getAllImplementations(stateDir);
-    const currentActive = allImpls.find((i) => i.id === implId);
-    if (!currentActive) {
-        return {
-            text: isZh
-                ? `\u274c \u672a\u627e\u5230\u5b9e\u73b0: ${implId}`
-                : `\u274c Implementation not found: ${implId}`,
-        };
-    }
-    const currentState = currentActive.lifecycleState;
-    if (currentState !== 'active') {
-        return {
-            text: isZh
-                ? `\u274c \u5b9e\u73b0 ${implId} \u5f53\u524d\u72b6\u6001: ${currentState}\n\u53ea\u80fd\u56de\u6eda\u6d3b\u8dc3\u5b9e\u73b0\u3002`
-                : `\u274c Implementation ${implId} is in state: ${currentState}\nCan only rollback active implementations.`,
-        };
-    }
-    const previousActiveId = currentActive.previousActive;
-    const reasonText = reason || (isZh ? '\u7528\u6237\u624b\u52a8\u56de\u6eda' : 'User manual rollback');
-    // Step 1: Current active -> disabled
-    transitionImplementationState(stateDir, implId, 'disabled');
-    let restoredMessage;
-    if (previousActiveId && allImpls.some((i) => i.id === previousActiveId)) {
-        // Step 2: Restore previous active -> active
-        transitionImplementationState(stateDir, previousActiveId, 'active');
-        restoredMessage = isZh
-            ? `\n   \u5df2\u6062\u590d\u524d\u4e00\u4e2a\u6d3b\u8dc3\u5b9e\u73b0: ${previousActiveId}\n   \u72b6\u6001: disabled -> active`
-            : `\n   Restored previous active implementation: ${previousActiveId}\n   State: disabled -> active`;
-    }
-    else {
-        // No previous active — degrade to hard-boundary gates (per Phase 12 D-08)
-        restoredMessage = isZh
-            ? `\n   \u26a0\ufe0f \u6ca1\u6709\u524d\u4e00\u4e2a\u6d3b\u8dc3\u5b9e\u73b0\uff0c\u8be5\u89c4\u5219\u6ca1\u6709\u6d3b\u8dc3\u5b9e\u73b0\u3002`
-                + `\n   GFI\u3001Progressive Gate\u7b49\u786c\u56fa\u62b1\u95e8\u4ecd\u7136\u6b63\u5e38\u8fd0\u884c\u3002`
-            : `\n   \u26a0\ufe0f No previous active implementation. Rule has no active code implementation.`
-                + ` Existing hard-boundary gates (GFI, Progressive Gate) continue functioning normally.`;
-    }
-    // Store rollback record
-    const rollbackDir = path.join(stateDir, 'principles', 'implementations', implId, 'rollbacks');
-    if (!fs.existsSync(rollbackDir)) {
-        fs.mkdirSync(rollbackDir, { recursive: true });
-    }
-    const rollbackRecord = {
-        rolledBackBy: sessionId || 'manual',
-        rolledBackAt: new Date().toISOString(),
-        reason: reasonText,
-        previousImplementationId: previousActiveId || null,
-        restoredImplementationId: previousActiveId && allImpls.some((i) => i.id === previousActiveId)
-            ? previousActiveId
-            : null,
-        rolledBackImplId: implId,
-    };
-    const rollbackTimestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const rollbackPath = path.join(rollbackDir, `${rollbackTimestamp}.json`);
-    withLock(rollbackPath, () => {
-        atomicWriteFileSync(rollbackPath, JSON.stringify(rollbackRecord, null, 2));
-    });
-    try {
-        refreshPrincipleLifecycle(workspaceDir, stateDir);
-    }
-    catch (err) {
-        console.warn('[rollback-impl] Lifecycle refresh failed:', err instanceof Error ? err.stack : err);
-    }
-    let output = isZh
-        ? `\n\u2705 \u56de\u6eda\u5b8c\u6210: ${implId}\n   \u72b6\u6001: active -> disabled\n   \u539f\u56e0: ${reasonText}`
-        : `\n\u2705 Rollback complete: ${implId}\n   State: active -> disabled\n   Reason: ${reasonText}`;
-    output += restoredMessage;
-    return { text: output };
-}
-/**
- * Handle natural language rollback request.
- * Detects phrases like "回滚这个规则实现", "rollback this implementation".
- */
-export function handleNaturalLanguageRollbackImpl(workspaceDir, sessionId, reason) {
-    const isZh = (/[\u4e00-\u9fff]/.exec(reason)) || false;
-    const { stateDir } = WorkspaceContext.fromHookContext({ workspaceDir });
-    if (!sessionId) {
-        return {
-            success: false,
-            message: isZh ? '\u65e0\u6cd5\u8bc6\u522b\u5f53\u524d\u4f1a\u8bdd' : 'Session not found',
-        };
-    }
-    // Natural language entry: get last active implementation
-    const allImpls = getAllImplementations(stateDir);
-    const lastActive = allImpls.find((i) => i.lifecycleState === 'active');
-    if (!lastActive) {
-        return {
-            success: false,
-            message: isZh ? '\u5f53\u524d\u6ca1\u6709\u6d3b\u8dc3\u5b9e\u73b0' : 'No active implementations',
-        };
-    }
-    // Would be called via the hook — return the impl ID for the hook to route
-    return {
-        success: true,
-        message: `${lastActive.id}|${reason}`,
-    };
-}

package/plugin/dist/commands/rollback.js

@@ -1,126 +0,0 @@
-import { WorkspaceContext } from '../core/workspace-context.js';
-import { resetFriction } from '../core/session-tracker.js';
-import { normalizeCommandArgs } from '../utils/io.js';
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-/**
- * Handles the /pd-rollback command
- *
- * Usage:
- *   /pd-rollback <event-id>  - Rollback a specific empathy event by ID
- *   /pd-rollback last        - Rollback the last empathy event in current session
- */
-export function handleRollbackCommand(ctx) {
-    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'rollback');
-    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const lang = ctx.config?.language || 'en';
-    const isZh = lang === 'zh';
-    const { sessionId } = ctx;
-    const args = normalizeCommandArgs(ctx.args).trim();
-    if (!args) {
-        return {
-            text: isZh
-                ? `❌ 请指定要回滚的事件 ID 或使用 "last" 回滚最近一次事件。
-    
-用法:
-  /pd-rollback <event-id>  - 回滚指定事件
-  /pd-rollback last        - 回滚当前会话最近一次事件`
-                : `❌ Please specify an event ID or use "last" to rollback the most recent event.
-
-Usage:
-  /pd-rollback <event-id>  - Rollback a specific event
-  /pd-rollback last        - Rollback the last event in current session`
-        };
-    }
-    if (!sessionId) {
-        return {
-            text: isZh
-                ? `❌ 无法识别当前会话，请在聊天会话中使用此命令。`
-                : `❌ Session ID not found. Use this command in a chat session.`
-        };
-    }
-    let eventId;
-    if (args === 'last') {
-        // Find the last empathy event in current session
-        eventId = wctx.eventLog.getLastEmpathyEventId(sessionId);
-        if (!eventId) {
-            return {
-                text: isZh
-                    ? `❌ 当前会话没有可回滚的情绪事件。`
-                    : `❌ No empathy events found in current session to rollback.`
-            };
-        }
-    }
-    else {
-        // Use the provided event ID
-        eventId = args;
-    }
-    // Perform rollback
-    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(eventId, sessionId, isZh ? '用户手动回滚' : 'User manual rollback', 'user_command');
-    if (rolledBackScore === 0) {
-        return {
-            text: isZh
-                ? `❌ 无法回滚事件 "${eventId}"。可能事件不存在或已被去重。`
-                : `❌ Failed to rollback event "${eventId}". Event may not exist or was deduped.`
-        };
-    }
-    // Reduce the GFI by the rolled back score
-    resetFriction(sessionId, workspaceDir, {
-        source: 'user_empathy',
-        amount: rolledBackScore,
-    });
-    return {
-        text: isZh
-            ? `✅ 已回滚情绪事件
-   📋 事件 ID: ${eventId}
-   💰 撤销分数: ${rolledBackScore} 分
-   
-💡 提示: 已重置当前会话的疲劳指数。`
-            : `✅ Empathy event rolled back successfully
-   📋 Event ID: ${eventId}
-   💰 Score recovered: ${rolledBackScore} pts
-   
-💡 Hint: Session friction has been reset.`
-    };
-}
-/**
- * Handle natural language rollback request
- * Called from prompt hook when user says things like "撤销刚才的惩罚"
- */
-export function handleNaturalLanguageRollback(wctx, sessionId, reason) {
-    const isZh = wctx.config.get('language') === 'zh';
-    if (!sessionId) {
-        return {
-            success: false,
-            score: 0,
-            message: isZh ? '无法识别当前会话' : 'Session not found'
-        };
-    }
-    const eventId = wctx.eventLog.getLastEmpathyEventId(sessionId);
-    if (!eventId) {
-        return {
-            success: false,
-            score: 0,
-            message: isZh ? '当前会话没有可回滚的情绪事件' : 'No empathy events to rollback'
-        };
-    }
-    const rolledBackScore = wctx.eventLog.rollbackEmpathyEvent(eventId, sessionId, reason, 'natural_language');
-    if (rolledBackScore === 0) {
-        return {
-            success: false,
-            score: 0,
-            message: isZh ? '回滚失败，事件可能不存在' : 'Rollback failed, event may not exist'
-        };
-    }
-    // Reduce only the empathy slice instead of wiping the whole session GFI.
-    resetFriction(sessionId, wctx.workspaceDir, {
-        source: 'user_empathy',
-        amount: rolledBackScore,
-    });
-    return {
-        success: true,
-        score: rolledBackScore,
-        message: isZh
-            ? `已回滚 ${rolledBackScore} 分`
-            : `Rolled back ${rolledBackScore} pts`
-    };
-}

package/plugin/dist/commands/samples.js

@@ -1,83 +0,0 @@
-import { WorkspaceContext } from '../core/workspace-context.js';
-import { normalizeCommandArgs } from '../utils/io.js';
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-import { emitPainDetectedEvent } from '../hooks/pain.js';
-import { SystemLogger } from '../core/system-logger.js';
-function isZh(ctx) {
-    return String(ctx.config?.language || 'en').startsWith('zh');
-}
-export function handleSamplesCommand(ctx) {
-    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'samples');
-    const zh = isZh(ctx);
-    const args = normalizeCommandArgs(ctx.args).trim();
-    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    if (args.startsWith('review ')) {
-        const [, decision = '', sampleId = '', ...noteParts] = args.split(/\s+/);
-        if (decision !== 'approve' && decision !== 'reject') {
-            return {
-                text: zh
-                    ? '无效的审核动作。请使用 `review approve <sample-id> [note]` 或 `review reject <sample-id> [note]`。'
-                    : 'Invalid review action. Use `review approve <sample-id> [note]` or `review reject <sample-id> [note]`.',
-            };
-        }
-        if (!sampleId) {
-            return {
-                text: zh
-                    ? '缺少 sample-id。'
-                    : 'Missing sample-id.',
-            };
-        }
-        const normalizedDecision = decision === 'approve' ? 'approved' : 'rejected';
-        const note = noteParts.join(' ').trim();
-        let record;
-        try {
-            record = wctx.trajectory.reviewCorrectionSample(sampleId, normalizedDecision, note);
-            /* eslint-disable @typescript-eslint/no-unused-vars -- Reason: error handling only - returning failure response */
-        }
-        catch (error) {
-            return {
-                text: zh
-                    ? `审核样本失败：${sampleId}`
-                    : `Failed to review sample: ${sampleId}`,
-            };
-        }
-        // 修断裂④(spec §6.3): reject 时触发 pain event,接通"owner-rejected 纠正 → 诊断"桥。
-        // 之前 recordCorrectionRejectedPain 只写 DB 不触发诊断,是假桥。
-        // 这里 fire-and-forget emitPainDetectedEvent(source='correction_rejected')。
-        if (normalizedDecision === 'rejected') {
-            const painScore = Math.max(0, Math.min(100, Math.round(record.qualityScore)));
-            void emitPainDetectedEvent(wctx, {
-                ts: new Date().toISOString(),
-                type: 'pain_detected',
-                data: {
-                    painId: `correction_rejected_${record.sampleId}`,
-                    painType: 'user_frustration',
-                    source: 'correction_rejected',
-                    reason: `Owner rejected correction sample (quality ${record.qualityScore})`,
-                    score: painScore,
-                    sessionId: record.sessionId,
-                    agentId: 'main',
-                    provenance: 'openclaw_context_bound',
-                    evidence: [{ sourceRef: 'correction_sample', note: record.diffExcerpt.slice(0, 200) }],
-                },
-            }, { recordObservability: true }).catch((e) => {
-                SystemLogger.log(workspaceDir, 'SIGNAL_REJECT_EMIT_FAIL', `emitPainDetectedEvent failed on reject: ${String(e)}`);
-            });
-        }
-        return {
-            text: zh
-                ? `样本 ${record.sampleId} 已标记为 ${record.reviewStatus}。`
-                : `Sample ${record.sampleId} marked as ${record.reviewStatus}.`,
-        };
-    }
-    const samples = wctx.trajectory.listCorrectionSamples('pending');
-    if (samples.length === 0) {
-        return { text: zh ? '当前没有待审核纠错样本。' : 'No pending correction samples.' };
-    }
-    const lines = samples.map((sample) => `- ${sample.sampleId} | session=${sample.sessionId} | score=${sample.qualityScore}`);
-    return {
-        text: zh
-            ? `待审核纠错样本:\n${lines.join('\n')}`
-            : `Pending correction samples:\n${lines.join('\n')}`,
-    };
-}

package/plugin/dist/commands/strategy.js

@@ -1,16 +0,0 @@
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-import { WorkspaceContext } from '../core/workspace-context.js';
-export function handleInitStrategy(ctx) {
-    const workspaceDir = resolvePluginCommandWorkspaceDir(ctx, 'strategy');
-    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const okrDir = wctx.resolve('OKR_DIR').replace(workspaceDir, '').replace(/^\/+/, '');
-    const focusPath = wctx.resolve('CURRENT_FOCUS').replace(workspaceDir, '').replace(/^\/+/, '');
-    const userContextPath = wctx.resolve('USER_CONTEXT').replace(workspaceDir, '').replace(/^\/+/, '');
-    return {
-        text: `🎯 **Strategy Initialization**\n\n` +
-            `The Agent will now conduct a deep interview to establish your project's vision and strategic OKRs.\n\n` +
-            `**Instructions for Agent:** Read \`${okrDir}/\` for existing context. ` +
-            `Generate \`${focusPath}\` with the top 1-3 strategic focus areas based on the user interview. ` +
-            `Then update \`${userContextPath}\` with key user preferences discovered.`,
-    };
-}

package/plugin/dist/commands/thinking-os.js

@@ -1,186 +0,0 @@
-import * as fs from 'fs';
-import { normalizeCommandArgs } from '../utils/io.js';
-import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js';
-import { WorkspaceContext } from '../core/workspace-context.js';
-// rc-1/rc-2: Treat JSON.parse output as unknown and validate before use.
-// Local guard matches the pattern in index.ts and rule-implementation-runtime.ts.
-function isRecord(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-// Safely read a numeric field from an untrusted record (rc-4: validate element types).
-function readNumber(record, key) {
-    const v = record[key];
-    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
-}
-function getWorkspaceDir(ctx) {
-    return resolvePluginCommandWorkspaceDir(ctx, 'thinking-os');
-}
-function getModels(wctx) {
-    const modelsPath = wctx.resolve('THINKING_OS');
-    const models = {};
-    if (!fs.existsSync(modelsPath))
-        return models;
-    try {
-        const content = fs.readFileSync(modelsPath, 'utf8');
-        const lines = content.split('\n');
-        for (const line of lines) {
-            const match = /^###\s*(T-\d+):\s*(.*)/.exec(line);
-            if (match) {
-                const key = match[1];
-                const value = match[2];
-                if (key === undefined || value === undefined)
-                    continue;
-                models[key] = value.trim();
-            }
-        }
-    }
-    catch (e) {
-        console.debug('[PD] Failed to read THINKING_OS.md:', e);
-    }
-    return models;
-}
-function formatUsageReport(wctx) {
-    const logPath = wctx.resolve('THINKING_OS_USAGE');
-    if (!fs.existsSync(logPath)) {
-        return '📊 No usage data yet. The Thinking OS has not been active long enough to collect statistics.';
-    }
-    try {
-        // rc-1: JSON.parse output is unknown. rc-2: do not bypass with `as`.
-        const parsed = JSON.parse(fs.readFileSync(logPath, 'utf8'));
-        if (!isRecord(parsed)) {
-            return '❌ Failed to read usage data: usage log is not a valid JSON object.';
-        }
-        const totalTurns = readNumber(parsed, '_total_turns') || 1;
-        const models = getModels(wctx);
-        let report = `# 🧠 Thinking OS — Usage Report\n\n`;
-        report += `Total turns tracked: **${totalTurns}**\n\n`;
-        report += `| Model | Name | Hits | Rate |\n|---|---|---|---|\n`;
-        for (const [id, name] of Object.entries(models)) {
-            const hits = readNumber(parsed, id);
-            const rate = totalTurns > 0 ? ((hits / totalTurns) * 100).toFixed(1) : '0.0';
-            const status = hits === 0 ? '⚠️' : (parseFloat(rate) < 5 ? '🔸' : '✅');
-            report += `| ${id} | ${name} | ${hits} | ${status} ${rate}% |\n`;
-        }
-        const dormant = Object.entries(models)
-            .filter(([id]) => readNumber(parsed, id) === 0)
-            .map(([id, name]) => `- ${id}: ${name}`);
-        if (dormant.length > 0) {
-            report += `\n### ⚠️ Dormant Models (0 hits)\n${dormant.join('\n')}\n`;
-            report += `\nConsider: Are these models not applicable to current tasks, or is the agent ignoring them?\n`;
-        }
-        return report;
-    }
-    catch (e) {
-        return `❌ Failed to read usage data: ${String(e)}`;
-    }
-}
-function handlePropose(wctx, proposal) {
-    if (!proposal.trim()) {
-        return '❌ Usage: `/thinking-os propose <description of your proposed mental model>`';
-    }
-    if (!proposal.toLowerCase().includes('signal') && !proposal.includes('信号')) {
-        return '❌ Invalid proposal: A mental model must include a "Signal detection / 信号检测" section explaining how to detect its usage via regex.';
-    }
-    const candidatesPath = wctx.resolve('THINKING_OS_CANDIDATES');
-    if (fs.existsSync(candidatesPath)) {
-        try {
-            const content = fs.readFileSync(candidatesPath, 'utf8');
-            const snippet = proposal.substring(0, 30);
-            if (content.includes(snippet)) {
-                return '❌ Duplicate proposal detected. A similar candidate already exists.';
-            }
-        }
-        catch (e) {
-            console.debug('[PD] Error reading candidates file:', e);
-        }
-    }
-    const timestamp = new Date().toISOString();
-    const entry = `\n### Candidate (${timestamp})\n${proposal.trim()}\n- Status: PENDING\n- Validated in tasks: 0/3\n---\n`;
-    try {
-        fs.appendFileSync(candidatesPath, entry, 'utf8');
-        return `✅ Mental model proposal recorded in \`${candidatesPath.replace(wctx.workspaceDir, '')}\`.\nIt needs validation in ≥3 different task types and human approval before promotion.`;
-    }
-    catch (e) {
-        return `❌ Failed to write proposal: ${String(e)}`;
-    }
-}
-function formatAuditReport(wctx) {
-    const logPath = wctx.resolve('THINKING_OS_USAGE');
-    const thinkingOsPath = wctx.resolve('THINKING_OS');
-    let report = `# 🔍 Thinking OS — Audit Report\n\n`;
-    if (!fs.existsSync(thinkingOsPath)) {
-        report += `⚠️ **THINKING_OS.md not found.** The cognitive layer is not active.\n`;
-        return report;
-    }
-    const models = getModels(wctx);
-    const modelCount = Object.keys(models).length;
-    report += `**Active models**: ${modelCount}\n\n`;
-    if (!fs.existsSync(logPath)) {
-        report += `📊 No usage data collected yet. Run some tasks first.\n`;
-        return report;
-    }
-    try {
-        // rc-1: JSON.parse output is unknown. rc-2: do not bypass with `as`.
-        const parsed = JSON.parse(fs.readFileSync(logPath, 'utf8'));
-        if (!isRecord(parsed)) {
-            return `❌ Failed to generate audit report: usage log is not a valid JSON object.`;
-        }
-        const totalTurns = readNumber(parsed, '_total_turns') || 1;
-        const overused = [];
-        const underused = [];
-        const healthy = [];
-        for (const [id, name] of Object.entries(models)) {
-            const hits = readNumber(parsed, id);
-            const rate = (hits / totalTurns) * 100;
-            if (rate > 50)
-                overused.push(`- ${id} (${name}): ${rate.toFixed(1)}% — possibly too broad a pattern?`);
-            else if (hits === 0 && totalTurns > 10)
-                underused.push(`- ${id} (${name}): 0 hits in ${totalTurns} turns — candidate for archival?`);
-            else
-                healthy.push(`- ${id} (${name}): ${rate.toFixed(1)}%`);
-        }
-        if (healthy.length > 0)
-            report += `### ✅ Healthy\n${healthy.join('\n')}\n\n`;
-        if (overused.length > 0)
-            report += `### 🔸 Possibly Over-triggered\n${overused.join('\n')}\n\n`;
-        if (underused.length > 0) {
-            report += `### ⚠️ Candidate for Archival\n${underused.join('\n')}\n`;
-            report += `> 💡 Suggestion: Review these models. If they are obsolete, move them to the archive.\n\n`;
-        }
-        const candidatesPath = wctx.resolve('THINKING_OS_CANDIDATES');
-        if (fs.existsSync(candidatesPath)) {
-            const candidates = fs.readFileSync(candidatesPath, 'utf8');
-            const pendingCount = (candidates.match(/Status: PENDING/g) || []).length;
-            if (pendingCount > 0) {
-                report += `### 📝 Pending Candidates: ${pendingCount}\nReview candidates to fill gaps.\n`;
-            }
-        }
-        return report;
-    }
-    catch (e) {
-        return `❌ Failed to generate audit report: ${String(e)}`;
-    }
-}
-export function handleThinkingOs(ctx) {
-    const workspaceDir = getWorkspaceDir(ctx);
-    const wctx = WorkspaceContext.fromHookContext({ workspaceDir, ...ctx.config });
-    const args = normalizeCommandArgs(ctx.args).trim();
-    const subCommand = args.split(/\s+/)[0]?.toLowerCase();
-    const rest = args.slice(subCommand?.length || 0).trim();
-    switch (subCommand) {
-        case 'status':
-            return { text: formatUsageReport(wctx) };
-        case 'propose':
-            return { text: handlePropose(wctx, rest) };
-        case 'audit':
-            return { text: formatAuditReport(wctx) };
-        default:
-            return {
-                text: `🧠 **Thinking OS — Governance Console**\n\n` +
-                    `Usage:\n` +
-                    `- \`/thinking-os status\` — View mental model usage statistics\n` +
-                    `- \`/thinking-os propose <model description>\` — Propose a new mental model\n` +
-                    `- \`/thinking-os audit\` — Audit model health and candidates`
-            };
-    }
-}