oh-my-knowledge 0.30.0 → 0.32.0

package/dist/observability/soft-standards/skill-standards-store.js

@@ -0,0 +1,158 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildObservationSkillChain } from '../skill-chain.js';
+export function skillDerivedStandardsDir(observationsDir) {
+    return join(observationsDir, 'skill-derived');
+}
+export function skillDerivedStandardsPath(observationsDir, skillName) {
+    return join(skillDerivedStandardsDir(observationsDir), `${safeSkillFileName(skillName)}.json`);
+}
+export function loadSkillDerivedStandards(observationsDir) {
+    const dir = skillDerivedStandardsDir(observationsDir);
+    if (!existsSync(dir))
+        return {};
+    const out = {};
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const parsed = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
+            if (isSkillDerivedStandards(parsed))
+                out[parsed.skillName] = parsed;
+        }
+        catch {
+            // Ignore broken cache files; the extraction command can refresh them.
+        }
+    }
+    return out;
+}
+export function updateSkillDerivedStandardStatus(observationsDir, skillName, standardId, status, now = new Date().toISOString()) {
+    const filePath = skillDerivedStandardsPath(observationsDir, skillName);
+    const existing = loadExisting(filePath);
+    if (!existing)
+        throw new Error(`skill derived standards not found: ${skillName}`);
+    let found = false;
+    const next = {
+        ...existing,
+        generatedAt: now,
+        standards: existing.standards.map((item) => {
+            if (item.id !== standardId)
+                return item;
+            found = true;
+            return { ...item, status };
+        }),
+    };
+    if (!found)
+        throw new Error(`skill derived standard not found: ${standardId}`);
+    mkdirSync(skillDerivedStandardsDir(observationsDir), { recursive: true });
+    writeFileSync(filePath, JSON.stringify(next, null, 2));
+    return next;
+}
+export function resolveSkillStandards(skillName, options) {
+    const skillChain = options.skillChain ?? buildObservationSkillChain(skillName, options.cwd ?? process.cwd());
+    const derived = options.derivedStandards
+        ? isSkillDerivedStandards(options.derivedStandards)
+            ? options.derivedStandards
+            : options.derivedStandards[skillName]
+        : loadSkillDerivedStandards(options.observationsDir)[skillName];
+    const active = [];
+    const candidates = [];
+    const hasFrontmatterHardRules = skillChain.healthCheck.hardRules.declared && skillChain.healthCheck.hardRules.rules.length > 0;
+    const hasFrontmatterWorkflows = skillChain.healthCheck.workflows.declared && skillChain.healthCheck.workflows.workflows.length > 0;
+    for (const rule of skillChain.healthCheck.hardRules.rules) {
+        active.push({
+            id: rule.id,
+            kind: 'hard_rule',
+            title: rule.rule,
+            body: rule.expectedBehavior,
+            source: 'frontmatter',
+        });
+    }
+    for (const workflow of skillChain.healthCheck.workflows.workflows) {
+        for (const node of workflow.nodes) {
+            active.push({
+                id: `${workflow.id}.${node.id}`,
+                kind: 'workflow',
+                title: `${workflow.id} / ${node.id}`,
+                body: node.action,
+                source: 'frontmatter',
+            });
+        }
+    }
+    for (const standard of derived?.standards ?? []) {
+        const kind = standard.kind === 'workflow_candidate' ? 'workflow' : 'hard_rule';
+        const blockedByFrontmatter = kind === 'hard_rule' ? hasFrontmatterHardRules : hasFrontmatterWorkflows;
+        const resolved = {
+            id: standard.id,
+            kind,
+            title: standard.title,
+            body: standard.body,
+            source: standard.status === 'author_confirmed' ? 'confirmed_soft' : 'pending_soft',
+            status: standard.status,
+            confidence: standard.confidence,
+            evidence: standard.evidence,
+        };
+        if (!blockedByFrontmatter && standard.status === 'author_confirmed') {
+            active.push(resolved);
+        }
+        else {
+            candidates.push(resolved);
+        }
+    }
+    candidates.sort((a, b) => candidateRank(a.status) - candidateRank(b.status) || a.title.localeCompare(b.title));
+    return {
+        skillName,
+        active,
+        candidates,
+        sourcePriority: ['frontmatter', 'confirmed_soft', 'pending_soft'],
+    };
+}
+export function loadExisting(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return isSkillDerivedStandards(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function markStale(record, generatedAt) {
+    return {
+        ...record,
+        generatedAt,
+        standards: record.standards.map((item) => item.status === 'author_confirmed' || item.status === 'pending_review'
+            ? { ...item, status: 'stale' }
+            : item),
+    };
+}
+export function isSkillDerivedStandards(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const item = value;
+    return item.kind === 'observe-skill-derived-standards'
+        && item.schemaVersion === 1
+        && typeof item.skillName === 'string'
+        && Array.isArray(item.standards);
+}
+function candidateRank(status) {
+    if (status === 'pending_review')
+        return 0;
+    if (status === 'stale')
+        return 1;
+    if (status === 'rejected')
+        return 2;
+    if (status === 'author_confirmed')
+        return 3;
+    return 4;
+}
+function safeSkillFileName(skillName) {
+    const base = skillName.replace(/[^a-zA-Z0-9_.-]+/g, '-').replace(/^-+|-+$/g, '') || 'unknown';
+    return `${base.slice(0, 80)}-${hashText(skillName).slice(0, 8)}`;
+}
+export function hashText(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+//# sourceMappingURL=skill-standards-store.js.map

package/dist/observability/soft-standards/skill-standards-store.js.map

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

package/dist/observability/soft-standards/types.d.ts

@@ -0,0 +1,212 @@
+import type { ExecutorFn } from '../../types/index.js';
+import type { ObservationSkillChain, SkillRuntimeEvidencePack, SkillRuntimeEvidencePackRef } from '../skill-chain.js';
+import type { SOFT_STANDARD_PROMPT_ID, SOFT_STANDARD_PROMPT_VERSION } from './constants.js';
+export type SkillDerivedStandardStatus = 'pending_review' | 'author_confirmed' | 'rejected' | 'stale';
+export type SkillDerivedStandardKind = 'hard_rule_candidate' | 'workflow_candidate';
+export interface SkillDerivedStandard {
+    id: string;
+    kind: SkillDerivedStandardKind;
+    status: SkillDerivedStandardStatus;
+    title: string;
+    body: string;
+    source: 'llm_soft_standard';
+    confidence: 'low' | 'medium' | 'high';
+    evidence: string[];
+}
+export interface SkillDerivedStandards {
+    kind: 'observe-skill-derived-standards';
+    schemaVersion: 1;
+    skillName: string;
+    sourceSkillPath?: string;
+    sourceHash?: string;
+    generatedAt: string;
+    model: string;
+    executor: string;
+    promptId: typeof SOFT_STANDARD_PROMPT_ID;
+    promptVersion: typeof SOFT_STANDARD_PROMPT_VERSION;
+    promptHash?: string;
+    runtimeEvidenceHash?: string;
+    enhancedReview?: SkillLlmEnhancedReviewSections;
+    standards: SkillDerivedStandard[];
+}
+export interface SkillLlmEnhancedRuntimeEvidence {
+    goalSlices: Array<{
+        id?: string;
+        sessionId?: string;
+        inferredUserGoal?: string;
+        userMessages?: string[];
+    }>;
+    userMessages: string[];
+    assistantMessages: string[];
+    artifactCandidates: string[];
+    toolCalls: string[];
+    findings: string[];
+    skillRuntimeEvidencePack?: SkillRuntimeEvidencePack;
+}
+export type LlmEnhancedSkillType = 'router' | 'delegation' | 'executor' | 'advisory' | 'workflow_owner' | 'unknown';
+export type LlmEnhancedVerdict = 'passed' | 'failed' | 'unknown';
+export type LlmEnhancedUserFeeling = 'positive' | 'neutral' | 'negative' | 'frustrated';
+export type LlmEnhancedChecklistStatus = 'passed' | 'failed' | 'unknown' | 'degraded' | 'not_applicable';
+export type RuntimeStandardNodeKind = 'workflow' | 'hardRule' | 'completion' | 'artifact' | 'stage';
+export type RuntimeSignalType = 'tool_name' | 'tool_input' | 'tool_output' | 'assistant_text' | 'user_text' | 'artifact_kind' | 'artifact_path' | 'event_kind';
+export type RuntimeSignalOp = 'equals' | 'contains' | 'any_of' | 'fuzzy_contains' | 'suffix' | 'glob';
+export type RuntimeNodeVerdict = 'passed' | 'missed' | 'violated' | 'unknown' | 'degraded';
+export type RuntimeTriggerWindowScope = 'same_node' | 'same_skill_segment' | 'same_session_after' | 'anywhere_in_session';
+export interface RuntimeSignal {
+    id: string;
+    type: RuntimeSignalType;
+    value: string | string[];
+    op?: RuntimeSignalOp;
+}
+export interface RuntimeSignalRef {
+    signalGroup: 'expectedSignals' | 'failureSignals' | 'forbiddenSignals' | 'conditionSignals';
+    signalId: string;
+}
+export interface RuntimeTrigger {
+    when?: RuntimeSignalRef;
+    absence?: RuntimeSignalRef;
+    forbidden?: RuntimeSignalRef;
+    required?: RuntimeSignalRef;
+    verdict: RuntimeNodeVerdict;
+    windowScope: RuntimeTriggerWindowScope;
+}
+export interface RuntimeStandardNodeSourceHint {
+    source: 'skill_md' | 'frontmatter' | 'llm_inferred' | 'template';
+    line?: number;
+    snippet: string;
+}
+export interface RuntimeStandardNode {
+    nodeId: string;
+    nodeEvidenceRef?: string;
+    kind: RuntimeStandardNodeKind;
+    title: string;
+    description?: string;
+    childNodeIds?: string[];
+    expectedSignals: RuntimeSignal[];
+    failureSignals: RuntimeSignal[];
+    forbiddenSignals: RuntimeSignal[];
+    conditionSignals: RuntimeSignal[];
+    triggers: RuntimeTrigger[];
+    sourceHints: RuntimeStandardNodeSourceHint[];
+}
+export interface RuntimeMatchedSignal {
+    signalId: string;
+    signalType: RuntimeSignalType;
+    signalGroup: RuntimeSignalRef['signalGroup'];
+    evidenceRefs: SkillRuntimeEvidencePackRef[];
+}
+export interface RuntimeNodeResult {
+    nodeId: string;
+    kind: RuntimeStandardNodeKind;
+    title: string;
+    status: RuntimeNodeVerdict;
+    matchedSignals: RuntimeMatchedSignal[];
+    evidenceRefs: SkillRuntimeEvidencePackRef[];
+    reason: string;
+}
+export interface SkillLlmTypeSpecificChecklistItem {
+    key: string;
+    label: string;
+    status: LlmEnhancedChecklistStatus;
+    reason?: string;
+    evidence?: string[];
+    suggestionKey?: string;
+}
+export interface SkillLlmRuntimeNodeAssessment {
+    nodeId: string;
+    kind: 'workflowNode' | 'hardRule';
+    status: LlmEnhancedChecklistStatus;
+    reason?: string;
+    evidence?: string[];
+    suggestionKey?: string;
+}
+export interface SkillLlmEnhancedReviewSections {
+    skillType?: LlmEnhancedSkillType;
+    extractedStandards?: {
+        hardrules: Array<Omit<SkillDerivedStandard, 'id' | 'kind' | 'status' | 'source'>>;
+        workflows: Array<Omit<SkillDerivedStandard, 'id' | 'kind' | 'status' | 'source'>>;
+        completionCriteria: Array<Omit<SkillDerivedStandard, 'id' | 'kind' | 'status' | 'source'>>;
+        artifactCriteria: Array<Omit<SkillDerivedStandard, 'id' | 'kind' | 'status' | 'source'>>;
+        standardNodes?: RuntimeStandardNode[];
+    };
+    userGoal?: {
+        summary?: string;
+        slots: string[];
+        expectedOutcome?: string;
+    };
+    skillDeclaredGoal?: {
+        summary?: string;
+        keywords: string[];
+        expectedOutcomes: string[];
+    };
+    runtimeAssessment?: {
+        goalSatisfaction?: LlmEnhancedVerdict;
+        declaredBehaviorFit?: LlmEnhancedVerdict;
+        artifactGoalMatch?: LlmEnhancedVerdict;
+        userFeeling?: LlmEnhancedUserFeeling;
+    };
+    typeSpecificAssessment?: {
+        checklist: SkillLlmTypeSpecificChecklistItem[];
+        summary?: string;
+    };
+    /** Kept only so older persisted reports with LLM node verdicts can still be read. */
+    runtimeNodeAssessment?: {
+        summary?: string;
+        nodes: SkillLlmRuntimeNodeAssessment[];
+    };
+    runtimeNodeResults?: {
+        summary?: string;
+        nodes: RuntimeNodeResult[];
+    };
+    userExperienceSignals?: {
+        useful?: LlmEnhancedVerdict;
+        followUp?: LlmEnhancedVerdict;
+        correction?: LlmEnhancedVerdict;
+        negativeFeedback?: LlmEnhancedVerdict;
+        interruption?: LlmEnhancedVerdict;
+        frustration?: LlmEnhancedVerdict;
+    };
+    reviewerSummary?: string;
+    ownerSuggestions?: Array<{
+        title?: string;
+        body?: string;
+        evidence?: string[];
+        acceptanceCriteria?: string;
+        checklistItemKey?: string;
+    }>;
+}
+export type ResolvedSkillStandardSource = 'frontmatter' | 'confirmed_soft' | 'pending_soft';
+export type ResolvedSkillStandardKind = 'hard_rule' | 'workflow';
+export interface ResolvedSkillStandard {
+    id: string;
+    kind: ResolvedSkillStandardKind;
+    title: string;
+    body: string;
+    source: ResolvedSkillStandardSource;
+    status?: SkillDerivedStandardStatus;
+    confidence?: SkillDerivedStandard['confidence'];
+    evidence?: string[];
+}
+export interface ResolvedSkillStandards {
+    skillName: string;
+    active: ResolvedSkillStandard[];
+    candidates: ResolvedSkillStandard[];
+    sourcePriority: ['frontmatter', 'confirmed_soft', 'pending_soft'];
+}
+export interface ExtractSkillSoftStandardsOptions {
+    observationsDir: string;
+    skillChain: ObservationSkillChain;
+    runtimeEvidence?: SkillLlmEnhancedRuntimeEvidence;
+    model?: string;
+    executorName?: string;
+    refresh?: boolean;
+    now?: string;
+    executor?: ExecutorFn;
+}
+export interface ResolveSkillStandardsOptions {
+    observationsDir: string;
+    cwd?: string;
+    skillChain?: ObservationSkillChain;
+    derivedStandards?: SkillDerivedStandards | Record<string, SkillDerivedStandards>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/observability/soft-standards/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/observability/soft-standards/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAE5F,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,UAAU,GAAG,OAAO,CAAC;AACtG,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,0BAA0B,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iCAAiC,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,uBAAuB,CAAC;IACzC,aAAa,EAAE,OAAO,4BAA4B,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,8BAA8B,CAAC;IAChD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;CACrD;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAAC;AACpH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjE,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AACxF,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACzG,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;AACpG,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,CAAC;AACjB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtG,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAC3F,MAAM,MAAM,yBAAyB,GACjC,WAAW,GACX,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,EAAE,CAAC,EAAE,eAAe,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;IAC5F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,yBAAyB,CAAC;CACxC;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,CAAC;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,EAAE,6BAA6B,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC7C,YAAY,EAAE,2BAA2B,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,YAAY,EAAE,2BAA2B,EAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iCAAiC;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,GAAG,UAAU,CAAC;IAClC,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,kBAAkB,CAAC,EAAE;QACnB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;QAClF,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;QAClF,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC3F,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;QACzF,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;QACtC,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;QACzC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;QACvC,WAAW,CAAC,EAAE,sBAAsB,CAAC;KACtC,CAAC;IACF,sBAAsB,CAAC,EAAE;QACvB,SAAS,EAAE,iCAAiC,EAAE,CAAC;QAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qFAAqF;IACrF,qBAAqB,CAAC,EAAE;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,6BAA6B,EAAE,CAAC;KACxC,CAAC;IACF,kBAAkB,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;IACF,qBAAqB,CAAC,EAAE;QACtB,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAC9B,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAChC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;QACtC,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClC,WAAW,CAAC,EAAE,kBAAkB,CAAC;KAClC,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,2BAA2B,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAC5F,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,2BAA2B,CAAC;IACpC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,UAAU,CAAC,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,cAAc,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,CAAC,EAAE,+BAA+B,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAClF"}

package/dist/observability/soft-standards/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/observability/soft-standards/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/observability/soft-standards/types.ts"],"names":[],"mappings":""}

package/dist/observability/text-signals.d.ts

@@ -0,0 +1,14 @@
+export declare const HARD_RULE_TEXT_RE: RegExp;
+export declare const ASSISTANT_DELIVERABLE_ARTIFACT_RE: RegExp;
+export declare function isRuntimeProtocolPromptText(value: string): boolean;
+export declare function isScheduledTaskPromptText(value: string): boolean;
+export declare function isAssistantProtocolReplyText(value: string): boolean;
+export declare function isWorkflowSystemUserMessageText(value: string): boolean;
+export declare function isSyntheticUserMessageText(value: string): boolean;
+export declare function isUserInteractionMetricText(value: string): boolean;
+export declare function hasUserHardRuleText(value: string): boolean;
+export declare function isAssistantProgressUpdateText(value: string): boolean;
+export declare function hasAssistantDeliverySignalText(value: string): boolean;
+export declare function hasAssistantDeliverableArtifactText(value: string): boolean;
+export declare function isToolResultFailureText(value: unknown): boolean;
+//# sourceMappingURL=text-signals.d.ts.map

package/dist/observability/text-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-signals.d.ts","sourceRoot":"","sources":["../../src/observability/text-signals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAA8C,CAAC;AAgC7E,eAAO,MAAM,iCAAiC,QAC2W,CAAC;AAE1Z,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW/D"}

package/dist/observability/text-signals.js

@@ -0,0 +1,116 @@
+export const HARD_RULE_TEXT_RE = /hard rules?|必须|不要|禁止|严格|一定要|务必|不得|不能|只允许/i;
+const RUNTIME_PROTOCOL_PROMPT_RE = /你在看一个\s+[\w.-]+\s+后台任务|根据日志写一条进展消息发给用户|不要执行日志里的任务|::FORWARD-OK::|instruction\s*:\s*直接转发[，,]?\s*不要回答|\[OpenClaw\s+heartbeat\s+poll\]|\[Queued messages while agent was busy\]/i;
+const SCHEDULED_TASK_PROMPT_RE = /^\s*\[cron:[^\]]+\]/i;
+// 要求整条消息就是协议词(允许少量空白/尾标点),不要只匹前缀。
+// 旧形态 `(?:\s|\n|$)` 让 "OK 我来帮你查一下" / "ACK 已收到任务" 这类
+// 中文对话开头被错分类为协议消息,把真实的 assistantDeliverySignal 屏蔽掉,
+// 系统性低估 final_delivery_absent 等测量信号。
+const ASSISTANT_PROTOCOL_REPLY_RE = /^\s*(?:HEARTBEAT_OK|HEARTBEAT|PING_OK|PONG|ACK|OK|::FORWARD-OK::)\s*[.!]?\s*$/i;
+const BUSINESS_ACTION_TAG_NAME_RE = /[a-z][\w.-]*-cmd/i;
+const BUSINESS_ACTION_BLOCK_RE = /<([a-z][\w.-]*-cmd)\b[^>]*>[\s\S]*?<\/\1>|<[a-z][\w.-]*-cmd\b[^>]*\/>/gi;
+const SYNTHETIC_USER_MESSAGE_PREFIX_RE = /^\s*【(?:用户上传产物|上传产物|附件|产物|系统补充|系统生成|回放补充|trace\s*后处理|Trace\s*后处理)[^】]*】/i;
+const SYNTHETIC_USER_MESSAGE_META_RE = /\b(?:artifact_id|artifactId|file_id|fileId|version)\b|用户手动上传|上传了.+文件/i;
+const ASSISTANT_DELIVERY_SIGNAL_RE = /```(?:mermaid|plantuml|json|tsx?|jsx?|html|css|excalidraw|markdown)?|直接生成|已生成|生成如下|结果如下|如下|完成|已完成|这里是|给出|输出/i;
+const ASSISTANT_PROGRESS_UPDATE_RE = /已发送进展|进展消息|进度更新|状态更新|正在|仍在|继续|处理中|整理中|分析中|生成中|执行中|采集中|获取中|即将|预计|稍后|子\s*Claude|后台任务/i;
+const ASSISTANT_FINAL_DELIVERY_RE = /最终结果|最终报告|完整结果|完整报告|结果如下|报告如下|已完成[，,。:：]\s*(?:结果|报告|如下)|(?:任务|方案|文档|报告|demo|代码|页面)?已完成\s*(?:✅|[，,。:：]\s*(?:方案路径|产物路径|文档路径|结果|报告|如下))|(?:方案路径|产物路径|文档路径|结果文件|输出路径)\s*[:：]/i;
+export const ASSISTANT_DELIVERABLE_ARTIFACT_RE = /```(?:mermaid|plantuml|json|tsx?|jsx?|html|css|excalidraw|markdown)?|https?:\/\/\S+|(?:文档|报告|方案|demo|Demo|预览|产物|文件|页面|dashboard|看板)(?:链接|地址|路径|URL)|(?:已生成|已创建|已写入|已保存|上传).{0,16}(?:文件|文档|报告|页面|demo|Demo|dashboard|看板|产物)|(?:^|[\s"'`(])(?:\/[\w.-]+){2,}\.(?:md|html|tsx?|jsx?|json|png|jpe?g|pdf|docx?|pptx?|xlsx?|csv)\b|(?:^|[\s"'`(])[\w.-]+\.(?:md|html|tsx?|jsx?|json|png|jpe?g|pdf|docx?|pptx?|xlsx?|csv)\b/i;
+export function isRuntimeProtocolPromptText(value) {
+    return RUNTIME_PROTOCOL_PROMPT_RE.test(value);
+}
+export function isScheduledTaskPromptText(value) {
+    return SCHEDULED_TASK_PROMPT_RE.test(value);
+}
+export function isAssistantProtocolReplyText(value) {
+    const normalized = value.trim();
+    if (!normalized)
+        return false;
+    return ASSISTANT_PROTOCOL_REPLY_RE.test(normalized);
+}
+export function isWorkflowSystemUserMessageText(value) {
+    const stripped = value.replace(BUSINESS_ACTION_BLOCK_RE, '').trim();
+    return stripped.length === 0 && new RegExp(`<${BUSINESS_ACTION_TAG_NAME_RE.source}\\b`, 'i').test(value);
+}
+export function isSyntheticUserMessageText(value) {
+    return isRuntimeProtocolPromptText(value)
+        || isWorkflowSystemUserMessageText(value)
+        || SYNTHETIC_USER_MESSAGE_PREFIX_RE.test(value)
+        || (/^\s*【[^】]+】/.test(value) && SYNTHETIC_USER_MESSAGE_META_RE.test(value));
+}
+export function isUserInteractionMetricText(value) {
+    return !isScheduledTaskPromptText(value) && !isSyntheticUserMessageText(value);
+}
+export function hasUserHardRuleText(value) {
+    if (isRuntimeProtocolPromptText(value) || !isUserInteractionMetricText(value))
+        return false;
+    if (/hard rules?/i.test(value))
+        return true;
+    if (/必须|严格|一定要|务必|不得|只允许/i.test(value))
+        return true;
+    if (/(?:不要|禁止)(?:省略|遗漏|改动|修改|执行|输出|使用|调用|生成|删除|跳过|猜|编|问|返回|展示|写入|覆盖|提交|发布|发送|回复)/i.test(value))
+        return true;
+    if (/不能(?:省略|遗漏|改动|修改|执行|输出|使用|调用|生成|删除|跳过|猜|编|问|返回|展示|写入|覆盖|提交|发布|发送|回复)/i.test(value))
+        return true;
+    return false;
+}
+export function isAssistantProgressUpdateText(value) {
+    return ASSISTANT_PROGRESS_UPDATE_RE.test(value) && !ASSISTANT_FINAL_DELIVERY_RE.test(value);
+}
+export function hasAssistantDeliverySignalText(value) {
+    return ASSISTANT_FINAL_DELIVERY_RE.test(value)
+        || (ASSISTANT_DELIVERY_SIGNAL_RE.test(value) && !isAssistantProgressUpdateText(value));
+}
+export function hasAssistantDeliverableArtifactText(value) {
+    return ASSISTANT_DELIVERABLE_ARTIFACT_RE.test(value);
+}
+export function isToolResultFailureText(value) {
+    if (toolResultFailureJson(value))
+        return true;
+    const text = typeof value === 'string'
+        ? value
+        : value === null || value === undefined
+            ? ''
+            : typeof value === 'object'
+                ? JSON.stringify(value)
+                : String(value);
+    return /(?:^|\b)(?:status|state)\s*[:=]\s*["']?(?:error|failed|failure)["']?/i.test(text)
+        || /\berror\s*[:=]\s*(?!false|null|0\b).+/i.test(text);
+}
+function toolResultFailureJson(value) {
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    if (value && typeof value === 'object')
+        return containsToolFailureSignal(value, 0);
+    if (!trimmed || (!trimmed.startsWith('{') && !trimmed.startsWith('[')))
+        return false;
+    try {
+        return containsToolFailureSignal(JSON.parse(trimmed), 0);
+    }
+    catch {
+        return false;
+    }
+}
+function containsToolFailureSignal(value, depth) {
+    if (depth > 5 || value === null || value === undefined)
+        return false;
+    if (typeof value === 'string')
+        return toolResultFailureJson(value);
+    if (typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return value.some((item) => containsToolFailureSignal(item, depth + 1));
+    const record = value;
+    for (const [key, raw] of Object.entries(record)) {
+        const normalizedKey = key.toLowerCase();
+        if ((normalizedKey === 'status' || normalizedKey === 'state') && typeof raw === 'string' && /^(error|failed|failure)$/i.test(raw.trim()))
+            return true;
+        if ((normalizedKey === 'iserror' || normalizedKey === 'is_error') && raw === true)
+            return true;
+        if (normalizedKey === 'success' && raw === false)
+            return true;
+        if (normalizedKey === 'error' && raw !== false && raw !== null && raw !== undefined && raw !== '')
+            return true;
+        if ((normalizedKey === 'body' || normalizedKey === 'result' || normalizedKey === 'data') && containsToolFailureSignal(raw, depth + 1))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=text-signals.js.map

package/dist/observability/text-signals.js.map

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

package/dist/observability/trace-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-adapter.d.ts","sourceRoot":"","sources":["../../src/observability/trace-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElG,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAKjI"}

package/dist/observability/trace-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-adapter.js","sourceRoot":"","sources":["../../src/observability/trace-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAkB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAqB,MAAM,sBAAsB,CAAC;AAWlG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC"}

package/dist/observability/trace-attribution.d.ts

@@ -0,0 +1,56 @@
+/** Skill attribution rules for trace records. */
+import type { CcAssistantRecord, CcUserRecord } from './trace-source.js';
+export interface SkillRef {
+    skillName: string;
+    rawSkillRef: string;
+    pluginName?: string;
+}
+export declare function extractMarkdownLogSkill(text: string): string | null;
+/**
+ * 归一化 skill 名: 去掉 plugin 前缀, 过滤 cc 内置命令。
+ * - "impeccable:audit" → "audit"
+ * - "pbakaus/impeccable:audit" → "audit"
+ * - "clear" / "exit" 等 → null(表示不是 skill)
+ */
+export declare function normalizeSkillName(raw: string): string | null;
+export declare function parseSkillRef(raw: string): SkillRef | null;
+export declare function stripCommandEnvelopeText(text: string): string;
+export declare function extractCommandEnvelopeText(text: string): string | null;
+/**
+ * 从 user message 里提取 slash-command skill 名字(信号 2)。
+ * 返回 null 表示没命中。
+ */
+export declare function extractCommandSkill(record: CcUserRecord): string | null;
+export declare function extractCommandSkillRef(record: CcUserRecord): SkillRef | null;
+/**
+ * 从 OpenClaw user message 的业务动作标签里提取 skill 名字(信号 4)。
+ *
+ * 注意: 真实 OpenClaw 数据里 name 可能是业务动作展示名, 不是稳定 skill id。
+ * 只有 name 本身像 "prd-create" 这种 slug 时才用于 skill 归因;
+ * 展示名继续保留在 sourceMetadata.businessActions 里, 不切 skill。
+ */
+export declare function extractBusinessActionSkillRef(record: CcUserRecord): SkillRef | null;
+/**
+ * 从 assistant message 的 tool_use 里提取 Skill tool 调用的 skill 名字(信号 1)。
+ * 返回 null 表示没命中。
+ */
+export declare function extractSkillToolUse(record: CcAssistantRecord): string | null;
+export declare function extractSkillToolUseRef(record: CcAssistantRecord): SkillRef | null;
+export declare function extractAttributionSkill(record: CcAssistantRecord): string | null;
+export declare function extractAttributionSkillRef(record: CcAssistantRecord): SkillRef | null;
+/**
+ * 从 assistant message 的 Read tool_use 里提取 skill 名字(信号 3, fallback)。
+ * 匹配 file_path 形如 ".claude/skills/<name>/SKILL.md"
+ * 或 ".openclaw/workspace/skills/<name>/SKILL.md" 的模式。
+ * 返回 null 表示没命中。
+ */
+export declare function extractSkillReadFile(record: CcAssistantRecord): string | null;
+export declare function extractSkillReadFileRef(record: CcAssistantRecord): SkillRef | null;
+/**
+ * 从 OpenClaw cron/user 文本或 Bash/exec tool command 里提取 skill 脚本路径。
+ *
+ * cron 型 OpenClaw session 通常没有业务动作标签或 Skill tool_use,
+ * 只会直接执行 ~/.openclaw/workspace-main/skills/<skill>/scripts/*.sh。
+ */
+export declare function extractSkillScriptCommandRef(record: CcUserRecord | CcAssistantRecord): SkillRef | null;
+//# sourceMappingURL=trace-attribution.d.ts.map

package/dist/observability/trace-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-attribution.d.ts","sourceRoot":"","sources":["../../src/observability/trace-attribution.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIzE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenE;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAa1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAenF;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CASjF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAErF;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAYlF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAoBtG"}