@armoriq/sdk-dev 0.7.0 → 0.8.1

package/dist/observability/trace-summary.js

@@ -1,108 +0,0 @@
-"use strict";
-/**
- * Trace-level tag/output-summary derivation.
- *
- * A trace's own `tags`/`attributes.output` are never populated by callers
- * today (every chokepoint only passes freeform `attributes` at
- * `startTrace()` time, before any child span exists) — so without this
- * module every trace ships with `tags: []` and no output summary, even
- * though the information needed to compute both already lives on the
- * trace's own spans by the time `endTrace()` runs.
- *
- * This is intentionally derived, not caller-supplied: it's computed once,
- * in one place (`ObservabilityRecorder.endTrace`), from the same in-memory
- * `spans` array the recorder already holds — no new public API surface,
- * no risk of callers drifting from each other's tagging conventions.
- *
- * Kept deliberately conservative and low-cardinality (per the dashboard's
- * TAGS column contract): product + distinct tool names + one decision
- * verdict, nothing free-text or unbounded.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deriveTraceSummary = deriveTraceSummary;
-const MAX_TOOL_TAGS = 8;
-function isPolicyCallAttributes(attrs) {
-    return attrs.kind === 'policy_call';
-}
-/**
- * Distinct tool names referenced by any span on the trace. Reads
- * `attributes.toolName` off `kind: 'span'` container spans (the shape
- * `iap.check`/`tool.report`/generic tool spans use) — this covers every
- * known emitter without needing parent/child span-kind coupling.
- */
-function collectToolNames(spans) {
-    const names = new Set();
-    for (const span of spans) {
-        const toolName = span.attributes.toolName;
-        if (typeof toolName === 'string' && toolName.length > 0) {
-            names.add(toolName);
-        }
-    }
-    return Array.from(names).slice(0, MAX_TOOL_TAGS);
-}
-function collectDecisionCounts(spans) {
-    const counts = { allow: 0, deny: 0, other: 0, total: 0 };
-    for (const span of spans) {
-        if (!isPolicyCallAttributes(span.attributes))
-            continue;
-        counts.total += 1;
-        if (span.attributes.decision === 'allow')
-            counts.allow += 1;
-        else if (span.attributes.decision === 'deny')
-            counts.deny += 1;
-        else
-            counts.other += 1;
-    }
-    return counts;
-}
-/** Overall verdict tag for the trace: 'allowed' | 'blocked' | 'mixed'. */
-function decisionVerdict(counts) {
-    if (counts.total === 0)
-        return null;
-    if (counts.deny > 0 && counts.deny < counts.total)
-        return 'mixed';
-    if (counts.deny === counts.total)
-        return 'blocked';
-    if (counts.other > 0)
-        return 'mixed';
-    return 'allowed';
-}
-/** Concise, non-sensitive outcome summary, e.g. "5 checks · all allowed". */
-function outputSummary(counts) {
-    if (counts.total === 0)
-        return null;
-    const noun = counts.total === 1 ? 'check' : 'checks';
-    if (counts.deny === 0 && counts.other === 0) {
-        return `${counts.total} ${noun} · all allowed`;
-    }
-    if (counts.deny === counts.total) {
-        return `${counts.total} ${noun} · all blocked`;
-    }
-    const parts = [];
-    if (counts.deny > 0)
-        parts.push(`${counts.deny} blocked`);
-    if (counts.other > 0)
-        parts.push(`${counts.other} pending`);
-    return `${counts.total} ${noun} · ${parts.join(', ')}`;
-}
-/**
- * Derive `{ tags, output }` for a trace from its accumulated spans. Pure
- * and read-only — never mutates `spans`. Callers merge the result onto the
- * trace record themselves (see `ObservabilityRecorder.endTrace`), preserving
- * any tags/output the caller already set explicitly.
- */
-function deriveTraceSummary(spans, product) {
-    const tags = [];
-    if (product)
-        tags.push(product);
-    tags.push(...collectToolNames(spans));
-    const counts = collectDecisionCounts(spans);
-    const verdict = decisionVerdict(counts);
-    if (verdict)
-        tags.push(verdict);
-    return {
-        tags,
-        output: outputSummary(counts),
-    };
-}
-//# sourceMappingURL=trace-summary.js.map

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

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