@sigloch/graphcode-client 0.5.0 → 0.7.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/dist/view-catalog.d.ts

@@ -15,8 +15,14 @@
  *
  * @author andreas@siglochconsulting
  */
-/** All supported views, in deterministic order. */
-export declare const MARKDOWN_VIEWS: readonly ["spec", "architecture", "cr-list", "references", "srs", "nfr", "rtm", "icd", "testconcept", "testmatrix", "intplan", "changelog", "fmea", "conops", "trade", "implplan"];
+/**
+ * All supported views, in deterministic order.
+ *
+ * CR-GC-305 removed `spec` (0.7.0, breaking): it was a raw dump of every element
+ * grouped by type and answered the same question as `srs` (the ISO-29148 narrative)
+ * with different completeness — two requirements documents, one truth. `srs` stays.
+ */
+export declare const MARKDOWN_VIEWS: readonly ["architecture", "cr-list", "references", "srs", "nfr", "rtm", "icd", "testconcept", "testmatrix", "intplan", "changelog", "fmea", "conops", "trade", "implplan"];
 export type MarkdownView = (typeof MARKDOWN_VIEWS)[number];
 /** Default file name for each view (under docs/views/). */
 export declare const VIEW_FILENAMES: Record<MarkdownView, string>;

package/dist/view-catalog.js

@@ -15,10 +15,15 @@
  *
  * @author andreas@siglochconsulting
  */
-/** All supported views, in deterministic order. */
+/**
+ * All supported views, in deterministic order.
+ *
+ * CR-GC-305 removed `spec` (0.7.0, breaking): it was a raw dump of every element
+ * grouped by type and answered the same question as `srs` (the ISO-29148 narrative)
+ * with different completeness — two requirements documents, one truth. `srs` stays.
+ */
 export const MARKDOWN_VIEWS = [
     // foundation (CR-GC-113)
-    'spec',
     'architecture',
     'cr-list',
     'references',
@@ -38,7 +43,6 @@ export const MARKDOWN_VIEWS = [
 ];
 /** Default file name for each view (under docs/views/). */
 export const VIEW_FILENAMES = {
-    spec: 'spec.md',
     architecture: 'architecture.md',
     'cr-list': 'cr-list.md',
     references: 'references.md',

package/package.json

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