oh-my-knowledge 0.29.0 → 0.31.0

package/dist/src/observability/resolved-review.js

@@ -0,0 +1,231 @@
+import { observationReviewStateKey } from './review-state.js';
+export function resolveObservationReviewSession(options) {
+    const { session, enhancedReview, reviewState } = options;
+    const hasSessionManualReview = Boolean(reviewState.entries[observationReviewStateKey('experience_session', session.id)]);
+    const deterministicAnswers = session.sessionStory?.answers ?? [];
+    const llmAssessment = enhancedReview?.runtimeAssessment;
+    const source = hasSessionManualReview
+        ? 'manual'
+        : llmAssessment
+            ? 'llm'
+            : 'deterministic';
+    return {
+        priority: resolvePriority(session.reviewPriority, enhancedReview, hasSessionManualReview),
+        answers: resolveAnswers({
+            sessionId: session.id,
+            skillName: session.skillName,
+            deterministicAnswers,
+            enhancedReview,
+            reviewState,
+        }),
+        reviewerSummary: enhancedReview?.reviewerSummary,
+        ownerSuggestions: ownerSuggestionTexts(enhancedReview),
+        source,
+    };
+}
+export function resolveObservationReviewPriority(priority, enhancedReview, hasManualReview) {
+    return resolvePriority(priority, enhancedReview, hasManualReview);
+}
+function resolvePriority(priority, enhancedReview, hasManualReview) {
+    if (hasManualReview)
+        return priority;
+    const assessment = enhancedReview?.runtimeAssessment;
+    if (!assessment)
+        return priority;
+    const hasFailed = assessment.goalSatisfaction === 'failed'
+        || assessment.declaredBehaviorFit === 'failed'
+        || assessment.artifactGoalMatch === 'failed'
+        || assessment.userFeeling === 'negative'
+        || assessment.userFeeling === 'frustrated';
+    if (hasFailed)
+        return 'review_first';
+    const hasUnknown = assessment.goalSatisfaction === 'unknown'
+        || assessment.declaredBehaviorFit === 'unknown'
+        || assessment.artifactGoalMatch === 'unknown'
+        || assessment.userFeeling === 'neutral';
+    if (hasUnknown && priority === 'routine_sample')
+        return 'sample_review';
+    return priority;
+}
+function resolveAnswers(options) {
+    const { deterministicAnswers, enhancedReview } = options;
+    if (!enhancedReview?.runtimeAssessment)
+        return deterministicAnswers;
+    const baseAnswers = deterministicAnswers.length > 0 ? deterministicAnswers : defaultAnswers();
+    return baseAnswers.map((answer) => manualAnswerTouched(options.reviewState, options.sessionId, options.skillName, answer.key)
+        ? answer
+        : resolveAnswerFromLlm(answer, enhancedReview));
+}
+function defaultAnswers() {
+    return [
+        defaultAnswer('goal_satisfaction', '用户目标有没有被满足'),
+        defaultAnswer('declared_behavior_fit', '行为是否符合能力用途'),
+        defaultAnswer('user_feeling', '用户是否觉得有用或绕路'),
+    ];
+}
+function defaultAnswer(key, label) {
+    return {
+        key,
+        label,
+        status: 'unknown',
+        reason: 'unknown_dominant',
+        sourceItemKeys: [],
+        text: '',
+        evidenceRefs: [],
+        checklistItems: [],
+    };
+}
+function resolveAnswerFromLlm(answer, enhancedReview) {
+    const assessment = enhancedReview.runtimeAssessment;
+    if (!assessment)
+        return answer;
+    if (answer.key === 'goal_satisfaction') {
+        const status = verdictStatus(assessment.goalSatisfaction);
+        const artifactStatus = verdictStatus(assessment.artifactGoalMatch);
+        const goalText = shortList(enhancedReview.userGoal?.slots) || enhancedReview.userGoal?.summary || '未提取到';
+        return {
+            ...answer,
+            status,
+            reason: reasonForStatus(status),
+            text: enhancedReview.reviewerSummary ?? answer.text,
+            checklistItems: [
+                checklistItem('llm_user_goal_slots', `用户目标关键词：${goalText}`, goalText !== '未提取到' ? 'passed' : 'unknown', 'LLM 基于运行时用户消息抽取目标关键词。'),
+                checklistItem('llm_goal_satisfaction', `用户目标满足：${verdictLabel(assessment.goalSatisfaction)}`, status === 'ok' ? 'passed' : status === 'attention' ? 'failed' : 'unknown', 'LLM 基于运行证据判断目标是否满足。', 'blocking'),
+                checklistItem('llm_artifact_goal_match', `产物对题：${verdictLabel(assessment.artifactGoalMatch)}`, artifactStatus === 'ok' ? 'passed' : artifactStatus === 'attention' ? 'failed' : 'unknown', 'LLM 判断产物是否匹配用户目标。', 'attention'),
+            ],
+        };
+    }
+    if (answer.key === 'declared_behavior_fit') {
+        const status = verdictStatus(assessment.declaredBehaviorFit);
+        const declaredGoal = shortList([
+            ...(enhancedReview.skillDeclaredGoal?.keywords ?? []),
+            ...(enhancedReview.skillDeclaredGoal?.expectedOutcomes ?? []),
+        ]) || enhancedReview.skillDeclaredGoal?.summary || '未提取到';
+        return {
+            ...answer,
+            status,
+            reason: reasonForStatus(status),
+            text: enhancedReview.reviewerSummary ?? answer.text,
+            checklistItems: [
+                checklistItem('llm_skill_declared_goal', `skill 声明目标：${declaredGoal}`, declaredGoal !== '未提取到' ? 'passed' : 'unknown', 'LLM 基于 SKILL.md 抽取能力声明目标。'),
+                checklistItem('llm_declared_behavior_fit', `行为符合声明：${verdictLabel(assessment.declaredBehaviorFit)}`, status === 'ok' ? 'passed' : status === 'attention' ? 'failed' : 'unknown', 'LLM 判断运行行为是否符合 skill 声明。', 'blocking'),
+            ],
+        };
+    }
+    if (answer.key === 'user_feeling') {
+        const status = feelingStatus(assessment.userFeeling);
+        const signals = enhancedReview.userExperienceSignals;
+        return {
+            ...answer,
+            status,
+            reason: reasonForStatus(status),
+            text: enhancedReview.reviewerSummary ?? answer.text,
+            checklistItems: [
+                checklistItem('llm_user_useful', `用户觉得有用：${verdictLabel(signals?.useful)}`, verdictItemStatus(signals?.useful), 'LLM 判断用户是否表现出有用或采纳信号。', 'positive'),
+                checklistItem('llm_user_follow_up', `用户追问：${verdictLabel(signals?.followUp)}`, verdictItemStatus(signals?.followUp), 'LLM 判断用户是否继续追问结果、进度或补充上下文。', 'attention'),
+                checklistItem('llm_user_correction', `用户纠正：${verdictLabel(signals?.correction)}`, verdictItemStatus(signals?.correction), 'LLM 判断用户是否明确纠正方向或结果。', 'attention'),
+                checklistItem('llm_user_negative_feedback', `负向反馈：${verdictLabel(signals?.negativeFeedback)}`, verdictItemStatus(signals?.negativeFeedback), 'LLM 判断用户是否表达不满、否定或失望。', 'attention'),
+                checklistItem('llm_user_interruption', `中断流程：${verdictLabel(signals?.interruption)}`, verdictItemStatus(signals?.interruption), 'LLM 判断用户是否中断、停止或放弃当前流程。', 'blocking'),
+                checklistItem('llm_user_frustration', `烦躁/失望：${signals?.frustration ? verdictLabel(signals.frustration) : feelingLabel(assessment.userFeeling)}`, signals?.frustration ? verdictItemStatus(signals.frustration) : status === 'attention' ? 'failed' : status === 'ok' ? 'passed' : 'unknown', 'LLM 基于用户反馈、追问和语气判断用户是否烦躁或失望。', 'attention'),
+            ],
+        };
+    }
+    return answer;
+}
+function verdictStatus(value) {
+    if (value === 'passed')
+        return 'ok';
+    if (value === 'failed')
+        return 'attention';
+    return 'unknown';
+}
+function feelingStatus(value) {
+    if (value === 'positive')
+        return 'ok';
+    if (value === 'negative' || value === 'frustrated')
+        return 'attention';
+    return 'unknown';
+}
+function verdictItemStatus(value) {
+    if (value === 'passed')
+        return 'passed';
+    if (value === 'failed')
+        return 'failed';
+    return 'unknown';
+}
+function verdictLabel(value) {
+    if (value === 'passed')
+        return '是';
+    if (value === 'failed')
+        return '否';
+    return '无法判断';
+}
+function feelingLabel(value) {
+    if (value === 'positive')
+        return '正向';
+    if (value === 'neutral')
+        return '中性';
+    if (value === 'negative')
+        return '负向';
+    if (value === 'frustrated')
+        return '烦躁/失望';
+    return '无法判断';
+}
+function reasonForStatus(status) {
+    if (status === 'ok')
+        return 'all_passed';
+    if (status === 'attention')
+        return 'attention_accumulated';
+    return 'unknown_dominant';
+}
+function checklistItem(key, label, status, reason, contribution = 'informational') {
+    return {
+        key,
+        label,
+        status,
+        contribution,
+        reason,
+        evidenceRefs: [],
+        source: 'llm_soft',
+    };
+}
+function manualAnswerTouched(reviewState, sessionId, skillName, answerKey) {
+    if (answerKey === 'goal_satisfaction') {
+        return hasManualValue(reviewState, 'goal_keyword_correction', `${sessionId}:goal_keyword`)
+            || hasManualValue(reviewState, 'completion_result_correction', `${sessionId}:completion_result`)
+            || hasManualValue(reviewState, 'deliverable_artifact_correction', `${sessionId}:deliverable_artifact`);
+    }
+    if (answerKey === 'declared_behavior_fit') {
+        return hasManualValue(reviewState, 'skill_relevance_correction', `${sessionId}:skill_relevance:${skillName}`)
+            || hasManualValue(reviewState, 'workflow_completion_correction', `${sessionId}:workflow_completion:${skillName}`)
+            || hasManualValue(reviewState, 'hardrule_execution_correction', `${sessionId}:hardrule_execution:${skillName}`)
+            || hasManualValue(reviewState, 'main_tool_execution_correction', `${sessionId}:main_tool_execution:${skillName}`);
+    }
+    return false;
+}
+function hasManualValue(reviewState, targetType, targetId) {
+    const entry = reviewState.entries[observationReviewStateKey(targetType, targetId)];
+    if (!entry)
+        return false;
+    return Boolean(entry.note?.trim() || entry.reason?.trim() || entry.verdict);
+}
+function ownerSuggestionTexts(enhancedReview) {
+    return (enhancedReview?.ownerSuggestions ?? [])
+        .map((suggestion) => {
+        const title = suggestion.title?.trim();
+        const body = suggestion.body?.trim();
+        const acceptance = suggestion.acceptanceCriteria?.trim();
+        return [title, body, acceptance ? `验收：${acceptance}` : ''].filter(Boolean).join('。');
+    })
+        .filter((suggestion) => suggestion.length > 0)
+        .filter((suggestion, index, arr) => arr.indexOf(suggestion) === index)
+        .slice(0, 4);
+}
+function shortList(values) {
+    return Array.from(new Set((values ?? [])
+        .map((value) => value.replace(/\s+/g, ' ').trim())
+        .filter(Boolean)))
+        .slice(0, 4)
+        .join(' / ');
+}
+//# sourceMappingURL=resolved-review.js.map

