mismagent-seam-cross-deploy

Projects cross-deploy boundaries into OpenAPI contracts with generated types and Pact CDC verification.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lucolucus/mismagent --skill mismagent-seam-cross-deploy-lucolucus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mismagent-seam-cross-deploy
Source: https://github.com/lucolucus/mismagent/tree/main/codex/skills/mismagent-seam-cross-deploy
Command: npx skills add https://github.com/lucolucus/mismagent --skill mismagent-seam-cross-deploy-lucolucus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a consumer and supplier live in different deploy units, the boundary between them crosses the network and needs an executable contract. This Skill projects that boundary into OpenAPI schemas, per-side generated types, and consumer-driven contract tests so both sides can develop in parallel against a verified interface. ## Core Features & Use Cases - OpenAPI Projection: Converts the consumer-owned Port signature into an OpenAPI contract with stable operationIds and schema names from the ubiquitous language. - Per-Side Generated Types: Generates types from the contract on each side, enabling parallel frontend/backend development against the interface. - CDC Publish/Verify with Pact: The consumer publishes the pact; the producer verifies it real-on-real as the D2 welding step, enforcing additive-vs-breaking discipline at merge. - Event-Schema Variant: For event-replication or local-first sync wires, projects the contract as a versioned event schema with descriptor-reflection contract tests and pinned delivery guarantees. - Use Case: A frontend and backend team in separate deploy units need to evolve an API without breaking each other — the consumer publishes a Pact contract, and the producer must turn it green before the consumer depends on the new shape. ## Quick Start Ask the agent to realize the cross-deploy boundary for a feature whose manifest pins boundary.projection = cross-deploy, generating the OpenAPI contract and Pact tests.

Frequently Asked Questions about mismagent-seam-cross-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement consumer-driven contract testing with Pact across deploy units?

The consumer publishes the pact describing the contract it expects, and the producer verifies it real-on-real as the D2 welding step. At merge, additive-vs-breaking is checked on the contract, and the producer must turn the pact green before the consumer depends on the new shape.

How to generate types from an OpenAPI contract for parallel development?

The consumer-owned Port signature is projected into an OpenAPI schema with stable operationIds and components named from the ubiquitous language. Each side then generates its types from that contract, letting frontend and backend develop in parallel against the interface.

When should I use cross-deploy projection instead of an in-process seam?

Use cross-deploy projection only when consumer and supplier live in different deploy units and the boundary crosses the network. If boundary.projection is in-process, use the lighter in-process seam instead.

How do I contract-test event schemas for replication or sync wires?

Use descriptor-reflection: the contract test loads compiled schema descriptors such as proto FileDescriptorProto, and the fake is a descriptor mutated in memory with a field removed or renamed. The test must turn red on removal or rename, proving additive evolution holds.

What delivery guarantees should an event-schema contract pin?

The contract includes the delivery guarantee pinned on the boundary, such as per-node in-order delivery with dedup by nodeId and sequence before the fold. Consumer folds are designed against it, and the D2 weld fails any fold that only converges under a stronger guarantee.