@rapidhuman/graph-common 1.0.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB;AACzB,kDAAgC;AAChC,2CAAyB;AACzB,6CAA2B"}

package/dist/relationships/helpers.d.ts

@@ -0,0 +1,23 @@
+import { CrossSolutionRelationship, InternalEdgeType, RelationshipDirection } from './types';
+/**
+ * Type guard that checks if a string is a valid CrossSolutionRelationship.
+ *
+ * @param type - String to check
+ * @returns True if the string is a valid CrossSolutionRelationship
+ */
+export declare function isValidRelationship(type: string): type is CrossSolutionRelationship;
+/**
+ * Type guard that checks if a string is a valid InternalEdgeType.
+ *
+ * @param type - String to check
+ * @returns True if the string is a valid InternalEdgeType
+ */
+export declare function isValidInternalEdge(type: string): type is InternalEdgeType;
+/**
+ * Returns the source and target solution codes for a cross-solution relationship.
+ *
+ * @param rel - Cross-solution relationship type
+ * @returns RelationshipDirection with source and target solution codes
+ */
+export declare function getRelationshipDirection(rel: CrossSolutionRelationship): RelationshipDirection;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/relationships/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/relationships/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAwB7F;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,yBAAyB,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,yBAAyB,GAAG,qBAAqB,CAE9F"}

