Skip to content

Ecosystem Co-Evolution Demo

This demo provides a guided walkthrough of the FCC ecosystem co-evolution capabilities -- from facade registration through unified search, knowledge graph construction, and cross-namespace federation.

Table of Contents

  1. Overview
  2. Prerequisites
  3. Running the Demo
  4. Step-by-Step Walkthrough
  5. Expected Output
  6. What You Will Learn
  7. Next Steps

Overview

The FCC ecosystem spans 11 interconnected projects that co-evolve through shared vocabulary, federated knowledge graphs, and unified search. This demo shows how the ModelFacade, FederatedKnowledgeGraph, and NamespaceRegistry components work together to enable seamless cross-project analysis and entity resolution.

Prerequisites

  • Python 3.10+ with FCC installed (pip install -e ".[dev]")
  • No API key required -- all operations use mock backends

Running the Demo

CLI

fcc demo run ecosystem-coevolution

Programmatic

from fcc.demos.registry import DemoRegistry
from fcc.demos.runner import DemoRunner

registry = DemoRegistry.from_builtin()
demo = registry.get("ecosystem_coevolution")
runner = DemoRunner()
result = runner.run(demo)
print(f"Success: {result.success}, Steps: {result.steps_completed}/{result.total_steps}")

Step-by-Step Walkthrough

Step 1: Register Facades

Register ModelFacade instances for each ecosystem project with their vocabulary mappings and namespace prefixes.

from fcc.objectmodel.facade import ModelFacade
from fcc.federation.namespace import NamespaceRegistry

ns = NamespaceRegistry()
ns.register("fcc", "https://fcc.example.com/ns/")
ns.register("constel", "https://constel.example.com/ns/")

Execute a cross-project search query that spans all registered facades with relevance scoring and de-duplication.

Step 3: Build Ecosystem Knowledge Graph

Construct a unified knowledge graph that imports nodes and edges from every ecosystem project into a single federated view.

Step 4: Demonstrate Cross-Namespace Edges

Create edges that link entities across different project namespaces and resolve references using federated entity resolution.

Step 5: Assess Ecosystem Health

Run a cross-project assessment evaluating federation health, coverage gaps, and vocabulary alignment.

Expected Output

Step 1/5: Register Facades ....................... OK
Step 2/5: Run Unified Search ..................... OK
Step 3/5: Build Ecosystem Knowledge Graph ........ OK
Step 4/5: Demonstrate Cross-Namespace Edges ...... OK
Step 5/5: Assess Ecosystem Health ................ OK

Demo complete: 5/5 steps passed (8.7 ms)

What You Will Learn

  • How to register and query ModelFacade instances
  • Cross-project search with vocabulary-mapped term normalization
  • Building federated knowledge graphs from multiple sources
  • Cross-namespace entity resolution with confidence scoring
  • Ecosystem health assessment and maturity evaluation

Next Steps