@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/types/graph-canvas.d.ts

@@ -0,0 +1,109 @@
+/**
+ * MS-07 #750 - GraphCanvas primitive SSOT shapes (nodes/edges fed by callers).
+ */
+import { z } from "zod";
+export declare const GraphCanvasNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    /** Optional deterministic rows rendered in the detail pane. */
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    type?: string | undefined;
+    status?: string | undefined;
+    attributes?: Record<string, string> | undefined;
+}, {
+    id: string;
+    label: string;
+    type?: string | undefined;
+    status?: string | undefined;
+    attributes?: Record<string, string> | undefined;
+}>;
+export type GraphCanvasNode = z.infer<typeof GraphCanvasNodeSchema>;
+export declare const GraphCanvasEdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    target: z.ZodString;
+    relation: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    source: string;
+    target: string;
+    relation?: string | undefined;
+}, {
+    id: string;
+    source: string;
+    target: string;
+    relation?: string | undefined;
+}>;
+export type GraphCanvasEdge = z.infer<typeof GraphCanvasEdgeSchema>;
+export declare const GraphCanvasDataSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        /** Optional deterministic rows rendered in the detail pane. */
+        attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        type?: string | undefined;
+        status?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }, {
+        id: string;
+        label: string;
+        type?: string | undefined;
+        status?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodString;
+        target: z.ZodString;
+        relation: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        source: string;
+        target: string;
+        relation?: string | undefined;
+    }, {
+        id: string;
+        source: string;
+        target: string;
+        relation?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        id: string;
+        label: string;
+        type?: string | undefined;
+        status?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }[];
+    edges: {
+        id: string;
+        source: string;
+        target: string;
+        relation?: string | undefined;
+    }[];
+}, {
+    nodes: {
+        id: string;
+        label: string;
+        type?: string | undefined;
+        status?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }[];
+    edges: {
+        id: string;
+        source: string;
+        target: string;
+        relation?: string | undefined;
+    }[];
+}>;
+export type GraphCanvasData = z.infer<typeof GraphCanvasDataSchema>;

package/dist/types/graph-canvas.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphCanvasDataSchema = exports.GraphCanvasEdgeSchema = exports.GraphCanvasNodeSchema = void 0;
+/**
+ * MS-07 #750 - GraphCanvas primitive SSOT shapes (nodes/edges fed by callers).
+ */
+const zod_1 = require("zod");
+exports.GraphCanvasNodeSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    label: zod_1.z.string(),
+    type: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    /** Optional deterministic rows rendered in the detail pane. */
+    attributes: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+});
+exports.GraphCanvasEdgeSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    source: zod_1.z.string(),
+    target: zod_1.z.string(),
+    relation: zod_1.z.string().optional(),
+});
+exports.GraphCanvasDataSchema = zod_1.z.object({
+    nodes: zod_1.z.array(exports.GraphCanvasNodeSchema),
+    edges: zod_1.z.array(exports.GraphCanvasEdgeSchema),
+});

package/dist/types/graph-question-mapping.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MS-07 #757 - Command Center / Copilot NL graph questions.
+ * Intent descriptors are mapping-only: no I/O, no generated query text.
+ */
+/** Seven operator-focused graph intents (fixed catalog). */
+export declare const GRAPH_QUESTION_SUPPORTED_INTENTS: readonly ["missing_requirement_coverage", "routes_without_clients", "api_endpoints_without_db_evidence", "tables_lacking_rls_evidence", "tasks_without_prs", "current_deployment_findings", "high_risk_drift_security_nodes"];
+export type GraphQuestionSupportedIntent = (typeof GRAPH_QUESTION_SUPPORTED_INTENTS)[number];
+/** Keys of `GRAPH_ROUTES` that are POST JSON graph query endpoints (string literals only). */
+export declare const GRAPH_POST_QUERY_ROUTE_KEYS: readonly ["queryRequirementCoverage", "queryRouteTruth", "queryDriftForFile"];
+export type GraphPostQueryRouteKey = (typeof GRAPH_POST_QUERY_ROUTE_KEYS)[number];
+/**
+ * Stable ids aligned with `packages/frontend/src/app/projects/[id]/graph/page.tsx` view components.
+ * Callers may map these to scroll targets or deep links.
+ */
+export declare const GRAPH_UI_VIEW_SURFACES: readonly ["requirementCoverageMap", "routeMap", "dbRlsSchema", "deploymentLineage", "securityRisk", "driftRisk", "taskPr"];
+export type GraphUiViewSurface = (typeof GRAPH_UI_VIEW_SURFACES)[number];
+export type GraphQuestionSupportedResult = {
+    readonly kind: "supported";
+    readonly intentId: GraphQuestionSupportedIntent;
+    /** Human-readable label for UI (not an answer). */
+    readonly label: string;
+    /** POST graph query routes applicable via `GRAPH_ROUTES` + `apiClient.graph` (may be empty). */
+    readonly postQueryRouteKeys: readonly GraphPostQueryRouteKey[];
+    /** Project graph page view surfaces; resolve `PAGE_ROUTES.projectGraph(projectId)` in the shell. */
+    readonly uiViewSurfaces: readonly GraphUiViewSurface[];
+};
+export type GraphQuestionUnsupportedResult = {
+    readonly kind: "unsupported";
+    /** Static reason code; no user answer text. */
+    readonly reason: "no_match" | "empty_input" | "ambiguous";
+    readonly detail: string;
+};
+export type GraphQuestionMapResult = GraphQuestionSupportedResult | GraphQuestionUnsupportedResult;

package/dist/types/graph-question-mapping.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * MS-07 #757 - Command Center / Copilot NL graph questions.
+ * Intent descriptors are mapping-only: no I/O, no generated query text.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRAPH_UI_VIEW_SURFACES = exports.GRAPH_POST_QUERY_ROUTE_KEYS = exports.GRAPH_QUESTION_SUPPORTED_INTENTS = void 0;
+/** Seven operator-focused graph intents (fixed catalog). */
+exports.GRAPH_QUESTION_SUPPORTED_INTENTS = [
+    "missing_requirement_coverage",
+    "routes_without_clients",
+    "api_endpoints_without_db_evidence",
+    "tables_lacking_rls_evidence",
+    "tasks_without_prs",
+    "current_deployment_findings",
+    "high_risk_drift_security_nodes",
+];
+/** Keys of `GRAPH_ROUTES` that are POST JSON graph query endpoints (string literals only). */
+exports.GRAPH_POST_QUERY_ROUTE_KEYS = [
+    "queryRequirementCoverage",
+    "queryRouteTruth",
+    "queryDriftForFile",
+];
+/**
+ * Stable ids aligned with `packages/frontend/src/app/projects/[id]/graph/page.tsx` view components.
+ * Callers may map these to scroll targets or deep links.
+ */
+exports.GRAPH_UI_VIEW_SURFACES = [
+    "requirementCoverageMap",
+    "routeMap",
+    "dbRlsSchema",
+    "deploymentLineage",
+    "securityRisk",
+    "driftRisk",
+    "taskPr",
+];