@sigloch/graphcode-client 0.5.0 → 0.6.0

package/dist/panels.d.ts

@@ -16,6 +16,7 @@
  */
 import type { ReadinessReport, ReadinessGate, CreationCurrency, CreationCurrencyProvider } from './readiness.js';
 import type { RuleViolation, LiveUpdateEvent } from '@sigloch/contracts/harness';
+import type { Graph } from '@sigloch/graph-api-core';
 export interface GatePanel {
     id: string;
     label: string;
@@ -125,6 +126,23 @@ export declare function creationCurrencyProvider(analysis: Array<{
     id: string;
     currency: CreationCurrency;
 }>): CreationCurrencyProvider;
+/**
+ * Real scope-currency for the 5 analysis artifacts (CR-SM-227) — replaces the
+ * `ABSENT_CREATION_PROVIDER` placeholder (CR-GVE-225 F10: GVE showed `absent`
+ * correctly because no scope-currency check existed yet). Reads the
+ * `graphVersion` freshness stamp AF-01..05 (contracts) check for presence of
+ * (`SYS.attributes.analysisFreshness.<id>`) and classifies it against the
+ * live graphVersion: missing/invalid stamp → absent; stamp older than the
+ * current graphVersion → stale; stamp at (or ahead of) it → current.
+ * Grober Graph-Versions-Stempel only, no scope-hash — CR-SM-227's declared
+ * first-cut limitation ("Achtung" section), not full scope-precise staleness.
+ */
+export declare function computeAnalysisCurrency(graph: Pick<Graph, 'nodes'>, currentGraphVersion: number): Array<{
+    id: string;
+    currency: CreationCurrency;
+}>;
+/** Convenience: build the real CreationCurrencyProvider straight off the graph + its live version. */
+export declare function analysisCreationCurrencyProvider(graph: Pick<Graph, 'nodes'>, currentGraphVersion: number): CreationCurrencyProvider;
 export interface ImpactPanel {
     root: string;
     blastRadiusNodes: number;

package/dist/panels.js

@@ -1,3 +1,4 @@
+import { AnalysisArtifactId, AnalysisFreshnessStampSchema } from '@sigloch/contracts/se';
 function toGatePanel(g) {
     return { id: g.id, label: g.label, passed: g.passed, score: g.score, blocking: g.blocking, completeness: g.completeness };
 }
@@ -94,6 +95,34 @@ export function creationCurrencyProvider(analysis) {
     const m = new Map(analysis.map((a) => [a.id, a.currency]));
     return (creation) => m.get(creation) ?? 'absent';
 }
+/**
+ * Real scope-currency for the 5 analysis artifacts (CR-SM-227) — replaces the
+ * `ABSENT_CREATION_PROVIDER` placeholder (CR-GVE-225 F10: GVE showed `absent`
+ * correctly because no scope-currency check existed yet). Reads the
+ * `graphVersion` freshness stamp AF-01..05 (contracts) check for presence of
+ * (`SYS.attributes.analysisFreshness.<id>`) and classifies it against the
+ * live graphVersion: missing/invalid stamp → absent; stamp older than the
+ * current graphVersion → stale; stamp at (or ahead of) it → current.
+ * Grober Graph-Versions-Stempel only, no scope-hash — CR-SM-227's declared
+ * first-cut limitation ("Achtung" section), not full scope-precise staleness.
+ */
+export function computeAnalysisCurrency(graph, currentGraphVersion) {
+    const sys = graph.nodes.find((n) => n.type === 'SYS');
+    const stamps = (sys?.attributes?.analysisFreshness ?? {});
+    return AnalysisArtifactId.options.map((id) => {
+        const parsed = AnalysisFreshnessStampSchema.safeParse(stamps[id]);
+        const currency = !parsed.success
+            ? 'absent'
+            : parsed.data.graphVersion >= currentGraphVersion
+                ? 'current'
+                : 'stale';
+        return { id, currency };
+    });
+}
+/** Convenience: build the real CreationCurrencyProvider straight off the graph + its live version. */
+export function analysisCreationCurrencyProvider(graph, currentGraphVersion) {
+    return creationCurrencyProvider(computeAnalysisCurrency(graph, currentGraphVersion));
+}
 export function impactPanel(impact) {
     return { root: impact.rootId, blastRadiusNodes: impact.nodeCount, blastRadiusEdges: impact.edgeCount };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigloch/graphcode-client",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",