@principles/core 1.73.0

package/dist/adapters/code-review/code-review-pain-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { PainSignalAdapter } from '../../pain-signal-adapter.js';
+import type { PainSignal } from '../../pain-signal.js';
+import type { ReviewEvent } from './review-event-types.js';
+export declare class CodeReviewPainAdapter implements PainSignalAdapter<ReviewEvent> {
+    capture(rawEvent: ReviewEvent): PainSignal | null;
+    private deriveComplexityScore;
+    private analyzeComments;
+    private deriveSentimentScore;
+    private deriveProcessViolationScore;
+    private derivePrimaryTrigger;
+    private buildReason;
+}
+//# sourceMappingURL=code-review-pain-adapter.d.ts.map

package/dist/adapters/code-review/code-review-pain-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-review-pain-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/code-review/code-review-pain-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,yBAAyB,CAAC;AAWlF,qBAAa,qBAAsB,YAAW,iBAAiB,CAAC,WAAW,CAAC;IAC1E,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI;IAoEjD,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,WAAW;CAQpB"}

package/dist/adapters/code-review/code-review-pain-adapter.js

@@ -0,0 +1,139 @@
+import { deriveSeverity } from '../../pain-signal.js';
+const SECURITY_LABELS = ['security', 'CVE', 'vulnerability', 'auth', 'crypto'];
+export class CodeReviewPainAdapter {
+    capture(rawEvent) {
+        // Malformed: missing sessionId
+        if (!rawEvent.sessionId || typeof rawEvent.sessionId !== 'string') {
+            return null;
+        }
+        // Malformed: nothing to review
+        if ((!rawEvent.filesChanged || rawEvent.filesChanged.length === 0) &&
+            (!rawEvent.comments || rawEvent.comments.length === 0)) {
+            return null;
+        }
+        // Malformed: negative review age
+        if (typeof rawEvent.reviewAgeDays === 'number' && rawEvent.reviewAgeDays < 0) {
+            return null;
+        }
+        const complexityScore = this.deriveComplexityScore(rawEvent);
+        const commentAnalysis = this.analyzeComments(rawEvent);
+        const sentimentScore = this.deriveSentimentScore(rawEvent, commentAnalysis);
+        const processViolationScore = this.deriveProcessViolationScore(rawEvent);
+        const score = Math.round(0.25 * complexityScore +
+            0.35 * sentimentScore +
+            0.40 * processViolationScore);
+        const primaryTrigger = this.derivePrimaryTrigger(complexityScore, sentimentScore, processViolationScore);
+        const triggerTextPreview = commentAnalysis.topNegativeComment
+            ?? `Process violation: ${primaryTrigger}`;
+        return {
+            source: primaryTrigger,
+            score: Math.max(0, Math.min(100, score)),
+            timestamp: new Date().toISOString(),
+            reason: this.buildReason(primaryTrigger, rawEvent),
+            sessionId: rawEvent.sessionId,
+            agentId: 'code-review-evaluator',
+            traceId: rawEvent.traceId ?? 'unknown',
+            triggerTextPreview: triggerTextPreview.slice(0, 200),
+            domain: 'code-review',
+            severity: deriveSeverity(score),
+            context: {
+                primaryTrigger,
+                diffComplexityScore: complexityScore,
+                sentimentScore,
+                processViolationScore,
+                authorId: rawEvent.authorId,
+                reviewerIds: rawEvent.reviewerIds ?? [],
+                affectedFileCount: rawEvent.filesChanged?.length ?? 0,
+                affectedFiles: (rawEvent.filesChanged ?? []).slice(0, 10).map(f => f.path),
+                totalCommentCount: rawEvent.comments?.length ?? 0,
+                unresolvedThreadCount: rawEvent.unresolvedThreadCount ?? 0,
+                avgSentiment: Math.round(commentAnalysis.avgSentiment),
+                hasTests: rawEvent.hasTests ?? false,
+                isBreakingChange: rawEvent.isBreakingChange ?? false,
+                reviewAgeDays: rawEvent.reviewAgeDays ?? 0,
+            },
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    deriveComplexityScore(event) {
+        const fileCount = event.filesChanged?.length ?? 0;
+        const avgMagnitude = fileCount > 0
+            ? (event.filesChanged ?? []).reduce((sum, f) => sum + (f.changeMagnitude ?? 0), 0) / fileCount
+            : 0;
+        const complexity = fileCount * avgMagnitude;
+        if (complexity < 500)
+            return Math.round(complexity / 500 * 40);
+        if (complexity < 2000)
+            return Math.round(40 + (complexity - 500) / 1500 * 25);
+        if (complexity < 5000)
+            return Math.round(65 + (complexity - 2000) / 3000 * 20);
+        return Math.min(100, 85 + (complexity - 5000) / 5000 * 15);
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    analyzeComments(event) {
+        const comments = event.comments ?? [];
+        if (comments.length === 0) {
+            return { avgSentiment: 0, topNegativeComment: null, unresolvedNegativeCount: 0 };
+        }
+        let totalSentiment = 0;
+        let topNegativeComment = null;
+        let topNegativeScore = Infinity;
+        for (const c of comments) {
+            const sentiment = c.sentimentScore ?? 0;
+            totalSentiment += sentiment;
+            if (sentiment < 0 && sentiment < topNegativeScore) {
+                topNegativeScore = sentiment;
+                topNegativeComment = c.body;
+            }
+        }
+        return {
+            avgSentiment: totalSentiment / comments.length,
+            topNegativeComment,
+            unresolvedNegativeCount: comments.filter(c => !c.resolvedAt && (c.sentimentScore ?? 0) < 0).length,
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    deriveSentimentScore(event, analysis) {
+        const recencyDays = event.reviewAgeDays ?? 0;
+        const recencyMultiplier = recencyDays > 7 ? 1.5 : 1.0;
+        const negativeCount = analysis.unresolvedNegativeCount * recencyMultiplier;
+        const sentimentPain = Math.round((100 - analysis.avgSentiment) / 2);
+        const commentPain = Math.min(50, negativeCount * 15);
+        return Math.min(100, sentimentPain + commentPain);
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    deriveProcessViolationScore(event) {
+        let score = 0;
+        const fileCount = event.filesChanged?.length ?? 0;
+        const totalLines = (event.totalLinesAdded ?? 0) + (event.totalLinesDeleted ?? 0);
+        const hasTests = event.hasTests ?? false;
+        if (!hasTests && fileCount > 2)
+            score += 35;
+        if (event.isBreakingChange && !(event.labels ?? []).some(l => l.includes('breaking')))
+            score += 40;
+        const hasSecurityChanges = (event.filesChanged ?? []).some(f => SECURITY_LABELS.some(s => (f.path ?? '').toLowerCase().includes(s)));
+        if (hasSecurityChanges && !(event.hasSecurityReview ?? false))
+            score += 50;
+        if (totalLines > 500 && !hasTests)
+            score += 20;
+        return Math.min(100, score);
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    derivePrimaryTrigger(complexity, sentiment, process) {
+        if (process >= 40)
+            return 'process_violation';
+        if (sentiment >= 40)
+            return 'negative_sentiment';
+        return 'diff_complexity';
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    buildReason(trigger, event) {
+        const reasons = {
+            diff_complexity: `Diff complexity pain in ${event.filesChanged?.length ?? 0} files, ${(event.totalLinesAdded ?? 0) + (event.totalLinesDeleted ?? 0)} lines changed`,
+            negative_sentiment: `Negative review sentiment: ${event.unresolvedThreadCount ?? 0} unresolved threads`,
+            process_violation: `Process violation: no tests=${!event.hasTests}, breaking=${event.isBreakingChange}, security_review=${event.hasSecurityReview}`,
+        };
+        return reasons[trigger];
+    }
+}
+//# sourceMappingURL=code-review-pain-adapter.js.map

package/dist/adapters/code-review/code-review-pain-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-review-pain-adapter.js","sourceRoot":"","sources":["../../../src/adapters/code-review/code-review-pain-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/code-review/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Code review domain adapter for principles-core.
+ */
+export type { ReviewEvent, ReviewComment, ChangedFile, ReviewPainTriggerType } from './review-event-types.js';
+export { CodeReviewPainAdapter } from './code-review-pain-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/code-review/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/code-review/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/adapters/code-review/index.js

@@ -0,0 +1,2 @@
+export { CodeReviewPainAdapter } from './code-review-pain-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/code-review/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/code-review/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/adapters/code-review/review-event-types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Code review event types for principles-core.
+ *
+ * Per D-01: Code review is an extreme non-coding domain.
+ * Pain signals come from human judgment, not tool failures.
+ */
+/**
+ * Types of pain triggers in code review.
+ */
+export type ReviewPainTriggerType = 'diff_complexity' | 'negative_sentiment' | 'process_violation';
+/**
+ * Represents a single review comment or comment thread.
+ */
+export interface ReviewComment {
+    id: string;
+    authorId: string;
+    body: string;
+    sentimentScore: number;
+    createdAt: string;
+    resolvedAt?: string;
+    filePath?: string;
+}
+/**
+ * File changed in a PR/review.
+ */
+export interface ChangedFile {
+    path: string;
+    linesAdded: number;
+    linesDeleted: number;
+    changeMagnitude: number;
+}
+/**
+ * Structured code review event.
+ */
+export interface ReviewEvent {
+    prId: string;
+    repositoryId: string;
+    authorId: string;
+    reviewerIds: string[];
+    filesChanged: ChangedFile[];
+    totalLinesAdded: number;
+    totalLinesDeleted: number;
+    comments: ReviewComment[];
+    unresolvedThreadCount: number;
+    createdAt: string;
+    reviewAgeDays: number;
+    hasTests: boolean;
+    hasSecurityReview: boolean;
+    isBreakingChange: boolean;
+    labels: string[];
+    sessionId: string;
+    traceId?: string;
+}
+//# sourceMappingURL=review-event-types.d.ts.map

package/dist/adapters/code-review/review-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-event-types.d.ts","sourceRoot":"","sources":["../../../src/adapters/code-review/review-event-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/adapters/code-review/review-event-types.js

@@ -0,0 +1,8 @@
+/**
+ * Code review event types for principles-core.
+ *
+ * Per D-01: Code review is an extreme non-coding domain.
+ * Pain signals come from human judgment, not tool failures.
+ */
+export {};
+//# sourceMappingURL=review-event-types.js.map

package/dist/adapters/code-review/review-event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-event-types.js","sourceRoot":"","sources":["../../../src/adapters/code-review/review-event-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adapters/coding/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Coding domain adapter for OpenClaw.
+ */
+export { OpenClawPainAdapter } from './openclaw-pain-adapter.js';
+export type { PluginHookAfterToolCallEvent } from './openclaw-event-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/coding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/coding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/adapters/coding/index.js

@@ -0,0 +1,5 @@
+/**
+ * Coding domain adapter for OpenClaw.
+ */
+export { OpenClawPainAdapter } from './openclaw-pain-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/coding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/coding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/adapters/coding/openclaw-event-types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenClaw event type shims for principles-core.
+ *
+ * These are DUPLICATED minimal type shapes, NOT imports from openclaw-plugin.
+ * principles-core must NOT import from openclaw-plugin.
+ * If OpenClaw SDK changes event shapes, these shims must be updated manually.
+ */
+/**
+ * Minimal shape of OpenClaw's after_tool_call hook event.
+ * Only includes fields used by OpenClawPainAdapter.capture().
+ */
+export interface PluginHookAfterToolCallEvent {
+    /** Name of the tool that was called */
+    toolName: string;
+    /** Error message if the tool call failed */
+    error?: string;
+    /** Tool call parameters */
+    params?: Record<string, unknown>;
+    /** Result returned by the tool (success) */
+    result?: unknown;
+    /** Session ID from the hook context */
+    sessionId?: string;
+    /** Agent ID from the hook context */
+    agentId?: string;
+}
+//# sourceMappingURL=openclaw-event-types.d.ts.map

package/dist/adapters/coding/openclaw-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-event-types.d.ts","sourceRoot":"","sources":["../../../src/adapters/coding/openclaw-event-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/adapters/coding/openclaw-event-types.js

@@ -0,0 +1,9 @@
+/**
+ * OpenClaw event type shims for principles-core.
+ *
+ * These are DUPLICATED minimal type shapes, NOT imports from openclaw-plugin.
+ * principles-core must NOT import from openclaw-plugin.
+ * If OpenClaw SDK changes event shapes, these shims must be updated manually.
+ */
+export {};
+//# sourceMappingURL=openclaw-event-types.js.map

package/dist/adapters/coding/openclaw-event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-event-types.js","sourceRoot":"","sources":["../../../src/adapters/coding/openclaw-event-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/coding/openclaw-pain-adapter.d.ts

@@ -0,0 +1,27 @@
+import type { PainSignalAdapter } from '../../pain-signal-adapter.js';
+import type { PainSignal } from '../../pain-signal.js';
+import type { PluginHookAfterToolCallEvent } from './openclaw-event-types.js';
+/**
+ * OpenClaw-specific PainSignal adapter.
+ *
+ * Translates OpenClaw after_tool_call hook events to PainSignals.
+ * Per D-02: pure translation only. No GFI checks, no session logic.
+ *
+ * @example
+ * const adapter = new OpenClawPainAdapter();
+ * const signal = adapter.capture({ toolName: 'write', error: 'ENOENT' });
+ * if (signal) { /* process signal *\/ }
+ */
+export declare class OpenClawPainAdapter implements PainSignalAdapter<PluginHookAfterToolCallEvent> {
+    capture(rawEvent: PluginHookAfterToolCallEvent): PainSignal | null;
+    /**
+     * Derive pain score from error message and tool name.
+     * Higher scores for more severe/critical errors.
+     */
+    private deriveScoreFromError;
+    /**
+     * Build trigger text preview from tool params.
+     */
+    private buildTriggerPreview;
+}
+//# sourceMappingURL=openclaw-pain-adapter.d.ts.map

package/dist/adapters/coding/openclaw-pain-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-pain-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/coding/openclaw-pain-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB,CAAC,4BAA4B,CAAC;IACzF,OAAO,CAAC,QAAQ,EAAE,4BAA4B,GAAG,UAAU,GAAG,IAAI;IAgClE;;;OAGG;IAEH,OAAO,CAAC,oBAAoB;IAwC5B;;OAEG;IAEH,OAAO,CAAC,mBAAmB;CAgB5B"}

package/dist/adapters/coding/openclaw-pain-adapter.js

@@ -0,0 +1,102 @@
+import { deriveSeverity } from '../../pain-signal.js';
+/**
+ * OpenClaw-specific PainSignal adapter.
+ *
+ * Translates OpenClaw after_tool_call hook events to PainSignals.
+ * Per D-02: pure translation only. No GFI checks, no session logic.
+ *
+ * @example
+ * const adapter = new OpenClawPainAdapter();
+ * const signal = adapter.capture({ toolName: 'write', error: 'ENOENT' });
+ * if (signal) { /* process signal *\/ }
+ */
+export class OpenClawPainAdapter {
+    capture(rawEvent) {
+        // Non-failure: return null
+        if (!rawEvent.error) {
+            return null;
+        }
+        // Malformed: missing required fields
+        if (!rawEvent.toolName || typeof rawEvent.toolName !== 'string') {
+            return null;
+        }
+        // Derive score from error characteristics
+        const score = this.deriveScoreFromError(rawEvent.error, rawEvent.toolName);
+        return {
+            source: 'tool_failure',
+            score,
+            timestamp: new Date().toISOString(),
+            reason: `Tool ${rawEvent.toolName} failed: ${rawEvent.error}`,
+            sessionId: rawEvent.sessionId ?? 'unknown',
+            agentId: rawEvent.agentId ?? 'unknown',
+            traceId: rawEvent.sessionId ?? 'unknown', // Use sessionId as traceId proxy
+            triggerTextPreview: this.buildTriggerPreview(rawEvent),
+            domain: 'coding',
+            severity: deriveSeverity(score),
+            context: {
+                toolName: rawEvent.toolName,
+                hasParams: !!rawEvent.params,
+            },
+        };
+    }
+    /**
+     * Derive pain score from error message and tool name.
+     * Higher scores for more severe/critical errors.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    deriveScoreFromError(error, _toolName) {
+        const err = error.toLowerCase();
+        // Critical errors: file system corruption, security violations
+        if (err.includes('permission denied') || err.includes('eacces')) {
+            return 95;
+        }
+        if (err.includes('enoent') || err.includes('no such file')) {
+            return 80; // Common but severe in coding context
+        }
+        if (err.includes('eisdir') || err.includes('eisfdir')) {
+            return 85;
+        }
+        // High severity: validation failures, type errors
+        if (err.includes('syntaxerror') || err.includes('parseerror')) {
+            return 82;
+        }
+        if (err.includes('typeerror') || err.includes('invalid type')) {
+            return 75;
+        }
+        if (err.includes('referenceerror')) {
+            return 72;
+        }
+        // Medium severity: operational failures
+        if (err.includes('timeout') || err.includes('etimedout')) {
+            return 60;
+        }
+        if (err.includes('econnrefused') || err.includes('network')) {
+            return 65;
+        }
+        if (err.includes('enotempty') || err.includes('eexist')) {
+            return 55;
+        }
+        // Default: treat as moderate operational failure
+        return 50;
+    }
+    /**
+     * Build trigger text preview from tool params.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    buildTriggerPreview(event) {
+        if (!event.params)
+            return '';
+        const p = event.params;
+        // Common params across write/edit tools
+        const filePath = p.file_path || p.path || p.file || '';
+        const newString = p.new_string || p.content || '';
+        if (filePath) {
+            return `${event.toolName}(${filePath})`;
+        }
+        if (newString && newString.length > 50) {
+            return `${event.toolName}(${newString.slice(0, 50)}...)`;
+        }
+        return event.toolName;
+    }
+}
+//# sourceMappingURL=openclaw-pain-adapter.js.map

package/dist/adapters/coding/openclaw-pain-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-pain-adapter.js","sourceRoot":"","sources":["../../../src/adapters/coding/openclaw-pain-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/writing/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Writing domain adapter for principles-core.
+ */
+export { WritingPainAdapter } from './writing-pain-adapter.js';
+export type { TextAnalysisResult, WritingIssueType } from './writing-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/writing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/writing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/adapters/writing/index.js

@@ -0,0 +1,5 @@
+/**
+ * Writing domain adapter for principles-core.
+ */
+export { WritingPainAdapter } from './writing-pain-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/writing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/writing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/adapters/writing/writing-pain-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { PainSignalAdapter } from '../../pain-signal-adapter.js';
+import type { PainSignal } from '../../pain-signal.js';
+import type { TextAnalysisResult } from './writing-types.js';
+/**
+ * Writing domain PainSignal adapter.
+ *
+ * Translates upstream text quality analysis results into PainSignals.
+ * Per D-02: pure translation only. No LLM calls, no quality evaluation.
+ *
+ * @example
+ * const adapter = new WritingPainAdapter();
+ * const analysis = { issueType: 'style_inconsistency', severityScore: 65, description: '...', excerpt: '...', sessionId: 'sess-1' };
+ * const signal = adapter.capture(analysis);
+ */
+export declare class WritingPainAdapter implements PainSignalAdapter<TextAnalysisResult> {
+    capture(rawEvent: TextAnalysisResult): PainSignal | null;
+    /**
+     * Build human-readable reason string.
+     */
+    private buildReason;
+}
+//# sourceMappingURL=writing-pain-adapter.d.ts.map

package/dist/adapters/writing/writing-pain-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-pain-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/writing/writing-pain-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,oBAAoB,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB,CAAC,kBAAkB,CAAC;IAC9E,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,UAAU,GAAG,IAAI;IAyCxD;;OAEG;IAEH,OAAO,CAAC,WAAW;CASpB"}

package/dist/adapters/writing/writing-pain-adapter.js

@@ -0,0 +1,62 @@
+import { deriveSeverity } from '../../pain-signal.js';
+/**
+ * Writing domain PainSignal adapter.
+ *
+ * Translates upstream text quality analysis results into PainSignals.
+ * Per D-02: pure translation only. No LLM calls, no quality evaluation.
+ *
+ * @example
+ * const adapter = new WritingPainAdapter();
+ * const analysis = { issueType: 'style_inconsistency', severityScore: 65, description: '...', excerpt: '...', sessionId: 'sess-1' };
+ * const signal = adapter.capture(analysis);
+ */
+export class WritingPainAdapter {
+    capture(rawEvent) {
+        // Malformed: missing required fields
+        if (!rawEvent.issueType || rawEvent.severityScore === undefined) {
+            return null;
+        }
+        // Malformed: severityScore out of range
+        if (typeof rawEvent.severityScore !== 'number' ||
+            rawEvent.severityScore < 0 ||
+            rawEvent.severityScore > 100) {
+            return null;
+        }
+        // Malformed: missing sessionId
+        if (!rawEvent.sessionId || typeof rawEvent.sessionId !== 'string') {
+            return null;
+        }
+        // Derive score from upstream severityScore
+        const score = Math.round(rawEvent.severityScore);
+        return {
+            source: rawEvent.issueType,
+            score,
+            timestamp: new Date().toISOString(),
+            reason: this.buildReason(rawEvent.issueType, rawEvent.description),
+            sessionId: rawEvent.sessionId,
+            agentId: 'writing-evaluator',
+            traceId: rawEvent.traceId ?? 'unknown',
+            triggerTextPreview: rawEvent.excerpt.slice(0, 200),
+            domain: 'writing',
+            severity: deriveSeverity(score),
+            context: {
+                issueType: rawEvent.issueType,
+                excerptLength: rawEvent.excerpt.length,
+            },
+        };
+    }
+    /**
+     * Build human-readable reason string.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    buildReason(issueType, description) {
+        const labels = {
+            text_coherence_violation: 'Text coherence violation',
+            style_inconsistency: 'Style inconsistency',
+            narrative_arc_break: 'Narrative arc break',
+            tone_mismatch: 'Tone mismatch',
+        };
+        return `${labels[issueType]}: ${description}`;
+    }
+}
+//# sourceMappingURL=writing-pain-adapter.js.map

package/dist/adapters/writing/writing-pain-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-pain-adapter.js","sourceRoot":"","sources":["../../../src/adapters/writing/writing-pain-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAC7B,OAAO,CAAC,QAA4B;QAClC,qCAAqC;QACrC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wCAAwC;QACxC,IACE,OAAO,QAAQ,CAAC,aAAa,KAAK,QAAQ;YAC1C,QAAQ,CAAC,aAAa,GAAG,CAAC;YAC1B,QAAQ,CAAC,aAAa,GAAG,GAAG,EAC5B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2CAA2C;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEjD,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,SAAS;YAC1B,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC;YAClE,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,mBAAmB;YAC5B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,SAAS;YACtC,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAClD,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC;YAC/B,OAAO,EAAE;gBACP,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;aACvC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qEAAqE;IAC7D,WAAW,CAAC,SAA2B,EAAE,WAAmB;QAClE,MAAM,MAAM,GAAqC;YAC/C,wBAAwB,EAAE,0BAA0B;YACpD,mBAAmB,EAAE,qBAAqB;YAC1C,mBAAmB,EAAE,qBAAqB;YAC1C,aAAa,EAAE,eAAe;SAC/B,CAAC;QACF,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE,CAAC;IAChD,CAAC;CACF"}

package/dist/adapters/writing/writing-types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Writing domain types for principles-core.
+ *
+ * Per D-01: Writing adapter receives pre-evaluated TextAnalysisResult
+ * from an upstream quality evaluator. The adapter does pure translation
+ * only — no LLM calls, no external dependencies.
+ */
+/**
+ * Issue types for creative writing quality problems.
+ * These are produced by an upstream text quality evaluator.
+ */
+export type WritingIssueType = 'text_coherence_violation' | 'style_inconsistency' | 'narrative_arc_break' | 'tone_mismatch';
+/**
+ * Structured text analysis result from upstream quality evaluator.
+ *
+ * The evaluator is OUTSIDE this adapter. The adapter only translates
+ * this structured result into a PainSignal. This keeps the adapter
+ * pure and testable with synthetic data.
+ */
+export interface TextAnalysisResult {
+    /** Type of quality issue detected */
+    issueType: WritingIssueType;
+    /** Quality score 0-100 (higher = more severe issue) */
+    severityScore: number;
+    /** Description of the quality issue */
+    description: string;
+    /** Text snippet that triggered the issue */
+    excerpt: string;
+    /** Session ID from the conversation */
+    sessionId: string;
+    /** Optional trace ID for correlation */
+    traceId?: string;
+}
+//# sourceMappingURL=writing-types.d.ts.map

package/dist/adapters/writing/writing-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-types.d.ts","sourceRoot":"","sources":["../../../src/adapters/writing/writing-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,eAAe,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/adapters/writing/writing-types.js

@@ -0,0 +1,9 @@
+/**
+ * Writing domain types for principles-core.
+ *
+ * Per D-01: Writing adapter receives pre-evaluated TextAnalysisResult
+ * from an upstream quality evaluator. The adapter does pure translation
+ * only — no LLM calls, no external dependencies.
+ */
+export {};
+//# sourceMappingURL=writing-types.js.map