{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-immutability",
  "id": "immutability",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-computation-core",
    "json": "https://banes-lab.com/json/records/layer/computation-core",
    "label": "Computation Core",
    "markdown": "https://banes-lab.com/records/layer/computation-core.md",
    "ref": "layer:computation-core"
  },
  "name": "Immutability",
  "ref": "architecture:immutability",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-value-semantics",
          "json": "https://banes-lab.com/json/records/lexicon/value-semantics",
          "label": "Value Semantics",
          "markdown": "https://banes-lab.com/records/lexicon/value-semantics.md",
          "ref": "lexicon:value-semantics"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-thread-safety",
          "json": "https://banes-lab.com/json/records/lexicon/thread-safety",
          "label": "Thread Safety",
          "markdown": "https://banes-lab.com/records/lexicon/thread-safety.md",
          "ref": "lexicon:thread-safety"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-predictability",
          "json": "https://banes-lab.com/json/records/architecture/predictability",
          "label": "Predictability",
          "markdown": "https://banes-lab.com/records/architecture/predictability.md",
          "ref": "architecture:predictability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-safe-sharing",
          "json": "https://banes-lab.com/json/records/lexicon/safe-sharing",
          "label": "Safe Sharing",
          "markdown": "https://banes-lab.com/records/lexicon/safe-sharing.md",
          "ref": "lexicon:safe-sharing"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-shared-mutable-state",
          "json": "https://banes-lab.com/json/records/architecture/shared-mutable-state",
          "label": "Shared Mutable State",
          "markdown": "https://banes-lab.com/records/architecture/shared-mutable-state.md",
          "ref": "architecture:shared-mutable-state"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-allocation-cost",
          "json": "https://banes-lab.com/json/records/lexicon/allocation-cost",
          "label": "Allocation Cost",
          "markdown": "https://banes-lab.com/records/lexicon/allocation-cost.md",
          "ref": "lexicon:allocation-cost"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-allocation-cost-immutability",
          "json": "https://banes-lab.com/json/records/tension/allocation-cost-immutability",
          "label": "Immutability / Allocation Cost",
          "markdown": "https://banes-lab.com/records/tension/allocation-cost-immutability.md",
          "ref": "tension:allocation-cost-immutability"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-shared-mutable-state",
          "json": "https://banes-lab.com/json/records/architecture/shared-mutable-state",
          "label": "Shared Mutable State",
          "markdown": "https://banes-lab.com/records/architecture/shared-mutable-state.md",
          "ref": "architecture:shared-mutable-state"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-exposed-internals",
          "json": "https://banes-lab.com/json/records/lexicon/exposed-internals",
          "label": "Exposed Internals",
          "markdown": "https://banes-lab.com/records/lexicon/exposed-internals.md",
          "ref": "lexicon:exposed-internals"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-make-immutable",
          "json": "https://banes-lab.com/json/records/lexicon/make-immutable",
          "label": "Make Immutable",
          "markdown": "https://banes-lab.com/records/lexicon/make-immutable.md",
          "ref": "lexicon:make-immutable"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/records/architecture-category/correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/records/architecture-category/correctness-determinism-verification.md",
          "ref": "architecture-category:correctness-determinism-verification"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-value-object",
          "json": "https://banes-lab.com/json/records/architecture/value-object",
          "label": "Value Object",
          "markdown": "https://banes-lab.com/records/architecture/value-object.md",
          "ref": "architecture:value-object"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-independent-lifetime-axes",
          "json": "https://banes-lab.com/json/records/architecture/independent-lifetime-axes",
          "label": "Independent Lifetime Axes",
          "markdown": "https://banes-lab.com/records/architecture/independent-lifetime-axes.md",
          "ref": "architecture:independent-lifetime-axes"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-referential-transparency",
          "json": "https://banes-lab.com/json/records/architecture/referential-transparency",
          "label": "Referential Transparency",
          "markdown": "https://banes-lab.com/records/architecture/referential-transparency.md",
          "ref": "architecture:referential-transparency"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/disciplined-methodology/collaborate#the-board-and-the-venue",
          "json": "https://banes-lab.com/json/disciplined-methodology/collaborate/the-board-and-the-venue",
          "label": "The board and the venue",
          "markdown": "https://banes-lab.com/disciplined-methodology/collaborate/the-board-and-the-venue.md",
          "ref": "chapter:/disciplined-methodology/collaborate#the-board-and-the-venue"
        },
        {
          "href": "https://banes-lab.com/disciplined-methodology/collaborate#stating-an-invariant",
          "json": "https://banes-lab.com/json/disciplined-methodology/collaborate/stating-an-invariant",
          "label": "Stating an invariant",
          "markdown": "https://banes-lab.com/disciplined-methodology/collaborate/stating-an-invariant.md",
          "ref": "chapter:/disciplined-methodology/collaborate#stating-an-invariant"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#computation-and-resource",
          "json": "https://banes-lab.com/json/software-architecture/principles/computation-and-resource",
          "label": "Computation and resource",
          "markdown": "https://banes-lab.com/software-architecture/principles/computation-and-resource.md",
          "ref": "chapter:/software-architecture/principles#computation-and-resource"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#separate-trade-or-mitigate",
          "json": "https://banes-lab.com/json/software-architecture/principles/separate-trade-or-mitigate",
          "label": "Separate, trade, or mitigate",
          "markdown": "https://banes-lab.com/software-architecture/principles/separate-trade-or-mitigate.md",
          "ref": "chapter:/software-architecture/principles#separate-trade-or-mitigate"
        },
        {
          "href": "https://banes-lab.com/software-architecture/glossary#the-principle-architecture",
          "json": "https://banes-lab.com/json/software-architecture/glossary/the-principle-architecture",
          "label": "The principle architecture",
          "markdown": "https://banes-lab.com/software-architecture/glossary/the-principle-architecture.md",
          "ref": "chapter:/software-architecture/glossary#the-principle-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "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-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "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-coordination-surfaces",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-coordination-surfaces",
          "label": "Coordination Surfaces",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-coordination-surfaces.md",
          "ref": "chapter:/ontology#architecture-category-coordination-surfaces"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-modular-design.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-transactions-state-concurrency",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-transactions-state-concurrency",
          "label": "Transactions / State / Concurrency",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-transactions-state-concurrency.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-transactions-state-concurrency"
        },
        {
          "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": "A design rule that a value is never changed after it is created, and a change produces a new value.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-reproducibility",
      "json": "https://banes-lab.com/json/records/architecture/reproducibility",
      "label": "Reproducibility",
      "markdown": "https://banes-lab.com/records/architecture/reproducibility.md",
      "ref": "architecture:reproducibility"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-pure-functions",
      "json": "https://banes-lab.com/json/records/architecture/pure-functions",
      "label": "Pure Functions",
      "markdown": "https://banes-lab.com/records/architecture/pure-functions.md",
      "ref": "architecture:pure-functions"
    }
  },
  "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 Foo = Readonly<{ name: string; tags: readonly string[] }>;\nfunction addTag(foo: Foo, tag: string): Foo { return { ...foo, tags: [...foo.tags, tag] }; }",
    "before": "type Foo = { name: string; tags: string[] };\nfunction addTag(foo: Foo, tag: string) { foo.tags.push(tag); return foo; }",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "data",
    "value object",
    "concurrency"
  ],
  "severity": "recommended"
}