@shortlink-org/portolan 0.1.0

package/portolan.json

@@ -0,0 +1,1073 @@
+{
+  "$schema": "./schema/portolan.schema.json",
+  "$comment": "Where the facts come from, what produces them, and what turns them into something to read.",
+  "defaultCatalog": "portolan",
+  "catalogs": [
+    {
+      "id": "portolan",
+      "title": "Portolan",
+      "sources": ["portolan/*.json"],
+      "contexts": ["portolan"],
+      "projects": ["portolan"]
+    },
+    {
+      "id": "example",
+      "title": "Example estate",
+      "sources": [
+        "data/*.json",
+        "examples/*/portolan/*.json",
+        "examples/*/*/portolan/*.json",
+        "examples/*/*/*/portolan/*.json",
+        "vendor/repos/*/*/git.repo.json",
+        "vendor/repos/**/portolan/*.json"
+      ],
+      "contexts": ["auth", "shop", "delivery", "payments", "storefront"],
+      "projects": ["auth", "shop-cart", "shop-billing", "shop-pricing", "delivery-core", "payments-ledger", "shop-oms"]
+    }
+  ],
+  "projects": [
+    {
+      "id": "auth",
+      "name": "Authentication",
+      "root": "examples/auth",
+      "context": "auth",
+      "service": "auth"
+    },
+    {
+      "id": "shop-cart",
+      "name": "Shop / Cart",
+      "root": "examples/shop/cart",
+      "context": "shop",
+      "service": "cart"
+    },
+    {
+      "id": "shop-billing",
+      "name": "Shop / Billing",
+      "root": "examples/shop/billing",
+      "context": "shop",
+      "service": "billing"
+    },
+    {
+      "id": "shop-pricing",
+      "name": "Shop / Pricing",
+      "root": "examples/shop/pricing",
+      "context": "shop",
+      "service": "pricing"
+    },
+    {
+      "id": "delivery-core",
+      "name": "Delivery / Core",
+      "root": "examples/shop/delivery/core",
+      "context": "delivery",
+      "service": "core"
+    },
+    {
+      "id": "payments-ledger",
+      "name": "Payments / Ledger",
+      "root": "examples/payments/ledger",
+      "context": "payments",
+      "service": "ledger"
+    },
+    {
+      "id": "shop-oms",
+      "name": "Shop / OMS",
+      "root": "examples/shop/oms",
+      "context": "shop",
+      "service": "oms"
+    },
+    {
+      "id": "portolan",
+      "name": "Portolan",
+      "root": ".",
+      "context": "portolan",
+      "service": "portolan"
+    }
+  ],
+  "sources": [
+    "data/*.json",
+    "portolan/*.json",
+    "examples/*/portolan/*.json",
+    "examples/*/*/portolan/*.json",
+    "examples/*/*/*/portolan/*.json",
+    "vendor/repos/*/*/git.repo.json",
+    "vendor/repos/**/portolan/*.json"
+  ],
+  "plugins": [
+    {
+      "name": "project",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-project"]
+      }
+    },
+    {
+      "name": "commands",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-commands"]
+      }
+    },
+    {
+      "name": "go-domain",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-go"]
+      }
+    },
+    {
+      "name": "ts-domain",
+      "process": {
+        "command": "node",
+        "args": ["plugins/extract-ts/main.ts"]
+      }
+    },
+    {
+      "name": "rust-domain",
+      "process": {
+        "command": "cargo",
+        "args": ["run", "--quiet", "--manifest-path", "plugins/extract-rust/Cargo.toml"]
+      }
+    },
+    {
+      "name": "java-domain",
+      "process": {
+        "command": "java",
+        "args": ["-cp", "plugins/extract-java/build", "org.portolan.extract.Main"]
+      }
+    },
+    {
+      "name": "django-domain",
+      "process": {
+        "command": "python3",
+        "args": ["plugins/extract-django/main.py"]
+      }
+    },
+    {
+      "name": "celery",
+      "process": {
+        "command": "python3",
+        "args": ["plugins/extract-celery/main.py"]
+      }
+    },
+    {
+      "name": "python-kafka",
+      "process": {
+        "command": "python3",
+        "args": ["plugins/extract-python-kafka/main.py"]
+      }
+    },
+    {
+      "name": "openapi",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-openapi"]
+      }
+    },
+    {
+      "name": "wsdl",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-wsdl"]
+      }
+    },
+    {
+      "name": "http-clients",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-http-clients"]
+      }
+    },
+    {
+      "name": "redis",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-redis"]
+      }
+    },
+    {
+      "name": "river",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-river"]
+      }
+    },
+    {
+      "name": "watermill",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-watermill"]
+      }
+    },
+    {
+      "name": "go-nats",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-go-nats"]
+      }
+    },
+    {
+      "name": "asyncapi",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-asyncapi"]
+      }
+    },
+    {
+      "name": "graphql",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-graphql"]
+      }
+    },
+    {
+      "name": "sql",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-sql"]
+      }
+    },
+    {
+      "name": "markdown",
+      "wasm": {
+        "url": "file://plugins/gen-markdown.wasm"
+      }
+    },
+    {
+      "name": "mermaid",
+      "wasm": {
+        "url": "file://plugins/gen-mermaid.wasm"
+      }
+    },
+    {
+      "name": "backstage",
+      "wasm": {
+        "url": "file://plugins/gen-backstage.wasm"
+      }
+    },
+    {
+      "name": "otel",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/verify-otel"]
+      }
+    },
+    {
+      "name": "codeowners",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/verify-codeowners"]
+      }
+    },
+    {
+      "name": "adr",
+      "process": {
+        "command": "go",
+        "args": [
+          "run",
+          "./plugins/extract-adr"
+        ]
+      }
+    },
+    {
+      "name": "glossary",
+      "process": {
+        "command": "go",
+        "args": [
+          "run",
+          "./plugins/extract-glossary"
+        ]
+      }
+    },
+    {
+      "name": "flows",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-flows"]
+      }
+    },
+    {
+      "name": "bsr",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/fetch-bsr"]
+      }
+    },
+    {
+      "name": "git",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/fetch-git"]
+      }
+    },
+    {
+      "name": "proto",
+      "process": {
+        "command": "go",
+        "args": ["run", "./plugins/extract-proto"]
+      }
+    }
+  ],
+  "extract": [
+    {
+      "plugin": "adr",
+      "in": "data/adr",
+      "out": "data",
+      "options": {
+        "files": [
+          "*.md"
+        ],
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "project",
+      "in": "scripts",
+      "out": "portolan",
+      "options": {
+        "group": "portolan",
+        "groupName": "Portolan",
+        "groupSummary": "The tool that reads an architecture catalog from the code and specifications that already describe a software estate. It is documented here as the system that extracts, merges, validates and presents those facts.",
+        "component": "host",
+        "componentName": "Host",
+        "componentKind": "cli",
+        "technologies": ["Node.js"],
+        "repo": "github.com/shortlink-org/portolan",
+        "out": "host.json"
+      }
+    },
+    {
+      "plugin": "project",
+      "in": "src",
+      "out": "portolan",
+      "options": {
+        "group": "portolan",
+        "component": "site",
+        "componentName": "Site",
+        "componentKind": "webapp",
+        "technologies": ["TypeScript", "React", "Vite"],
+        "repo": "github.com/shortlink-org/portolan",
+        "out": "site.json"
+      }
+    },
+    {
+      "plugin": "project",
+      "in": "plugins",
+      "out": "portolan",
+      "options": {
+        "group": "portolan",
+        "component": "plugins",
+        "componentName": "Plugins",
+        "componentKind": "cli",
+        "technologies": ["Go", "TypeScript", "Rust", "Java", "Python"],
+        "repo": "github.com/shortlink-org/portolan",
+        "out": "plugins.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": ".",
+      "out": "portolan",
+      "options": {
+        "context": "portolan",
+        "service": "host",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "flows",
+      "in": "flows",
+      "out": "portolan",
+      "options": {
+        "out": "flows.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "adr",
+      "out": "portolan",
+      "options": {
+        "files": ["*.md"],
+        "scope": "portolan",
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": ".",
+      "out": "portolan",
+      "options": {
+        "context": "portolan",
+        "out": "glossary.json"
+      }
+    },
+    {
+      "plugin": "go-domain",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "context": "auth",
+        "contextName": "Authentication",
+        "contextSummary": "Who someone is, and whether they are still logged in. The only service in the estate that stores credentials, and the only one allowed to mint or revoke a session.",
+        "classification": "generic",
+        "service": "auth",
+        "repo": "github.com/shortlink-org/portolan",
+        "store": "pg",
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "openapi",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "context": "auth",
+        "service": "auth",
+        "spec": "internal/transport/http/gen/openapi.yaml",
+        "out": "api.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "context": "auth",
+        "service": "auth",
+        "store": "pg",
+        "name": "Auth database",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "context": "auth",
+        "out": "glossary.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "context": "shop",
+        "service": "cart",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "ts-domain",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "context": "shop",
+        "contextName": "Shop",
+        "contextSummary": "What a customer is buying, what it costs and what they owe for it: the basket while it is still changing, the price it was promised at, the order it became, and the invoice for it. It moves no money and delivers nothing.",
+        "classification": "core",
+        "service": "cart",
+        "repo": "github.com/shortlink-org/portolan",
+        "store": "pg",
+        "peers": {
+          "auth.v1": "auth.auth",
+          "shop.v1": "shop.pricing"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "openapi",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "context": "shop",
+        "service": "cart",
+        "spec": "src/infrastructure/transport/http/gen/openapi.yaml",
+        "out": "api.json"
+      }
+    },
+    {
+      "plugin": "asyncapi",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "context": "shop",
+        "service": "cart",
+        "spec": "src/infrastructure/transport/bus/asyncapi.yaml",
+        "out": "bus.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "context": "shop",
+        "service": "cart",
+        "store": "pg",
+        "name": "Cart database",
+        "repositories": "src/infrastructure/repository",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "django-domain",
+      "in": "examples/shop/billing",
+      "out": "examples/shop/billing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "billing",
+        "store": "pg",
+        "storeName": "Billing database",
+        "peers": {
+          "auth.v1": "auth.auth"
+        },
+        "events": {
+          "shop_events.payments": "payments.ledger.payment"
+        },
+        "out": "domain.json",
+        "storesOut": "stores.json"
+      }
+    },
+    {
+      "plugin": "openapi",
+      "in": "examples/shop/billing",
+      "out": "examples/shop/billing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "billing",
+        "spec": "invoices/schema/openapi.yaml",
+        "out": "api.json"
+      }
+    },
+    {
+      "plugin": "asyncapi",
+      "in": "examples/shop/billing",
+      "out": "examples/shop/billing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "billing",
+        "spec": "invoices/bus/asyncapi.yaml",
+        "out": "bus.json"
+      }
+    },
+    {
+      "plugin": "celery",
+      "in": "examples/shop/billing",
+      "out": "examples/shop/billing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "billing",
+        "out": "celery.json"
+      }
+    },
+    {
+      "plugin": "go-domain",
+      "in": "examples/shop/pricing",
+      "out": "examples/shop/pricing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "pricing",
+        "repo": "github.com/shortlink-org/portolan",
+        "store": "pg",
+        "peers": {
+          "shop.v1": "shop.oms"
+        },
+        "events": {
+          "github.com/shortlink-org/portolan/examples/shop/pricing/internal/infrastructure/cart": "shop.cart.basket"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "proto",
+      "in": "examples/shop/pricing",
+      "out": "examples/shop/pricing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "pricing",
+        "paths": [
+          "internal/infrastructure/transport/grpc/quote/proto",
+          "internal/infrastructure/transport/grpc/price_list/proto"
+        ],
+        "modules": {
+          "internal/infrastructure/transport/grpc/quote/proto": "buf.build/shortlink-org/portolan-shop-quote",
+          "internal/infrastructure/transport/grpc/price_list/proto": "buf.build/shortlink-org/portolan-shop-price-list"
+        },
+        "out": "proto.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/shop/pricing",
+      "out": "examples/shop/pricing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "pricing",
+        "store": "pg",
+        "name": "Pricing database",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/shop/pricing",
+      "out": "examples/shop/pricing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "pricing",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "go-nats",
+      "in": "examples/shop/pricing",
+      "out": "examples/shop/pricing/portolan",
+      "options": {
+        "context": "shop",
+        "service": "pricing",
+        "out": "nats.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "context": "delivery",
+        "service": "core",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "ts-domain",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "context": "delivery",
+        "contextName": "Delivery",
+        "contextSummary": "Parcels, vans and the day they are driven. Told what to carry and asked where it got to; it decides neither.",
+        "classification": "supporting",
+        "service": "core",
+        "serviceName": "Delivery Core",
+        "repo": "github.com/shortlink-org/portolan",
+        "store": "pg",
+        "peers": {
+          "shop.v1": "shop.oms"
+        },
+        "events": {
+          "../ledger/events.ts": "payments.ledger.payment"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "proto",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "context": "delivery",
+        "service": "core",
+        "paths": [
+          "src/infrastructure/transport/grpc/shipment/proto",
+          "src/infrastructure/transport/grpc/route/proto"
+        ],
+        "modules": {
+          "src/infrastructure/transport/grpc/shipment/proto": "buf.build/shortlink-org/portolan-delivery-shipment",
+          "src/infrastructure/transport/grpc/route/proto": "buf.build/shortlink-org/portolan-delivery-route"
+        },
+        "out": "proto.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "context": "delivery",
+        "service": "core",
+        "store": "pg",
+        "name": "Delivery database",
+        "repositories": "src/infrastructure/repository",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": "examples/shop/delivery/core",
+      "out": "examples/shop/delivery/core/portolan",
+      "options": {
+        "context": "delivery",
+        "out": "glossary.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "context": "payments",
+        "service": "ledger",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "java-domain",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "context": "payments",
+        "contextName": "Payments",
+        "contextSummary": "Money, and the record of every movement of it. Nothing here decides whether to charge - it is asked, and it writes down what happened either way.",
+        "classification": "supporting",
+        "service": "ledger",
+        "store": "pg",
+        "peers": {
+          "shop.v1": "shop.oms"
+        },
+        "externals": {
+          "stripe.v1": "stripe"
+        },
+        "events": {
+          "org.portolan.payments.ledger.application.oms": "shop.oms.order"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "openapi",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "external": "stripe",
+        "externalName": "Stripe",
+        "externalSummary": "The card network the ledger moves money through. Nobody in the estate provides it; the copy of its document beside the ledger's adapter is narrowed to the four operations the ledger calls, and is all the catalog claims about it.",
+        "externalUrl": "https://docs.stripe.com/api",
+        "spec": "src/main/java/org/portolan/payments/ledger/infrastructure/stripe/openapi/openapi.yaml",
+        "out": "stripe.json"
+      }
+    },
+    {
+      "plugin": "proto",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "context": "payments",
+        "service": "ledger",
+        "paths": [
+          "src/main/java/org/portolan/payments/ledger/infrastructure/transport/grpc/payment/proto",
+          "src/main/java/org/portolan/payments/ledger/infrastructure/transport/grpc/refund/proto"
+        ],
+        "modules": {
+          "src/main/java/org/portolan/payments/ledger/infrastructure/transport/grpc/payment/proto": "buf.build/shortlink-org/portolan-payments-payment",
+          "src/main/java/org/portolan/payments/ledger/infrastructure/transport/grpc/refund/proto": "buf.build/shortlink-org/portolan-payments-refund"
+        },
+        "out": "proto.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "context": "payments",
+        "service": "ledger",
+        "store": "pg",
+        "name": "Ledger database",
+        "repositories": "src/main/java/org/portolan/payments/ledger/infrastructure/repository",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": "examples/payments/ledger",
+      "out": "examples/payments/ledger/portolan",
+      "options": {
+        "context": "payments",
+        "out": "glossary.json"
+      }
+    },
+    {
+      "plugin": "bsr",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/vendor/proto",
+      "options": {
+        "cache": "examples/shop/oms/vendor/proto",
+        "modules": [
+          {
+            "module": "buf.build/shortlink-org/portolan-shop-order",
+            "commit": "6ae5e6ade8a547a59553b3aae02a2335"
+          }
+        ]
+      }
+    },
+    {
+      "plugin": "proto",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "context": "shop",
+        "service": "oms",
+        "paths": [
+          "vendor/proto/shortlink-org/portolan-shop-order"
+        ],
+        "out": "proto.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "context": "shop",
+        "service": "oms",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "rust-domain",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "context": "shop",
+        "service": "oms",
+        "repo": "github.com/shortlink-org/portolan",
+        "store": "pg",
+        "peers": {
+          "payments.v1": "payments.ledger"
+        },
+        "events": {
+          "crate::infrastructure::cart": "shop.cart.basket",
+          "crate::infrastructure::ledger": "payments.ledger.payment"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "sql",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "context": "shop",
+        "service": "oms",
+        "store": "pg",
+        "name": "Order database",
+        "repositories": "src/infrastructure/repository",
+        "out": "stores.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "context": "shop",
+        "out": "glossary.json"
+      }
+    },
+    {
+      "plugin": "commands",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "context": "storefront",
+        "service": "bff",
+        "out": "commands.json"
+      }
+    },
+    {
+      "plugin": "ts-domain",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "context": "storefront",
+        "contextName": "Storefront",
+        "contextSummary": "One graph in front of the estate, for one kind of client. It owns nothing: everything it answers with it asked somebody else for a moment earlier, and translated into the words a shopper's screen uses.",
+        "classification": "supporting",
+        "service": "bff",
+        "serviceName": "Storefront BFF",
+        "repo": "github.com/shortlink-org/portolan",
+        "graphql": "src/schema",
+        "peers": {
+          "auth.v1": "auth.auth",
+          "cart.v1": "shop.cart",
+          "shop.v1": "shop.oms",
+          "delivery.v1": "delivery.core"
+        },
+        "out": "domain.json"
+      }
+    },
+    {
+      "plugin": "graphql",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "context": "storefront",
+        "service": "bff",
+        "schema": "src/schema",
+        "api": "storefront.v1",
+        "out": "api.json"
+      }
+    },
+    {
+      "plugin": "asyncapi",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "context": "storefront",
+        "service": "bff",
+        "spec": "src/infrastructure/bus/asyncapi.yaml",
+        "out": "bus.json"
+      }
+    },
+    {
+      "plugin": "adr",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "out": "adr.json"
+      }
+    },
+    {
+      "plugin": "glossary",
+      "in": "examples/bff",
+      "out": "examples/bff/portolan",
+      "options": {
+        "context": "storefront",
+        "out": "glossary.json"
+      }
+    }
+  ],
+  "verify": [
+    {
+      "plugin": "otel",
+      "in": "examples/auth",
+      "out": "examples/auth/portolan",
+      "options": {
+        "traces": [
+          "telemetry/traces.jsonl"
+        ],
+        "out": "observed.json"
+      }
+    },
+    {
+      "plugin": "otel",
+      "in": "examples/shop/cart",
+      "out": "examples/shop/cart/portolan",
+      "options": {
+        "traces": [
+          "telemetry/traces.jsonl"
+        ],
+        "out": "observed.json"
+      }
+    },
+    {
+      "plugin": "otel",
+      "in": "examples/shop/oms",
+      "out": "examples/shop/oms/portolan",
+      "options": {
+        "traces": [
+          "telemetry/traces.jsonl"
+        ],
+        "out": "observed.json"
+      }
+    },
+    {
+      "plugin": "codeowners",
+      "in": "data/codeowners",
+      "out": "data",
+      "options": {
+        "out": "owners.json"
+      }
+    }
+  ],
+  "generate": [
+    {
+      "plugin": "markdown",
+      "catalog": "portolan",
+      "out": "docs",
+      "options": {
+        "title": "Portolan",
+        "sourceBaseUrl": "https://github.com/shortlink-org/portolan/blob/main"
+      }
+    },
+    {
+      "plugin": "mermaid",
+      "catalog": "portolan",
+      "out": "exports/mermaid",
+      "options": {
+        "title": "Portolan flows"
+      }
+    },
+    {
+      "plugin": "markdown",
+      "catalog": "example",
+      "out": "docs/example",
+      "options": {
+        "title": "Example estate",
+        "sourceBaseUrl": "https://github.com/shortlink-org/portolan/blob/main"
+      }
+    },
+    {
+      "plugin": "mermaid",
+      "catalog": "example",
+      "out": "exports/mermaid/example",
+      "options": {
+        "title": "Example estate flows"
+      }
+    },
+    {
+      "plugin": "backstage",
+      "catalog": "example",
+      "out": "exports/backstage",
+      "options": {
+        "domain": "example-estate",
+        "domainTitle": "Example estate",
+        "owner": "architecture",
+        "lifecycle": "production",
+        "sourceBaseUrl": "https://github.com/shortlink-org/portolan/blob/main"
+      }
+    }
+  ]
+}