package/dist/relationships/helpers.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidRelationship = isValidRelationship;
+exports.isValidInternalEdge = isValidInternalEdge;
+exports.getRelationshipDirection = getRelationshipDirection;
+const types_1 = require("./types");
+/** Map of cross-solution relationships to their source → target solution directions */
+const RELATIONSHIP_DIRECTIONS = {
+    [types_1.CrossSolutionRelationship.INFORMED]: { source: 'ideation', target: 'req' },
+    [types_1.CrossSolutionRelationship.CONSTRAINED_BY]: { source: 'req', target: 'arch' },
+    [types_1.CrossSolutionRelationship.SPECIFIED_BY]: { source: 'req', target: 'spec' },
+    [types_1.CrossSolutionRelationship.ARCHITECTED_BY]: { source: 'arch', target: 'spec' },
+    [types_1.CrossSolutionRelationship.IMPLEMENTED_BY]: { source: 'spec', target: 'platform' },
+    [types_1.CrossSolutionRelationship.TESTED_BY]: { source: 'spec', target: 'platform' },
+    [types_1.CrossSolutionRelationship.TRANSFORMATION_INFORMED]: { source: 'transformation', target: 'req' },
+    [types_1.CrossSolutionRelationship.INTEL_INFORMED]: { source: 'intel', target: 'ideation' },
+    [types_1.CrossSolutionRelationship.INTEL_TRANSFORMATION_INFORMED]: { source: 'intel', target: 'transformation' },
+    [types_1.CrossSolutionRelationship.INTEL_REQ_INFORMED]: { source: 'intel', target: 'req' },
+    [types_1.CrossSolutionRelationship.INTEL_ARCH_INFORMED]: { source: 'intel', target: 'arch' },
+    [types_1.CrossSolutionRelationship.CODED_BY]: { source: 'spec', target: 'code' },
+    [types_1.CrossSolutionRelationship.CODE_TESTS]: { source: 'code', target: 'code' },
+    [types_1.CrossSolutionRelationship.CODE_DERIVED_FROM]: { source: 'arch', target: 'code' },
+    [types_1.CrossSolutionRelationship.CODE_SATISFIES]: { source: 'req', target: 'code' },
+};
+const CROSS_SOLUTION_VALUES = new Set(Object.values(types_1.CrossSolutionRelationship));
+const INTERNAL_EDGE_VALUES = new Set(Object.values(types_1.InternalEdgeType));
+/**
+ * Type guard that checks if a string is a valid CrossSolutionRelationship.
+ *
+ * @param type - String to check
+ * @returns True if the string is a valid CrossSolutionRelationship
+ */
+function isValidRelationship(type) {
+    return CROSS_SOLUTION_VALUES.has(type);
+}
+/**
+ * Type guard that checks if a string is a valid InternalEdgeType.
+ *
+ * @param type - String to check
+ * @returns True if the string is a valid InternalEdgeType
+ */
+function isValidInternalEdge(type) {
+    return INTERNAL_EDGE_VALUES.has(type);
+}
+/**
+ * Returns the source and target solution codes for a cross-solution relationship.
+ *
+ * @param rel - Cross-solution relationship type
+ * @returns RelationshipDirection with source and target solution codes
+ */
+function getRelationshipDirection(rel) {
+    return RELATIONSHIP_DIRECTIONS[rel];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/relationships/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/relationships/helpers.ts"],"names":[],"mappings":";;AA8BA,kDAEC;AAQD,kDAEC;AAQD,4DAEC;AApDD,mCAA6F;AAE7F,uFAAuF;AACvF,MAAM,uBAAuB,GAA6D;IACxF,CAAC,iCAAyB,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;IAC3E,CAAC,iCAAyB,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;IAC7E,CAAC,iCAAyB,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;IAC3E,CAAC,iCAAyB,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAC9E,CAAC,iCAAyB,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE;IAClF,CAAC,iCAAyB,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE;IAC7E,CAAC,iCAAyB,CAAC,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE;IAChG,CAAC,iCAAyB,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE;IACnF,CAAC,iCAAyB,CAAC,6BAA6B,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE;IACxG,CAAC,iCAAyB,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;IAClF,CAAC,iCAAyB,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;IACpF,CAAC,iCAAyB,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IACxE,CAAC,iCAAyB,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAC1E,CAAC,iCAAyB,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IACjF,CAAC,iCAAyB,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;CAC9E,CAAC;AAEF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,iCAAyB,CAAC,CAAC,CAAC;AACxF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,wBAAgB,CAAC,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,GAA8B;IACrE,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/relationships/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/relationships/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relationships/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/relationships/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./helpers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/relationships/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/relationships/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,4CAA0B"}

package/dist/relationships/types.d.ts

@@ -0,0 +1,53 @@
+import { SolutionCode } from '../uri/types';
+/** Cross-solution relationship types linking artifacts across the pipeline */
+export declare enum CrossSolutionRelationship {
+    /** Thinking artifact informed a requirement (Ideation → Req) */
+    INFORMED = "INFORMED",
+    /** Requirement constrains architecture (Req → Arch) */
+    CONSTRAINED_BY = "CONSTRAINED_BY",
+    /** Requirement detailed in a spec (Req → Spec) */
+    SPECIFIED_BY = "SPECIFIED_BY",
+    /** Architecture decision shapes a spec (Arch → Spec) */
+    ARCHITECTED_BY = "ARCHITECTED_BY",
+    /** Spec implemented in generated code (Spec → Platform) */
+    IMPLEMENTED_BY = "IMPLEMENTED_BY",
+    /** Spec validated by a test suite (Spec → Platform) */
+    TESTED_BY = "TESTED_BY",
+    /** Transformation artifact informed a requirement (Transformation → Req) */
+    TRANSFORMATION_INFORMED = "TRANSFORMATION_INFORMED",
+    /** Intelligence entity informed an ideation artifact (Intel → Ideation) */
+    INTEL_INFORMED = "INTEL_INFORMED",
+    /** Intelligence entity informed a transformation artifact (Intel → Transformation) */
+    INTEL_TRANSFORMATION_INFORMED = "INTEL_TRANSFORMATION_INFORMED",
+    /** Intelligence entity informed a requirement (Intel → Req) */
+    INTEL_REQ_INFORMED = "INTEL_REQ_INFORMED",
+    /** Intelligence entity informed an architecture artifact (Intel → Arch) */
+    INTEL_ARCH_INFORMED = "INTEL_ARCH_INFORMED",
+    /** Spec implemented by generated code (Spec → Code) */
+    CODED_BY = "CODED_BY",
+    /** Code artifact tests another code artifact (Code → Code) */
+    CODE_TESTS = "CODE_TESTS",
+    /** Code module derived from architecture component (Arch → Code) */
+    CODE_DERIVED_FROM = "CODE_DERIVED_FROM",
+    /** Code artifact satisfies a requirement (Req → Code) */
+    CODE_SATISFIES = "CODE_SATISFIES"
+}
+/** Internal edge types within a solution-local graph */
+export declare enum InternalEdgeType {
+    /** Intra-solution dependency between artifacts */
+    DEPENDS_ON = "DEPENDS_ON",
+    /** Links artifact to its vector embedding chunks */
+    HAS_EMBEDDING = "HAS_EMBEDDING",
+    /** Version history chain for an artifact */
+    HAS_VERSION = "HAS_VERSION",
+    /** Parent-child containment (e.g., Feature → Screen) */
+    CONTAINS = "CONTAINS"
+}
+/** Direction of a cross-solution relationship expressed as source and target solution codes */
+export interface RelationshipDirection {
+    /** Solution code of the source artifact */
+    source: SolutionCode;
+    /** Solution code of the target artifact */
+    target: SolutionCode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/relationships/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/relationships/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,8EAA8E;AAC9E,oBAAY,yBAAyB;IACnC,gEAAgE;IAChE,QAAQ,aAAa;IACrB,uDAAuD;IACvD,cAAc,mBAAmB;IACjC,kDAAkD;IAClD,YAAY,iBAAiB;IAC7B,wDAAwD;IACxD,cAAc,mBAAmB;IACjC,2DAA2D;IAC3D,cAAc,mBAAmB;IACjC,uDAAuD;IACvD,SAAS,cAAc;IACvB,4EAA4E;IAC5E,uBAAuB,4BAA4B;IACnD,2EAA2E;IAC3E,cAAc,mBAAmB;IACjC,sFAAsF;IACtF,6BAA6B,kCAAkC;IAC/D,+DAA+D;IAC/D,kBAAkB,uBAAuB;IACzC,2EAA2E;IAC3E,mBAAmB,wBAAwB;IAC3C,uDAAuD;IACvD,QAAQ,aAAa;IACrB,8DAA8D;IAC9D,UAAU,eAAe;IACzB,oEAAoE;IACpE,iBAAiB,sBAAsB;IACvC,yDAAyD;IACzD,cAAc,mBAAmB;CAClC;AAED,wDAAwD;AACxD,oBAAY,gBAAgB;IAC1B,kDAAkD;IAClD,UAAU,eAAe;IACzB,oDAAoD;IACpD,aAAa,kBAAkB;IAC/B,4CAA4C;IAC5C,WAAW,gBAAgB;IAC3B,wDAAwD;IACxD,QAAQ,aAAa;CACtB;AAED,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,EAAE,YAAY,CAAC;IACrB,2CAA2C;IAC3C,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/dist/relationships/types.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalEdgeType = exports.CrossSolutionRelationship = void 0;
+/** Cross-solution relationship types linking artifacts across the pipeline */
+var CrossSolutionRelationship;
+(function (CrossSolutionRelationship) {
+    /** Thinking artifact informed a requirement (Ideation → Req) */
+    CrossSolutionRelationship["INFORMED"] = "INFORMED";
+    /** Requirement constrains architecture (Req → Arch) */
+    CrossSolutionRelationship["CONSTRAINED_BY"] = "CONSTRAINED_BY";
+    /** Requirement detailed in a spec (Req → Spec) */
+    CrossSolutionRelationship["SPECIFIED_BY"] = "SPECIFIED_BY";
+    /** Architecture decision shapes a spec (Arch → Spec) */
+    CrossSolutionRelationship["ARCHITECTED_BY"] = "ARCHITECTED_BY";
+    /** Spec implemented in generated code (Spec → Platform) */
+    CrossSolutionRelationship["IMPLEMENTED_BY"] = "IMPLEMENTED_BY";
+    /** Spec validated by a test suite (Spec → Platform) */
+    CrossSolutionRelationship["TESTED_BY"] = "TESTED_BY";
+    /** Transformation artifact informed a requirement (Transformation → Req) */
+    CrossSolutionRelationship["TRANSFORMATION_INFORMED"] = "TRANSFORMATION_INFORMED";
+    /** Intelligence entity informed an ideation artifact (Intel → Ideation) */
+    CrossSolutionRelationship["INTEL_INFORMED"] = "INTEL_INFORMED";
+    /** Intelligence entity informed a transformation artifact (Intel → Transformation) */
+    CrossSolutionRelationship["INTEL_TRANSFORMATION_INFORMED"] = "INTEL_TRANSFORMATION_INFORMED";
+    /** Intelligence entity informed a requirement (Intel → Req) */
+    CrossSolutionRelationship["INTEL_REQ_INFORMED"] = "INTEL_REQ_INFORMED";
+    /** Intelligence entity informed an architecture artifact (Intel → Arch) */
+    CrossSolutionRelationship["INTEL_ARCH_INFORMED"] = "INTEL_ARCH_INFORMED";
+    /** Spec implemented by generated code (Spec → Code) */
+    CrossSolutionRelationship["CODED_BY"] = "CODED_BY";
+    /** Code artifact tests another code artifact (Code → Code) */
+    CrossSolutionRelationship["CODE_TESTS"] = "CODE_TESTS";
+    /** Code module derived from architecture component (Arch → Code) */
+    CrossSolutionRelationship["CODE_DERIVED_FROM"] = "CODE_DERIVED_FROM";
+    /** Code artifact satisfies a requirement (Req → Code) */
+    CrossSolutionRelationship["CODE_SATISFIES"] = "CODE_SATISFIES";
+})(CrossSolutionRelationship || (exports.CrossSolutionRelationship = CrossSolutionRelationship = {}));
+/** Internal edge types within a solution-local graph */
+var InternalEdgeType;
+(function (InternalEdgeType) {
+    /** Intra-solution dependency between artifacts */
+    InternalEdgeType["DEPENDS_ON"] = "DEPENDS_ON";
+    /** Links artifact to its vector embedding chunks */
+    InternalEdgeType["HAS_EMBEDDING"] = "HAS_EMBEDDING";
+    /** Version history chain for an artifact */
+    InternalEdgeType["HAS_VERSION"] = "HAS_VERSION";
+    /** Parent-child containment (e.g., Feature → Screen) */
+    InternalEdgeType["CONTAINS"] = "CONTAINS";
+})(InternalEdgeType || (exports.InternalEdgeType = InternalEdgeType = {}));
+//# sourceMappingURL=types.js.map

package/dist/relationships/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/relationships/types.ts"],"names":[],"mappings":";;;AAEA,8EAA8E;AAC9E,IAAY,yBA+BX;AA/BD,WAAY,yBAAyB;IACnC,gEAAgE;IAChE,kDAAqB,CAAA;IACrB,uDAAuD;IACvD,8DAAiC,CAAA;IACjC,kDAAkD;IAClD,0DAA6B,CAAA;IAC7B,wDAAwD;IACxD,8DAAiC,CAAA;IACjC,2DAA2D;IAC3D,8DAAiC,CAAA;IACjC,uDAAuD;IACvD,oDAAuB,CAAA;IACvB,4EAA4E;IAC5E,gFAAmD,CAAA;IACnD,2EAA2E;IAC3E,8DAAiC,CAAA;IACjC,sFAAsF;IACtF,4FAA+D,CAAA;IAC/D,+DAA+D;IAC/D,sEAAyC,CAAA;IACzC,2EAA2E;IAC3E,wEAA2C,CAAA;IAC3C,uDAAuD;IACvD,kDAAqB,CAAA;IACrB,8DAA8D;IAC9D,sDAAyB,CAAA;IACzB,oEAAoE;IACpE,oEAAuC,CAAA;IACvC,yDAAyD;IACzD,8DAAiC,CAAA;AACnC,CAAC,EA/BW,yBAAyB,yCAAzB,yBAAyB,QA+BpC;AAED,wDAAwD;AACxD,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,kDAAkD;IAClD,6CAAyB,CAAA;IACzB,oDAAoD;IACpD,mDAA+B,CAAA;IAC/B,4CAA4C;IAC5C,+CAA2B,CAAA;IAC3B,wDAAwD;IACxD,yCAAqB,CAAA;AACvB,CAAC,EATW,gBAAgB,gCAAhB,gBAAgB,QAS3B"}

package/dist/schema/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/schema/types.d.ts

@@ -0,0 +1,152 @@
+import { ArtifactUri } from '../uri/types';
+/**
+ * Artifact node in a solution-local Spanner graph.
+ * Represents any solution-specific artifact (persona, user story, spec, etc.).
+ * Maps to the `artifacts` Spanner table.
+ */
+export interface ArtifactNode {
+    /** Globally unique artifact URI (primary key) */
+    uri: ArtifactUri;
+    /** Solution-specific artifact type (e.g., "persona", "user-story") */
+    type: string;
+    /** Human-readable artifact name */
+    name: string;
+    /** Full artifact content as JSON */
+    content: Record<string, unknown> | null;
+    /** SHA-256 hash of content for change detection */
+    content_hash: string;
+    /** Solution code (ideation, req, arch, spec, platform) */
+    solution: string;
+    /** Project identifier */
+    project_id: string;
+    /** Timestamp of artifact creation */
+    created_at: Date;
+    /** Timestamp of last update */
+    updated_at: Date;
+    /** Additional metadata as JSON */
+    metadata: Record<string, unknown> | null;
+}
+/**
+ * Embedding node in a solution-local Spanner graph.
+ * Stores a vector embedding chunk of an artifact's content.
+ * Maps to the `embeddings` Spanner table.
+ */
+export interface EmbeddingNode {
+    /** Unique chunk identifier (primary key) */
+    chunk_id: string;
+    /** URI of the parent artifact this chunk belongs to */
+    parent_uri: ArtifactUri;
+    /** Vector embedding as an array of floats */
+    vector: number[];
+    /** Embedding model used (e.g., "textembedding-gecko@latest") */
+    model: string;
+    /** Zero-based index of this chunk within the parent artifact */
+    chunk_index: number;
+    /** Total number of chunks for the parent artifact */
+    total_chunks: number;
+    /** Content type of the chunk (e.g., "interview_transcript") */
+    content_type: string | null;
+    /** Human-readable label for the section this chunk covers */
+    section_label: string | null;
+    /** Number of tokens in this chunk */
+    token_count: number | null;
+    /** Number of overlapping tokens with adjacent chunks (default 50) */
+    overlap_tokens: number;
+    /** Timestamp of chunk creation */
+    created_at: Date;
+}
+/**
+ * Version node in a solution-local Spanner graph.
+ * Stores a point-in-time snapshot of an artifact.
+ * Maps to the `versions` Spanner table.
+ */
+export interface VersionNode {
+    /** Unique version identifier (primary key) */
+    version_id: string;
+    /** URI of the artifact this version belongs to */
+    artifact_uri: ArtifactUri;
+    /** Monotonically increasing version number */
+    version_number: number;
+    /** SHA-256 hash of the content at this version */
+    content_hash: string;
+    /** Full content snapshot as JSON */
+    content_snapshot: Record<string, unknown> | null;
+    /** Timestamp of version creation */
+    created_at: Date;
+    /** User or system that created this version */
+    created_by: string | null;
+}
+/**
+ * Internal edge within a solution-local Spanner graph.
+ * Represents relationships between artifacts within the same solution.
+ * Maps to the `artifact_edges` Spanner table.
+ */
+export interface ArtifactEdge {
+    /** Unique edge identifier (primary key) */
+    edge_id: string;
+    /** URI of the source artifact */
+    source_uri: ArtifactUri;
+    /** URI of the target artifact */
+    target_uri: ArtifactUri;
+    /** Edge type (DEPENDS_ON, HAS_EMBEDDING, HAS_VERSION, CONTAINS) */
+    edge_type: string;
+    /** Additional metadata as JSON */
+    metadata: Record<string, unknown> | null;
+    /** Timestamp of edge creation */
+    created_at: Date;
+}
+/**
+ * Cross-solution traceability edge in the Traceability Index.
+ * Links artifacts across different solutions in the pipeline.
+ * Maps to the `traceability_edges` Spanner table.
+ */
+export interface TraceabilityEdge {
+    /** Unique edge identifier (primary key) */
+    edge_id: string;
+    /** URI of the source artifact */
+    source_uri: ArtifactUri;
+    /** Cross-solution relationship type */
+    relationship: string;
+    /** URI of the target artifact */
+    target_uri: ArtifactUri;
+    /** Solution code of the source artifact */
+    source_solution: string;
+    /** Solution code of the target artifact */
+    target_solution: string;
+    /** Project identifier */
+    project_id: string;
+    /** Timestamp of edge creation */
+    created_at: Date;
+    /** Timestamp of last update */
+    updated_at: Date;
+    /** Additional metadata as JSON */
+    metadata: Record<string, unknown> | null;
+}
+/**
+ * Change request record for the Rapid Change feature.
+ * Tracks bidirectional sync proposals between requirements and code.
+ * Maps to the `change_requests` Spanner table.
+ */
+export interface ChangeRequest {
+    /** Unique change request identifier (primary key) */
+    change_request_id: string;
+    /** URI of the artifact where the change originated */
+    origin_uri: ArtifactUri;
+    /** Solution code where the change originated */
+    origin_solution: string;
+    /** Direction of change propagation */
+    direction: 'forward' | 'backward';
+    /** Current status of the change request */
+    status: 'pending' | 'approved' | 'rejected' | 'applied';
+    /** URIs of all artifacts affected by this change */
+    affected_uris: string[];
+    /** Proposed changes as JSON */
+    proposed_changes: Record<string, unknown> | null;
+    /** Timestamp of change request creation */
+    created_at: Date;
+    /** Timestamp when the request was resolved */
+    resolved_at: Date | null;
+    /** User or system that resolved the request */
+    resolved_by: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

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

package/dist/schema/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":""}

package/dist/uri/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './uri';
+//# sourceMappingURL=index.d.ts.map

package/dist/uri/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uri/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/uri/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./uri"), exports);
+//# sourceMappingURL=index.js.map

package/dist/uri/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/uri/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,wCAAsB"}

package/dist/uri/types.d.ts

@@ -0,0 +1,31 @@
+/** Short project identifier (e.g., "acme") */
+export type ProjectId = string;
+/** Solution code identifying which pipeline stage owns an artifact */
+export type SolutionCode = 'intel' | 'ideation' | 'transformation' | 'req' | 'arch' | 'spec' | 'code' | 'platform';
+/** All valid solution codes for runtime validation */
+export declare const SOLUTION_CODES: readonly SolutionCode[];
+/** Solution-specific artifact type (e.g., "persona", "user-story", "brd") */
+export type ArtifactType = string;
+/** Branded string type for compile-time URI safety with zero runtime cost */
+export type ArtifactUri = string & {
+    readonly __brand: 'ArtifactUri';
+};
+/** Result of parsing an ArtifactUri into its component parts */
+export interface ParsedUri {
+    /** Short project identifier */
+    projectId: ProjectId;
+    /** Solution code (ideation, transformation, req, arch, spec, code, platform) */
+    solution: SolutionCode;
+    /** Solution-specific artifact type */
+    artifactType: ArtifactType;
+    /** Unique identifier within the solution */
+    id: string;
+}
+/** Result of non-throwing URI validation */
+export interface ValidationResult {
+    /** Whether the URI is valid */
+    valid: boolean;
+    /** Descriptive error message if invalid */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/uri/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/uri/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnH,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAgG,CAAC;AAEnJ,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAEvE,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,gFAAgF;IAChF,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/uri/types.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOLUTION_CODES = void 0;
+/** All valid solution codes for runtime validation */
+exports.SOLUTION_CODES = ['intel', 'ideation', 'transformation', 'req', 'arch', 'spec', 'code', 'platform'];
+//# sourceMappingURL=types.js.map

package/dist/uri/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/uri/types.ts"],"names":[],"mappings":";;;AAMA,sDAAsD;AACzC,QAAA,cAAc,GAA4B,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC"}

package/dist/uri/uri.d.ts

@@ -0,0 +1,45 @@
+import { ArtifactUri, ArtifactType, ParsedUri, ProjectId, SolutionCode, ValidationResult } from './types';
+/**
+ * Creates a validated ArtifactUri from its component parts.
+ *
+ * @param projectId - Short project identifier (e.g., "acme")
+ * @param solution - Solution code (ideation, transformation, req, arch, spec, code, platform)
+ * @param artifactType - Artifact type (e.g., "persona", "user-story")
+ * @param id - Unique identifier within the solution
+ * @returns Branded ArtifactUri string
+ * @throws Error if any input is invalid
+ */
+export declare function createUri(projectId: ProjectId, solution: SolutionCode, artifactType: ArtifactType, id: string): ArtifactUri;
+/**
+ * Parses an ArtifactUri string into its component parts.
+ *
+ * @param uri - URI string to parse
+ * @returns ParsedUri with projectId, solution, artifactType, and id
+ * @throws Error if the URI does not match the expected format
+ */
+export declare function parseUri(uri: string): ParsedUri;
+/**
+ * Validates a URI string without throwing. Returns a result object
+ * indicating whether the URI is valid, with a descriptive error if not.
+ *
+ * @param uri - URI string to validate
+ * @returns ValidationResult with valid boolean and optional error message
+ */
+export declare function validateUri(uri: string): ValidationResult;
+/**
+ * Extracts the solution code from a URI string.
+ *
+ * @param uri - URI string to extract from
+ * @returns SolutionCode
+ * @throws Error if the URI is invalid
+ */
+export declare function extractSolution(uri: string): SolutionCode;
+/**
+ * Extracts the artifact type from a URI string.
+ *
+ * @param uri - URI string to extract from
+ * @returns ArtifactType
+ * @throws Error if the URI is invalid
+ */
+export declare function extractArtifactType(uri: string): ArtifactType;
+//# sourceMappingURL=uri.d.ts.map

package/dist/uri/uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../../src/uri/uri.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EAEZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAYjB;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,MAAM,GACT,WAAW,CA0Bb;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAe/C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAuDzD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE7D"}