package/dist/src/observability/resolved-review.js.map

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

package/dist/src/observability/review-state.d.ts

@@ -0,0 +1,61 @@
+export type ObservationReviewTargetType = 'experience_session' | 'inbox_item' | 'skill' | 'goal_slice_correction' | 'evidence_metric' | 'reviewer_judgment' | 'soft_standard' | 'goal_keyword_correction' | 'result_artifact_correction' | 'completion_result_correction' | 'deliverable_artifact_correction' | 'skill_relevance_correction' | 'workflow_completion_correction' | 'hardrule_execution_correction' | 'main_tool_execution_correction';
+export type ObservationReviewVerdict = 'reviewed' | 'real_issue' | 'not_issue' | 'needs_more_context' | 'confirmed' | 'rejected';
+export type ObservationMetricKey = 'user_correction' | 'user_interruption' | 'user_follow_up' | 'negative_feedback' | 'positive_feedback' | 'hard_rule' | 'user_goal_shift' | 'result_artifact' | 'completion_result' | 'deliverable_artifact' | 'progress_update' | 'self_correction' | 'repeated_execution';
+export type ObservationMetricScope = 'message' | 'skill_segment';
+export interface ObservationReviewStateEntry {
+    targetType: ObservationReviewTargetType;
+    targetId: string;
+    verdict: ObservationReviewVerdict;
+    reviewedAt: string;
+    note?: string;
+    reason?: string;
+    metricKey?: ObservationMetricKey;
+    metricScope?: ObservationMetricScope;
+    metricScopeId?: string;
+    sourceTrace?: string;
+    sessionId?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    snippet?: string;
+}
+export interface ObservationReviewState {
+    kind: 'observe-review-state';
+    schemaVersion: 1;
+    updatedAt: string;
+    entries: Record<string, ObservationReviewStateEntry>;
+}
+export interface ObservationReviewStateUpdate {
+    targetType: ObservationReviewTargetType;
+    targetId: string;
+    verdict: ObservationReviewVerdict;
+    note?: string;
+    reason?: string;
+    metricKey?: ObservationMetricKey;
+    metricScope?: ObservationMetricScope;
+    metricScopeId?: string;
+    sourceTrace?: string;
+    sessionId?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    snippet?: string;
+}
+export declare function observationReviewStateKey(targetType: ObservationReviewTargetType, targetId: string): string;
+export declare function observationMetricScopeFor(metricKey: ObservationMetricKey): ObservationMetricScope;
+export declare function observationMetricAnnotationTargetId(ref: {
+    id?: string;
+    sourceTrace?: string;
+    sessionId?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    metricScopeId?: string;
+}, metricKey: ObservationMetricKey): string;
+export declare function observationMetricAnnotationVerdict(state: ObservationReviewState | undefined, ref: Parameters<typeof observationMetricAnnotationTargetId>[0], metricKey: ObservationMetricKey): 'confirmed' | 'rejected' | undefined;
+export declare function observationReviewStatePath(observationsDir: string): string;
+export declare function emptyObservationReviewState(now?: string): ObservationReviewState;
+export declare function loadObservationReviewState(observationsDir: string): ObservationReviewState;
+export declare function updateObservationReviewState(observationsDir: string, update: ObservationReviewStateUpdate, now?: string): ObservationReviewState;
+export declare function deleteObservationReviewState(observationsDir: string, targetType: ObservationReviewTargetType, targetId: string, now?: string): ObservationReviewState;
+//# sourceMappingURL=review-state.d.ts.map

