@scoutflo/topology-contracts 0.7.2 → 0.7.4

package/dist/src/correlation/contracts/families/aws/index.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AWS_CONNECTION_CONTRACTS = void 0;
+const providers_1 = require("../../../../providers");
+const topology_1 = require("../../../../topology");
+const types_1 = require("../../types");
+const status_1 = require("../../status");
+const awsStructuralGuardrails = [
+    'Candidate registry metadata only; Gateway owns source-sync stamping, validation, and reconciliation.',
+    'Provider-specific AWS identifiers remain in source_attributes and must not become global normalized keys.',
+];
+exports.AWS_CONNECTION_CONTRACTS = [
+    {
+        key: 'aws_vpc_part_of_account',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VPC, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.AWS_ACCOUNT, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        notes: ['Uses the generic persisted database resource_type; current AWS adapter evidence maps this to RDS-style resources.'],
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_subnet_part_of_vpc',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.SUBNET, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VPC, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        notes: ['Uses the generic persisted object_storage resource_type; current AWS adapter evidence maps this to S3-style resources.'],
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_compute_instance_part_of_subnet',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.COMPUTE_INSTANCE, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.SUBNET, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        notes: ['Uses the generic persisted kubernetes_cluster resource_type; current AWS adapter evidence maps this to EKS-style resources.'],
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_compute_instance_part_of_vpc',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.COMPUTE_INSTANCE, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VPC, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        notes: ['Uses the generic persisted kubernetes_cluster resource_type; current AWS adapter evidence maps this to EKS-style resources.'],
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_database_part_of_vpc',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.DATABASE, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VPC, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_object_storage_part_of_account',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.OBJECT_STORAGE, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.AWS_ACCOUNT, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_kubernetes_cluster_part_of_vpc',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.KUBERNETES_CLUSTER, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VPC, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        guardrails: awsStructuralGuardrails,
+    },
+    {
+        key: 'aws_kubernetes_cluster_part_of_account',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.CANDIDATE,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.AWS,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.KUBERNETES_CLUSTER, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PART_OF,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.AWS_ACCOUNT, provider: providers_1.TOPOLOGY_PROVIDER.AWS },
+        relation_class: 'structural',
+        attribute_schema_key: types_1.STRUCTURAL_CONTAINMENT_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.CODE_EVIDENCE,
+        provider_family: 'aws',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.CLOUD,
+        guardrails: awsStructuralGuardrails,
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/src/correlation/contracts/families/aws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/correlation/contracts/families/aws/index.ts"],"names":[],"mappings":"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"}

package/dist/src/correlation/contracts/families/github/index.d.ts

@@ -0,0 +1,71 @@
+export declare const GITHUB_CONNECTION_CONTRACTS: readonly [{
+    readonly key: "github_account_owns_repository";
+    readonly version: "v1";
+    readonly status: "reserved";
+    readonly family: "github";
+    readonly source_endpoint: {
+        readonly entity_type: "resource";
+        readonly resource_type: "vcs";
+        readonly source_type: "github_account";
+        readonly provider: "github";
+    };
+    readonly relation: "OWNS";
+    readonly target_endpoint: {
+        readonly entity_type: "resource";
+        readonly resource_type: "vcs";
+        readonly source_type: "github_repository";
+        readonly provider: "github";
+    };
+    readonly relation_class: "associative";
+    readonly attribute_schema_key: "vcs.github";
+    readonly evidence_level: "planned";
+    readonly provider_family: "github";
+    readonly provider_category: "vcs";
+    readonly guardrails: readonly ["GitHub repository contracts are reserved vocabulary until repository nodes and edges exist locally.", "Do not treat repository metadata alone as proof of a service or resource edge."];
+}, {
+    readonly key: "github_repository_defines_service";
+    readonly version: "v1";
+    readonly status: "reserved";
+    readonly family: "github";
+    readonly source_endpoint: {
+        readonly entity_type: "resource";
+        readonly resource_type: "vcs";
+        readonly source_type: "github_repository";
+        readonly provider: "github";
+    };
+    readonly relation: "PROVIDES";
+    readonly target_endpoint: {
+        readonly entity_type: "service";
+        readonly label: "scoutflo_service";
+    };
+    readonly relation_class: "associative";
+    readonly attribute_schema_key: "vcs.github";
+    readonly evidence_level: "planned";
+    readonly provider_family: "github";
+    readonly provider_category: "vcs";
+    readonly notes: readonly ["Reserved until repository nodes and service-definition projection tests exist."];
+    readonly guardrails: readonly ["GitHub repository contracts are reserved vocabulary until repository nodes and edges exist locally.", "Do not treat repository metadata alone as proof of a service or resource edge."];
+}, {
+    readonly key: "github_repository_defines_resource";
+    readonly version: "v1";
+    readonly status: "reserved";
+    readonly family: "github";
+    readonly source_endpoint: {
+        readonly entity_type: "resource";
+        readonly resource_type: "vcs";
+        readonly source_type: "github_repository";
+        readonly provider: "github";
+    };
+    readonly relation: "PROVIDES";
+    readonly target_endpoint: {
+        readonly entity_type: "resource";
+        readonly label: "declared_in_repository";
+    };
+    readonly relation_class: "associative";
+    readonly attribute_schema_key: "vcs.github";
+    readonly evidence_level: "planned";
+    readonly provider_family: "github";
+    readonly provider_category: "vcs";
+    readonly notes: readonly ["Reserved for IaC/manifest-backed resource definitions; provider files stay in source_attributes."];
+    readonly guardrails: readonly ["GitHub repository contracts are reserved vocabulary until repository nodes and edges exist locally.", "Do not treat repository metadata alone as proof of a service or resource edge."];
+}];

package/dist/src/correlation/contracts/families/github/index.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_CONNECTION_CONTRACTS = void 0;
+const providers_1 = require("../../../../providers");
+const topology_1 = require("../../../../topology");
+const types_1 = require("../../types");
+const status_1 = require("../../status");
+const githubGuardrails = [
+    'GitHub repository contracts are reserved vocabulary until repository nodes and edges exist locally.',
+    'Do not treat repository metadata alone as proof of a service or resource edge.',
+];
+exports.GITHUB_CONNECTION_CONTRACTS = [
+    {
+        key: 'github_account_owns_repository',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.RESERVED,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.GITHUB,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VCS, source_type: 'github_account', provider: providers_1.TOPOLOGY_PROVIDER.GITHUB },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.OWNS,
+        target_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VCS, source_type: 'github_repository', provider: providers_1.TOPOLOGY_PROVIDER.GITHUB },
+        relation_class: 'associative',
+        attribute_schema_key: types_1.VCS_GITHUB_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.PLANNED,
+        provider_family: 'github',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.VCS,
+        guardrails: githubGuardrails,
+    },
+    {
+        key: 'github_repository_defines_service',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.RESERVED,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.GITHUB,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VCS, source_type: 'github_repository', provider: providers_1.TOPOLOGY_PROVIDER.GITHUB },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PROVIDES,
+        target_endpoint: { entity_type: 'service', label: 'scoutflo_service' },
+        relation_class: 'associative',
+        attribute_schema_key: types_1.VCS_GITHUB_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.PLANNED,
+        provider_family: 'github',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.VCS,
+        notes: ['Reserved until repository nodes and service-definition projection tests exist.'],
+        guardrails: githubGuardrails,
+    },
+    {
+        key: 'github_repository_defines_resource',
+        version: 'v1',
+        status: status_1.CONNECTION_CONTRACT_STATUS.RESERVED,
+        family: types_1.CONNECTION_CONTRACT_FAMILY.GITHUB,
+        source_endpoint: { entity_type: 'resource', resource_type: topology_1.TOPOLOGY_RESOURCE_TYPE.VCS, source_type: 'github_repository', provider: providers_1.TOPOLOGY_PROVIDER.GITHUB },
+        relation: topology_1.TOPOLOGY_RELATION_TYPE.PROVIDES,
+        target_endpoint: { entity_type: 'resource', label: 'declared_in_repository' },
+        relation_class: 'associative',
+        attribute_schema_key: types_1.VCS_GITHUB_ATTRIBUTE_SCHEMA_KEY,
+        evidence_level: types_1.CONNECTION_CONTRACT_EVIDENCE_LEVEL.PLANNED,
+        provider_family: 'github',
+        provider_category: types_1.CONNECTION_CONTRACT_PROVIDER_CATEGORY.VCS,
+        notes: ['Reserved for IaC/manifest-backed resource definitions; provider files stay in source_attributes.'],
+        guardrails: githubGuardrails,
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/src/correlation/contracts/families/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/correlation/contracts/families/github/index.ts"],"names":[],"mappings":";;;AAAA,qDAA0D;AAC1D,mDAAsF;AACtF,uCAMqB;AACrB,yCAA0D;AAE1D,MAAM,gBAAgB,GAAG;IACvB,qGAAqG;IACrG,gFAAgF;CACxE,CAAC;AAEE,QAAA,2BAA2B,GAAG;IACzC;QACE,GAAG,EAAE,gCAAgC;QACrC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,mCAA0B,CAAC,QAAQ;QAC3C,MAAM,EAAE,kCAA0B,CAAC,MAAM;QACzC,eAAe,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iCAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,6BAAiB,CAAC,MAAM,EAAE;QAC1J,QAAQ,EAAE,iCAAsB,CAAC,IAAI;QACrC,eAAe,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iCAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,6BAAiB,CAAC,MAAM,EAAE;QAC7J,cAAc,EAAE,aAAa;QAC7B,oBAAoB,EAAE,uCAA+B;QACrD,cAAc,EAAE,0CAAkC,CAAC,OAAO;QAC1D,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,6CAAqC,CAAC,GAAG;QAC5D,UAAU,EAAE,gBAAgB;KAC7B;IACD;QACE,GAAG,EAAE,mCAAmC;QACxC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,mCAA0B,CAAC,QAAQ;QAC3C,MAAM,EAAE,kCAA0B,CAAC,MAAM;QACzC,eAAe,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iCAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,6BAAiB,CAAC,MAAM,EAAE;QAC7J,QAAQ,EAAE,iCAAsB,CAAC,QAAQ;QACzC,eAAe,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE;QACtE,cAAc,EAAE,aAAa;QAC7B,oBAAoB,EAAE,uCAA+B;QACrD,cAAc,EAAE,0CAAkC,CAAC,OAAO;QAC1D,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,6CAAqC,CAAC,GAAG;QAC5D,KAAK,EAAE,CAAC,gFAAgF,CAAC;QACzF,UAAU,EAAE,gBAAgB;KAC7B;IACD;QACE,GAAG,EAAE,oCAAoC;QACzC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,mCAA0B,CAAC,QAAQ;QAC3C,MAAM,EAAE,kCAA0B,CAAC,MAAM;QACzC,eAAe,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iCAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,6BAAiB,CAAC,MAAM,EAAE;QAC7J,QAAQ,EAAE,iCAAsB,CAAC,QAAQ;QACzC,eAAe,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,wBAAwB,EAAE;QAC7E,cAAc,EAAE,aAAa;QAC7B,oBAAoB,EAAE,uCAA+B;QACrD,cAAc,EAAE,0CAAkC,CAAC,OAAO;QAC1D,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,6CAAqC,CAAC,GAAG;QAC5D,KAAK,EAAE,CAAC,kGAAkG,CAAC;QAC3G,UAAU,EAAE,gBAAgB;KAC7B;CACuD,CAAC"}