spine-framework 0.3.124 → 0.3.126

package/.framework/functions/_shared/outcomes.ts

@@ -0,0 +1,36 @@
+// CIL[BEGIN chunk_id="outcomes_moduleheader_1785012346" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Emit business outcome events into the runtime evidence store"]
+// CIL[DOC-RESPONSIBILITY responsibility="Record whether a user-intent-level operation succeeded, failed, or partially succeeded"]
+// CIL[DOC-CONTEXT module="_shared.outcomes" layer="infrastructure" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="ctx: CoreContext, intent: string, result: string, metadata?: object" outputs="Promise<void>" errors="none" side_effects="DB write to logs"]
+// CIL[DOC-MICRO logic_summary="Thin wrapper around emitAudit that tags rows with event_category='business_outcome' and outcome result" notable_decisions=["Outcomes share the trace/span context of the current operation"] ]
+// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="experimental"]
+// CIL[DOC-AUDIENCE audience="developer"]
+import { CoreContext } from './middleware'
+import { emitAudit } from './audit'
+// CIL[END chunk_id="outcomes_moduleheader_1785012346"]
+// CIL[BEGIN chunk_id="outcomes_emitoutcome_1785012346" type="function" identity="emitOutcome" parent="outcomes_moduleheader_1785012346"]
+// CIL[DOC-MACRO purpose="Emit a business outcome event for a completed operation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Tag a span/log row with outcome result and intent-level metadata"]
+// CIL[DOC-CONTEXT module="_shared.outcomes" layer="infrastructure" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="ctx: CoreContext, intent: string, result: string, metadata?: object" outputs="Promise<void>" errors="none" side_effects="DB write to logs"]
+// CIL[DOC-MICRO logic_summary="Calls emitAudit with outcome result and optional extra metadata" notable_decisions=["Shares trace/span context of current operation"] ]
+// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="experimental"]
+
+export async function emitOutcome(
+  ctx: CoreContext,
+  intent: string,
+  result: 'success' | 'failure' | 'partial',
+  metadata: Record<string, any> = {}
+): Promise<void> {
+  await emitAudit(ctx, intent, {
+    type: 'outcome',
+    account_id: ctx.accountId ?? undefined
+  }, {
+    result,
+    ...metadata
+  })
+}
+// CIL[END chunk_id="outcomes_emitoutcome_1785012346"]