package/dist/src/observability/review-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-state.d.ts","sourceRoot":"","sources":["../../../src/observability/review-state.ts"],"names":[],"mappings":"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"}

package/dist/src/observability/review-state.js

@@ -0,0 +1,169 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function observationReviewStateKey(targetType, targetId) {
+    return `${targetType}:${targetId}`;
+}
+export function observationMetricScopeFor(metricKey) {
+    return metricKey === 'user_correction'
+        || metricKey === 'user_interruption'
+        || metricKey === 'user_follow_up'
+        || metricKey === 'hard_rule'
+        || metricKey === 'user_goal_shift'
+        ? 'skill_segment'
+        : 'message';
+}
+export function observationMetricAnnotationTargetId(ref, metricKey) {
+    const hasStableTraceRef = Boolean(ref.sourceTrace || ref.sessionId || ref.messageIndex !== undefined || ref.messageUuid || ref.toolUseId);
+    const scope = observationMetricScopeFor(metricKey);
+    const stable = [
+        metricKey,
+        ...(scope === 'skill_segment' ? [scope, ref.metricScopeId ?? ''] : []),
+        ref.sourceTrace ?? '',
+        ref.sessionId ?? '',
+        ref.messageIndex === undefined ? '' : String(ref.messageIndex),
+        ref.messageUuid ?? '',
+        ref.toolUseId ?? '',
+        hasStableTraceRef ? '' : ref.id ?? '',
+    ].join('\u0000');
+    return `metric:${metricKey}:${createHash('sha256').update(stable).digest('hex').slice(0, 16)}`;
+}
+export function observationMetricAnnotationVerdict(state, ref, metricKey) {
+    if (!state)
+        return undefined;
+    const targetId = observationMetricAnnotationTargetId(ref, metricKey);
+    const entry = state.entries[observationReviewStateKey('evidence_metric', targetId)];
+    return entry?.verdict === 'confirmed' || entry?.verdict === 'rejected' ? entry.verdict : undefined;
+}
+export function observationReviewStatePath(observationsDir) {
+    return join(observationsDir, 'review-state.json');
+}
+export function emptyObservationReviewState(now = new Date().toISOString()) {
+    return {
+        kind: 'observe-review-state',
+        schemaVersion: 1,
+        updatedAt: now,
+        entries: {},
+    };
+}
+export function loadObservationReviewState(observationsDir) {
+    const path = observationReviewStatePath(observationsDir);
+    if (!existsSync(path))
+        return emptyObservationReviewState();
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (parsed.kind !== 'observe-review-state' || parsed.schemaVersion !== 1 || !parsed.entries || typeof parsed.entries !== 'object') {
+            return emptyObservationReviewState();
+        }
+        return {
+            kind: 'observe-review-state',
+            schemaVersion: 1,
+            updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : new Date().toISOString(),
+            entries: Object.fromEntries(Object.entries(parsed.entries).filter(([, entry]) => isReviewStateEntry(entry))),
+        };
+    }
+    catch {
+        return emptyObservationReviewState();
+    }
+}
+export function updateObservationReviewState(observationsDir, update, now = new Date().toISOString()) {
+    assertReviewStateUpdate(update);
+    const state = loadObservationReviewState(observationsDir);
+    const key = observationReviewStateKey(update.targetType, update.targetId);
+    state.entries[key] = {
+        targetType: update.targetType,
+        targetId: update.targetId,
+        verdict: update.verdict,
+        reviewedAt: now,
+        ...(update.note ? { note: update.note.slice(0, 500) } : {}),
+        ...(update.reason ? { reason: update.reason.slice(0, 500) } : {}),
+        ...(update.metricKey ? { metricKey: update.metricKey } : {}),
+        ...(update.metricKey ? { metricScope: update.metricScope ?? observationMetricScopeFor(update.metricKey) } : {}),
+        ...(update.metricScopeId ? { metricScopeId: update.metricScopeId.slice(0, 200) } : {}),
+        ...(update.sourceTrace ? { sourceTrace: update.sourceTrace } : {}),
+        ...(update.sessionId ? { sessionId: update.sessionId } : {}),
+        ...(update.messageIndex !== undefined ? { messageIndex: update.messageIndex } : {}),
+        ...(update.messageUuid ? { messageUuid: update.messageUuid } : {}),
+        ...(update.toolUseId ? { toolUseId: update.toolUseId } : {}),
+        ...(update.snippet ? { snippet: update.snippet.slice(0, 500) } : {}),
+    };
+    state.updatedAt = now;
+    mkdirSync(observationsDir, { recursive: true });
+    writeFileSync(observationReviewStatePath(observationsDir), JSON.stringify(state, null, 2));
+    return state;
+}
+export function deleteObservationReviewState(observationsDir, targetType, targetId, now = new Date().toISOString()) {
+    if (!isReviewTargetType(targetType))
+        throw new Error('invalid review targetType');
+    if (typeof targetId !== 'string' || targetId.trim() === '')
+        throw new Error('invalid review targetId');
+    const state = loadObservationReviewState(observationsDir);
+    const key = observationReviewStateKey(targetType, targetId);
+    delete state.entries[key];
+    state.updatedAt = now;
+    mkdirSync(observationsDir, { recursive: true });
+    writeFileSync(observationReviewStatePath(observationsDir), JSON.stringify(state, null, 2));
+    return state;
+}
+function assertReviewStateUpdate(value) {
+    if (!isReviewTargetType(value.targetType))
+        throw new Error('invalid review targetType');
+    if (typeof value.targetId !== 'string' || value.targetId.trim() === '')
+        throw new Error('invalid review targetId');
+    if (!isReviewVerdict(value.verdict))
+        throw new Error('invalid review verdict');
+    if (value.targetType === 'evidence_metric' && !isObservationMetricKey(value.metricKey))
+        throw new Error('invalid metricKey');
+    if (value.metricScope !== undefined && !isObservationMetricScope(value.metricScope))
+        throw new Error('invalid metricScope');
+    if ((value.verdict === 'confirmed' || value.verdict === 'rejected') && value.targetType !== 'evidence_metric')
+        throw new Error('metric verdict requires evidence_metric targetType');
+}
+function isReviewStateEntry(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const entry = value;
+    return isReviewTargetType(entry.targetType)
+        && typeof entry.targetId === 'string'
+        && isReviewVerdict(entry.verdict)
+        && typeof entry.reviewedAt === 'string';
+}
+function isReviewTargetType(value) {
+    return value === 'experience_session'
+        || value === 'inbox_item'
+        || value === 'skill'
+        || value === 'goal_slice_correction'
+        || value === 'evidence_metric'
+        || value === 'reviewer_judgment'
+        || value === 'soft_standard'
+        || value === 'goal_keyword_correction'
+        || value === 'result_artifact_correction'
+        || value === 'completion_result_correction'
+        || value === 'deliverable_artifact_correction'
+        || value === 'skill_relevance_correction'
+        || value === 'workflow_completion_correction'
+        || value === 'hardrule_execution_correction'
+        || value === 'main_tool_execution_correction';
+}
+function isReviewVerdict(value) {
+    return value === 'reviewed' || value === 'real_issue' || value === 'not_issue' || value === 'needs_more_context' || value === 'confirmed' || value === 'rejected';
+}
+function isObservationMetricScope(value) {
+    return value === 'message' || value === 'skill_segment';
+}
+function isObservationMetricKey(value) {
+    return value === 'user_correction'
+        || value === 'user_interruption'
+        || value === 'user_follow_up'
+        || value === 'negative_feedback'
+        || value === 'positive_feedback'
+        || value === 'hard_rule'
+        || value === 'user_goal_shift'
+        || value === 'result_artifact'
+        || value === 'completion_result'
+        || value === 'deliverable_artifact'
+        || value === 'progress_update'
+        || value === 'self_correction'
+        || value === 'repeated_execution';
+}
+//# sourceMappingURL=review-state.js.map

