{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-stable-interfaces",
  "id": "stable-interfaces",
  "kind": "quality-attribute",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-contracts-core",
    "json": "https://banes-lab.com/json/records/layer/contracts-core",
    "label": "Contracts Core",
    "markdown": "https://banes-lab.com/records/layer/contracts-core.md",
    "ref": "layer:contracts-core"
  },
  "name": "Stable Interfaces",
  "ref": "architecture:stable-interfaces",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-versioning",
          "json": "https://banes-lab.com/json/records/architecture/versioning",
          "label": "Versioning",
          "markdown": "https://banes-lab.com/records/architecture/versioning.md",
          "ref": "architecture:versioning"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-backward-compatibility",
          "json": "https://banes-lab.com/json/records/architecture/backward-compatibility",
          "label": "Backward Compatibility",
          "markdown": "https://banes-lab.com/records/architecture/backward-compatibility.md",
          "ref": "architecture:backward-compatibility"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-low-coupling",
          "json": "https://banes-lab.com/json/records/architecture/low-coupling",
          "label": "Low Coupling",
          "markdown": "https://banes-lab.com/records/architecture/low-coupling.md",
          "ref": "architecture:low-coupling"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-replaceability",
          "json": "https://banes-lab.com/json/records/architecture/replaceability",
          "label": "Replaceability",
          "markdown": "https://banes-lab.com/records/architecture/replaceability.md",
          "ref": "architecture:replaceability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-independent-consumers",
          "json": "https://banes-lab.com/json/records/lexicon/independent-consumers",
          "label": "Independent Consumers",
          "markdown": "https://banes-lab.com/records/lexicon/independent-consumers.md",
          "ref": "lexicon:independent-consumers"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-breaking-change",
          "json": "https://banes-lab.com/json/records/lexicon/breaking-change",
          "label": "Breaking Change",
          "markdown": "https://banes-lab.com/records/lexicon/breaking-change.md",
          "ref": "lexicon:breaking-change"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-evolution-speed",
          "json": "https://banes-lab.com/json/records/lexicon/evolution-speed",
          "label": "Evolution Speed",
          "markdown": "https://banes-lab.com/records/lexicon/evolution-speed.md",
          "ref": "lexicon:evolution-speed"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-evolution-speed-stable-interfaces",
          "json": "https://banes-lab.com/json/records/tension/evolution-speed-stable-interfaces",
          "label": "Stable Interfaces / Evolution Speed",
          "markdown": "https://banes-lab.com/records/tension/evolution-speed-stable-interfaces.md",
          "ref": "tension:evolution-speed-stable-interfaces"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-unversioned-breaking-change",
          "json": "https://banes-lab.com/json/records/architecture/unversioned-breaking-change",
          "label": "Unversioned Breaking Change",
          "markdown": "https://banes-lab.com/records/architecture/unversioned-breaking-change.md",
          "ref": "architecture:unversioned-breaking-change"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-schema-drift",
          "json": "https://banes-lab.com/json/records/architecture/schema-drift",
          "label": "Schema Drift",
          "markdown": "https://banes-lab.com/records/architecture/schema-drift.md",
          "ref": "architecture:schema-drift"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-versioning",
          "json": "https://banes-lab.com/json/records/architecture/versioning",
          "label": "Versioning",
          "markdown": "https://banes-lab.com/records/architecture/versioning.md",
          "ref": "architecture:versioning"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-extract-adapter",
          "json": "https://banes-lab.com/json/records/lexicon/extract-adapter",
          "label": "Extract Adapter",
          "markdown": "https://banes-lab.com/records/lexicon/extract-adapter.md",
          "ref": "lexicon:extract-adapter"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-gradual-deprecation",
          "json": "https://banes-lab.com/json/records/lexicon/gradual-deprecation",
          "label": "Gradual Deprecation",
          "markdown": "https://banes-lab.com/records/lexicon/gradual-deprecation.md",
          "ref": "lexicon:gradual-deprecation"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/records/architecture-category/contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/records/architecture-category/contracts-interfaces-compatibility.md",
          "ref": "architecture-category:contracts-interfaces-compatibility"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-explicit-boundaries",
          "json": "https://banes-lab.com/json/records/architecture/explicit-boundaries",
          "label": "Explicit Boundaries",
          "markdown": "https://banes-lab.com/records/architecture/explicit-boundaries.md",
          "ref": "architecture:explicit-boundaries"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-runtime-extensibility",
          "json": "https://banes-lab.com/json/records/architecture/runtime-extensibility",
          "label": "Runtime Extensibility",
          "markdown": "https://banes-lab.com/records/architecture/runtime-extensibility.md",
          "ref": "architecture:runtime-extensibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-explicit-contracts",
          "json": "https://banes-lab.com/json/records/architecture/explicit-contracts",
          "label": "Explicit Contracts",
          "markdown": "https://banes-lab.com/records/architecture/explicit-contracts.md",
          "ref": "architecture:explicit-contracts"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-interface-based-design",
          "json": "https://banes-lab.com/json/records/architecture/interface-based-design",
          "label": "Interface-Based Design",
          "markdown": "https://banes-lab.com/records/architecture/interface-based-design.md",
          "ref": "architecture:interface-based-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-api-contract",
          "json": "https://banes-lab.com/json/records/architecture/api-contract",
          "label": "API Contract",
          "markdown": "https://banes-lab.com/records/architecture/api-contract.md",
          "ref": "architecture:api-contract"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-encapsulation",
          "json": "https://banes-lab.com/json/records/architecture/encapsulation",
          "label": "Encapsulation",
          "markdown": "https://banes-lab.com/records/architecture/encapsulation.md",
          "ref": "architecture:encapsulation"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-composability",
          "json": "https://banes-lab.com/json/records/architecture/composability",
          "label": "Composability",
          "markdown": "https://banes-lab.com/records/architecture/composability.md",
          "ref": "architecture:composability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-dependency-inversion",
          "json": "https://banes-lab.com/json/records/architecture/dependency-inversion",
          "label": "Dependency Inversion Principle",
          "markdown": "https://banes-lab.com/records/architecture/dependency-inversion.md",
          "ref": "architecture:dependency-inversion"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-plugin-architecture",
          "json": "https://banes-lab.com/json/records/architecture/plugin-architecture",
          "label": "Plugin Architecture",
          "markdown": "https://banes-lab.com/records/architecture/plugin-architecture.md",
          "ref": "architecture:plugin-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-extension-points",
          "json": "https://banes-lab.com/json/records/architecture/extension-points",
          "label": "Extension Points",
          "markdown": "https://banes-lab.com/records/architecture/extension-points.md",
          "ref": "architecture:extension-points"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-principle-of-least-surprise",
          "json": "https://banes-lab.com/json/records/architecture/principle-of-least-surprise",
          "label": "Principle of Least Surprise",
          "markdown": "https://banes-lab.com/records/architecture/principle-of-least-surprise.md",
          "ref": "architecture:principle-of-least-surprise"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-domain-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-domain-architecture",
          "label": "Domain Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-domain-architecture.md",
          "ref": "chapter:/ontology#architecture-category-domain-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-runtime-discovery-dynamic-binding",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-runtime-discovery-dynamic-binding",
          "label": "Runtime Discovery / Dynamic Binding",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-runtime-discovery-dynamic-binding.md",
          "ref": "chapter:/ontology#architecture-category-runtime-discovery-dynamic-binding"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology#architecture-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md",
          "ref": "chapter:/ontology#architecture-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-solid-object-oriented-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-solid-object-oriented-design",
          "label": "SOLID / Object-Oriented Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-solid-object-oriented-design.md",
          "ref": "chapter:/ontology#architecture-category-solid-object-oriented-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-plugin-extensibility-ioc",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-plugin-extensibility-ioc",
          "label": "Plugin / Extensibility / IoC",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-plugin-extensibility-ioc.md",
          "ref": "chapter:/ontology#architecture-category-plugin-extensibility-ioc"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-schema-canonical-data-semantics",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-schema-canonical-data-semantics",
          "label": "Schema / Canonical Data / Semantics",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md",
          "ref": "chapter:/ontology#architecture-category-schema-canonical-data-semantics"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-codebase-system-architecture-styles.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-codebase-system-architecture-styles"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "The degree to which a public interface keeps its signatures and meaning across releases.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-interface-based-design",
      "json": "https://banes-lab.com/json/records/architecture/interface-based-design",
      "label": "Interface-Based Design",
      "markdown": "https://banes-lab.com/records/architecture/interface-based-design.md",
      "ref": "architecture:interface-based-design"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-explicit-contracts",
      "json": "https://banes-lab.com/json/records/architecture/explicit-contracts",
      "label": "Explicit Contracts",
      "markdown": "https://banes-lab.com/records/architecture/explicit-contracts.md",
      "ref": "architecture:explicit-contracts"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "type CreateFooRequest = Readonly<{\n  name: string;\n  tags: readonly string[];\n  extensions: Readonly<Record<string, unknown>>;\n}>;\ninterface FooService { create(request: CreateFooRequest): Promise<FooId>; }",
    "before": "class FooService {\n  createFoo(name: string, tags: string[], notify: boolean, source: string) {}\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "API",
    "module",
    "service"
  ],
  "severity": "mandatory"
}