Platform contracts
Industry Solution Composition Contracts
On this page
An IndustrySolution assembles compatible capability bundles, sector defaults and interface contributions. It references package-owned functionality instead of embedding business execution in the kernel. The Technology Consulting & Delivery composition is documented separately.
2. Composition Hierarchy
flowchart TB
P["Package\nOne technical artifact"] --> B["CapabilityBundle\nOne coherent business capability"]
B --> S["IndustrySolution\nCertified sector baseline"]
S --> C["CustomerConfiguration\nSolution plus private overlays"]
C --> L["EnvironmentLock\nExact deployed digests"]| Level | Responsibility | Example |
|---|---|---|
Package | One data model, workflow, agent, AI model, tool, connector, policy, interface, or evaluation artifact | effority.agent.project-execution@2.4.1 |
CapabilityBundle | Compatible packages delivering one coherent capability | Project and Portfolio Execution |
IndustrySolution | Certified set of capability bundles covering the standard needs of one sector | Technology Consulting & Delivery Intelligence |
CustomerConfiguration | Industry solution plus customer additions, removals, selections, private enrichments, and overrides | A systems integrator's governed configuration |
EnvironmentLock | Exact immutable package graph deployed in one environment | Production lock 2026.08.12 |
3. CapabilityBundle
A CapabilityBundle is technically distributed as a ConfigurationBundle. It normally contains or references:
- one or more
DataModelPackageartifacts; - one or more
WorkflowPackagedefinitions; - agents and model-capability requirements;
- tools and connectors;
- policies and evaluation packages;
- interface, route, navigation, widget, command, and report contributions;
- dependencies, extension points, compatibility, lifecycle, and data-disposition rules.
Examples include Meeting Intelligence, Commercial Intelligence, Project Execution, Scope and SOW Alignment, Relationship and Trust, Search Assistant, and Reports.
4. IndustrySolution
An IndustrySolution is a signed, versioned, non-executable composition artifact. It references compatible capability bundles and supplies the sector defaults that turn them into one coherent product experience.
It defines:
- required, default, restricted, recommended, optional, alternative, and conflicting bundles;
- compatible version ranges and resolved certification baselines;
- standard sector data models and relationships;
- workflows and review patterns;
- roles, permission profiles, and responsibility mappings;
- navigation order, screen composition, dashboards, and report catalog;
- taxonomies, classifiers, KPIs, thresholds, and materiality rules;
- connector profiles and field-mapping templates;
- language, model-capability, runtime, and infrastructure requirements;
- qualification suites, gold sets, and minimum production gates;
- installation, migration, update, removal, and rollback behavior;
- support, licensing, documentation, and end-of-life terms.
An Industry Solution contains no customer evidence, user directory, credentials, tenant secrets, or organization-specific business records.
4.1 Bundle Membership Roles
| Role | Meaning |
|---|---|
REQUIRED | The solution cannot operate without the bundle |
DEFAULT_ACTIVE | Installed and active in the certified standard solution |
INSTALLED_RESTRICTED | Installed and qualified but activated only through explicit authority and policy |
RECOMMENDED | Not required, but included in the sector's recommended operating model |
OPTIONAL | Compatible add-on selected according to customer need |
ALTERNATIVE | One of several capability providers satisfies the same requirement |
CONFLICTING | Cannot coexist with a declared bundle or version range |
8. CustomerConfiguration
A customer does not fork or edit the Industry Solution. Telynt creates a CustomerConfiguration that records the selected solution version and separate customer-owned changes.
Technology Consulting & Delivery Intelligence 2.3
+ Customer data-model extensions
+ Customer workflows and approval rules
+ Customer navigation and dashboard overlays
+ Customer-private agents and models
+ Marketplace security enrichment
- Optional bundle deliberately disabled
= CustomerConfigurationThe customer layer records:
- selected and disabled optional bundles;
- approved alternatives and replacements;
- private packages and organization overlays;
- customer policy, role, threshold, language, and connector bindings;
- migration and compatibility status against the source Industry Solution;
- deviations from the certified baseline;
- evaluation evidence and approvals.
Publisher upgrades never overwrite customer packages. The compatibility resolver calculates whether each overlay remains valid, requires migration, conflicts, or blocks the proposed solution update.
10. Marketplace Representation
The Marketplace distinguishes:
- Industry Solutions — complete certified sector configurations;
- Capability Bundles — coherent functional modules;
- Enrichment Bundles — additions to installed capabilities;
- Packages — agents, models, workflows, data models, tools, connectors, interfaces, policies, and evaluations.
When linked to an authorized Telynt installation, an Industry Solution displays:
INSTALLEDwith exact version;PARTIALLY_INSTALLEDwith present and missing bundles;UPDATE_AVAILABLEwith affected customer overlays;COMPATIBLE;COMPATIBLE_WITH_PREREQUISITES;UPGRADE_REQUIRED;CONFLICT;BLOCKED_BY_POLICY;LICENSE_INCOMPATIBLE;NOT_COMPATIBLE;DEPRECATEDorREVOKED.
The installation plan shows bundle additions, removals, replacements, permissions, data migrations, navigation and screen changes, model and hardware requirements, evaluations, licensing, resource impact, deviations from the certified baseline, and rollback behavior.
Composition records and versions
The solution manifest records membership, required capabilities, compatible ranges and activation policy. The environment lock records exact resolved releases and digests. Documentation versions describe a release line; they are not a substitute for a verified installation lock.
Documentation and navigation
Platform Documentation owns generic contracts. Developers owns authoring and qualification procedures. Each Marketplace package owns its implementation and user reference. Solution documentation explains integration, sector settings and end-to-end work, linking canonical package articles. These relations are generated from the composition and ownership registry.