package/dist/src/observability/review-state.js.map

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

package/dist/src/observability/skill-chain-advisories.d.ts

@@ -0,0 +1,25 @@
+/**
+ * inbox 报告侧的 skill-chain 改进建议字典。
+ *
+ * 仅为 inbox UI 展示用，不动 doctor 的 pass/fail 语义。
+ * code 命名风格与 doctor i18n key（如 `skill_metadata.hint.hardrules`）对齐，
+ * 这样将来 doctor 若也要展示同样的提示，code 可复用。
+ */
+export type SkillChainAdvisoryCode = 'hardrules_not_declared' | 'workflows_not_declared' | 'skill_md_not_found';
+export interface SkillChainAdvisory {
+    code: SkillChainAdvisoryCode;
+    message: string;
+    /** 可选：例子 yaml（hardrules / workflows 用） */
+    exampleYaml?: string;
+    /** 可选：建议命令模板，`${skillName}` 会被替换 */
+    commandTemplate?: string;
+    /** advisory 在 L1 辅助推断里展示的简短 caution 标签（不超过 18 字） */
+    shortLabel: string;
+}
+export declare function getSkillChainAdvisory(code: SkillChainAdvisoryCode): SkillChainAdvisory;
+/**
+ * 把 commandTemplate 里的 `${skillName}` 占位符替换成实际 skill 名。
+ * 只接受字母/数字/横线/下划线，避免 shell 注入风险。
+ */
+export declare function resolveAdvisoryCommand(advisory: SkillChainAdvisory, skillName: string): string | undefined;
+//# sourceMappingURL=skill-chain-advisories.d.ts.map

package/dist/src/observability/skill-chain-advisories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-chain-advisories.d.ts","sourceRoot":"","sources":["../../../src/observability/skill-chain-advisories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,wBAAwB,GACxB,wBAAwB,GACxB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAmDD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAEtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1G"}

package/dist/src/observability/skill-chain-advisories.js

@@ -0,0 +1,69 @@
+/**
+ * inbox 报告侧的 skill-chain 改进建议字典。
+ *
+ * 仅为 inbox UI 展示用，不动 doctor 的 pass/fail 语义。
+ * code 命名风格与 doctor i18n key（如 `skill_metadata.hint.hardrules`）对齐，
+ * 这样将来 doctor 若也要展示同样的提示，code 可复用。
+ */
+const ADVISORIES = {
+    hardrules_not_declared: {
+        code: 'hardrules_not_declared',
+        shortLabel: '未标准化 hardRules',
+        message: '未在 SKILL.md frontmatter 标准化声明 hardRules。以下内容为检测结果；建议沉淀为标准化 hardRules。',
+        exampleYaml: [
+            '---',
+            'name: your-skill',
+            'description: ...',
+            'hardRules:',
+            '  - id: must-confirm-project',
+            '    rule: 生成前先确认 projectId',
+            '    expectedBehavior: 调用方未提供 projectId 时主动追问，不要凭空生成',
+            '  - id: read-domain-first',
+            '    rule: 必须读取领域知识',
+            '    expectedBehavior: 先读 domain/*.md，缺失就降级提示，禁止跳过',
+            '---',
+        ].join('\n'),
+    },
+    workflows_not_declared: {
+        code: 'workflows_not_declared',
+        shortLabel: '未标准化 workflows',
+        message: '未在 SKILL.md frontmatter 标准化声明 workflows。以下内容为检测结果；建议沉淀为标准化 workflows。',
+        exampleYaml: [
+            '---',
+            'name: your-skill',
+            'workflows:',
+            '  - id: main',
+            '    description: 标准主流程',
+            '    nodes:',
+            '      - id: collect-input',
+            '        action: 收集需求与上下文',
+            '      - id: read-domain',
+            '        action: 读取领域知识',
+            '      - id: generate',
+            '        action: 生成产物',
+            '      - id: upload',
+            '        action: 上传到需求管理系统',
+            '---',
+        ].join('\n'),
+    },
+    skill_md_not_found: {
+        code: 'skill_md_not_found',
+        shortLabel: '本地未找到 SKILL.md',
+        message: '本地常见 skill 目录里没有这个 skill 的 SKILL.md，inbox 跑不了静态/运行时审计。如果你想看更多体检维度（依赖检查、可读性等），可以试试 omk doctor；inbox 本身不依赖它。',
+        commandTemplate: 'omk doctor ~/.claude/skills/${skillName}/SKILL.md --static-only',
+    },
+};
+export function getSkillChainAdvisory(code) {
+    return ADVISORIES[code];
+}
+/**
+ * 把 commandTemplate 里的 `${skillName}` 占位符替换成实际 skill 名。
+ * 只接受字母/数字/横线/下划线，避免 shell 注入风险。
+ */
+export function resolveAdvisoryCommand(advisory, skillName) {
+    if (!advisory.commandTemplate)
+        return undefined;
+    const safe = /^[A-Za-z0-9_.-]+$/.test(skillName) ? skillName : '<skill-name>';
+    return advisory.commandTemplate.replace(/\$\{skillName\}/g, safe);
+}
+//# sourceMappingURL=skill-chain-advisories.js.map

package/dist/src/observability/skill-chain-advisories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-chain-advisories.js","sourceRoot":"","sources":["../../../src/observability/skill-chain-advisories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,MAAM,UAAU,GAAuD;IACrE,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE;YACX,KAAK;YACL,kBAAkB;YAClB,kBAAkB;YAClB,YAAY;YACZ,8BAA8B;YAC9B,4BAA4B;YAC5B,qDAAqD;YACrD,2BAA2B;YAC3B,oBAAoB;YACpB,mDAAmD;YACnD,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE;YACX,KAAK;YACL,kBAAkB;YAClB,YAAY;YACZ,cAAc;YACd,wBAAwB;YACxB,YAAY;YACZ,2BAA2B;YAC3B,0BAA0B;YAC1B,yBAAyB;YACzB,wBAAwB;YACxB,sBAAsB;YACtB,sBAAsB;YACtB,oBAAoB;YACpB,2BAA2B;YAC3B,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,4GAA4G;QACrH,eAAe,EAAE,iEAAiE;KACnF;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA4B,EAAE,SAAiB;IACpF,IAAI,CAAC,QAAQ,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;IAC9E,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC"}