joint-schema 0.1.0__tar.gz

joint_schema-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: joint-schema
+Version: 0.1.0
+Summary: Multi-domain military operations schema: MIM operational concepts, DISARM influence operation TTPs, and STIX cyber threat intelligence
+License: TBD
+Project-URL: Homepage, https://github.com/tairnyn/joint-schema
+Project-URL: Repository, https://github.com/tairnyn/joint-schema
+Project-URL: Issues, https://github.com/tairnyn/joint-schema/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: linkml>=1.8.0
+Requires-Dist: linkml-runtime>=1.8.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: stix2>=3.0.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+
+# joint-schema
+
+Multi-domain military operations schema covering three integrated knowledge domains:
+
+| Domain | Description |
+|--------|-------------|
+| **MIM** | Military Information Model — operational concepts, units, tasks, effects |
+| **DISARM** | Influence operation Tactics, Techniques & Procedures (TTPs) |
+| **STIX** | Cyber threat intelligence objects bridged from STIX 2.1 |
+
+## Directory structure
+
+```
+joint-schema/
+├── schema/
+│   ├── core/       # Shared base classes, common types, enumerations
+│   ├── mim/        # MIM operational concept schemas (LinkML YAML)
+│   ├── disarm/     # DISARM TTP schemas (LinkML YAML)
+│   └── bridge/     # Cross-domain linkage / alignment schemas
+├── generated/      # Auto-generated artifacts (JSON Schema, Pydantic, OWL, …)
+├── llm-context/    # Bundled context files for LLM tooling
+├── docs/           # Documentation source and build output
+└── tests/          # Schema validation and integration tests
+```
+
+## Quickstart
+
+```bash
+# Python toolchain
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+
+# Node toolchain (DOCX generation)
+npm install
+
+# Run tests
+pytest
+```
+
+## Generating artifacts
+
+```bash
+# JSON Schema from a LinkML source file
+gen-json-schema schema/core/core.yaml > generated/core.schema.json
+
+# Pydantic models
+gen-pydantic schema/core/core.yaml > generated/core_models.py
+```

joint_schema-0.1.0/README.md

@@ -0,0 +1,49 @@
+# joint-schema
+
+Multi-domain military operations schema covering three integrated knowledge domains:
+
+| Domain | Description |
+|--------|-------------|
+| **MIM** | Military Information Model — operational concepts, units, tasks, effects |
+| **DISARM** | Influence operation Tactics, Techniques & Procedures (TTPs) |
+| **STIX** | Cyber threat intelligence objects bridged from STIX 2.1 |
+
+## Directory structure
+
+```
+joint-schema/
+├── schema/
+│   ├── core/       # Shared base classes, common types, enumerations
+│   ├── mim/        # MIM operational concept schemas (LinkML YAML)
+│   ├── disarm/     # DISARM TTP schemas (LinkML YAML)
+│   └── bridge/     # Cross-domain linkage / alignment schemas
+├── generated/      # Auto-generated artifacts (JSON Schema, Pydantic, OWL, …)
+├── llm-context/    # Bundled context files for LLM tooling
+├── docs/           # Documentation source and build output
+└── tests/          # Schema validation and integration tests
+```
+
+## Quickstart
+
+```bash
+# Python toolchain
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+
+# Node toolchain (DOCX generation)
+npm install
+
+# Run tests
+pytest
+```
+
+## Generating artifacts
+
+```bash
+# JSON Schema from a LinkML source file
+gen-json-schema schema/core/core.yaml > generated/core.schema.json
+
+# Pydantic models
+gen-pydantic schema/core/core.yaml > generated/core_models.py
+```

joint_schema-0.1.0/joint_schema.egg-info/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: joint-schema
+Version: 0.1.0
+Summary: Multi-domain military operations schema: MIM operational concepts, DISARM influence operation TTPs, and STIX cyber threat intelligence
+License: TBD
+Project-URL: Homepage, https://github.com/tairnyn/joint-schema
+Project-URL: Repository, https://github.com/tairnyn/joint-schema
+Project-URL: Issues, https://github.com/tairnyn/joint-schema/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: linkml>=1.8.0
+Requires-Dist: linkml-runtime>=1.8.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: stix2>=3.0.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+
+# joint-schema
+
+Multi-domain military operations schema covering three integrated knowledge domains:
+
+| Domain | Description |
+|--------|-------------|
+| **MIM** | Military Information Model — operational concepts, units, tasks, effects |
+| **DISARM** | Influence operation Tactics, Techniques & Procedures (TTPs) |
+| **STIX** | Cyber threat intelligence objects bridged from STIX 2.1 |
+
+## Directory structure
+
+```
+joint-schema/
+├── schema/
+│   ├── core/       # Shared base classes, common types, enumerations
+│   ├── mim/        # MIM operational concept schemas (LinkML YAML)
+│   ├── disarm/     # DISARM TTP schemas (LinkML YAML)
+│   └── bridge/     # Cross-domain linkage / alignment schemas
+├── generated/      # Auto-generated artifacts (JSON Schema, Pydantic, OWL, …)
+├── llm-context/    # Bundled context files for LLM tooling
+├── docs/           # Documentation source and build output
+└── tests/          # Schema validation and integration tests
+```
+
+## Quickstart
+
+```bash
+# Python toolchain
+python -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+
+# Node toolchain (DOCX generation)
+npm install
+
+# Run tests
+pytest
+```
+
+## Generating artifacts
+
+```bash
+# JSON Schema from a LinkML source file
+gen-json-schema schema/core/core.yaml > generated/core.schema.json
+
+# Pydantic models
+gen-pydantic schema/core/core.yaml > generated/core_models.py
+```

joint_schema-0.1.0/joint_schema.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+joint_schema.egg-info/PKG-INFO
+joint_schema.egg-info/SOURCES.txt
+joint_schema.egg-info/dependency_links.txt
+joint_schema.egg-info/requires.txt
+joint_schema.egg-info/top_level.txt
+tests/__init__.py
+tests/conftest.py
+tests/test_core_actors.py
+tests/test_core_events.py
+tests/test_core_locations.py
+tests/test_core_plans.py
+tests/test_core_platforms.py
+tests/test_core_resources.py
+tests/test_core_time.py

joint_schema-0.1.0/joint_schema.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

joint_schema-0.1.0/joint_schema.egg-info/requires.txt

@@ -0,0 +1,13 @@
+linkml>=1.8.0
+linkml-runtime>=1.8.0
+pydantic>=2.0.0
+stix2>=3.0.0
+PyYAML>=6.0
+jsonschema>=4.0.0
+click>=8.0.0
+
+[dev]
+build>=1.0.0
+pytest>=8.0.0
+pytest-cov>=5.0.0
+ruff>=0.4.0

joint_schema-0.1.0/joint_schema.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+schema
+tests

joint_schema-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "joint-schema"
+version = "0.1.0"
+description = "Multi-domain military operations schema: MIM operational concepts, DISARM influence operation TTPs, and STIX cyber threat intelligence"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "TBD" }
+dependencies = [
+    "linkml>=1.8.0",
+    "linkml-runtime>=1.8.0",
+    "pydantic>=2.0.0",
+    "stix2>=3.0.0",
+    "PyYAML>=6.0",
+    "jsonschema>=4.0.0",
+    "click>=8.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tairnyn/joint-schema"
+Repository = "https://github.com/tairnyn/joint-schema"
+Issues = "https://github.com/tairnyn/joint-schema/issues"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.0.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.4.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["schema*", "tests*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]

joint_schema-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

joint_schema-0.1.0/tests/conftest.py

@@ -0,0 +1,21 @@
+"""
+Shared pytest configuration for joint-schema tests.
+
+Adds the generated Pydantic models directory to sys.path so every test
+file can import generated models without package installation.
+
+The directory is resolved (in priority order) from:
+  1. GENERATED_PYTHON_DIR env var  — set by CI to /tmp/gen-pr
+  2. <repo_root>/generated/python/ — default for local development
+"""
+import os
+import sys
+import pathlib
+
+REPO_ROOT = pathlib.Path(__file__).parent.parent
+
+env_override = os.environ.get("GENERATED_PYTHON_DIR")
+GENERATED_PYTHON = pathlib.Path(env_override) if env_override else REPO_ROOT / "generated" / "python"
+
+if str(GENERATED_PYTHON) not in sys.path:
+    sys.path.insert(0, str(GENERATED_PYTHON))

joint_schema-0.1.0/tests/test_core_actors.py

@@ -0,0 +1,162 @@
+"""
+Tests for schema/core/actors.yaml — three-domain actor model.
+
+Generated models: generated/python/core__actors_models.py
+"""
+import pytest
+from pydantic import ValidationError
+
+from core__actors_models import (
+    MilitaryEchelon,
+    BranchOfService,
+    CombatantSide,
+    ThreatActorType,
+    ThreatActorSophistication,
+    ThreatActorMotivation,
+    InfluenceActorType,
+    MilitaryUnit,
+    ThreatActor,
+    InfluenceOperationActor,
+)
+
+
+# ── Test 1: MilitaryUnit — NATO/MIM compatible unit model ─────────────────────
+
+def test_military_unit_minimal_valid():
+    """MilitaryUnit with only required fields (id, name, side) is valid."""
+    unit = MilitaryUnit(
+        id="jsc:unit/3-bn-69-ar",
+        name="3rd Battalion, 69th Armor Regiment",
+        side=CombatantSide.FRIENDLY,
+    )
+
+    assert unit.id   == "jsc:unit/3-bn-69-ar"
+    assert unit.name == "3rd Battalion, 69th Armor Regiment"
+    assert unit.side == CombatantSide.FRIENDLY
+    # Optional fields absent
+    assert unit.echelon         is None
+    assert unit.parent_unit_id  is None
+    assert unit.branch_of_service is None
+
+
+def test_military_unit_full_hierarchy():
+    """MilitaryUnit with echelon, branch, designation, and parent link is valid."""
+    battalion = MilitaryUnit(
+        id="jsc:unit/3-bn-69-ar",
+        name="3-69 AR",
+        side=CombatantSide.FRIENDLY,
+        echelon=MilitaryEchelon.BATTALION,
+        branch_of_service=BranchOfService.ARMY,
+        unit_designation="3rd Battalion, 69th Armor Regiment",
+        parent_unit_id="jsc:unit/3-abct",
+        aliases=["Task Force IRON", "TF 3-69"],
+    )
+
+    assert battalion.echelon           == MilitaryEchelon.BATTALION
+    assert battalion.branch_of_service == BranchOfService.ARMY
+    assert battalion.unit_designation  == "3rd Battalion, 69th Armor Regiment"
+    assert battalion.parent_unit_id    == "jsc:unit/3-abct"
+    assert "Task Force IRON"           in battalion.aliases
+
+
+def test_military_unit_requires_side():
+    """MilitaryUnit without `side` must raise a ValidationError."""
+    with pytest.raises(ValidationError) as exc_info:
+        MilitaryUnit(id="jsc:unit/x", name="Unknown Unit")
+    fields = {e["loc"][0] for e in exc_info.value.errors()}
+    assert "side" in fields
+
+
+def test_military_unit_requires_id_and_name():
+    """MilitaryUnit without id or name must fail validation."""
+    with pytest.raises(ValidationError):
+        MilitaryUnit(side=CombatantSide.FRIENDLY)
+
+
+def test_military_unit_attribution_confidence_bounds():
+    """attribution_confidence must be in [0, 100]; values outside that range fail."""
+    # Boundary values are valid
+    lo = MilitaryUnit(id="jsc:unit/a", name="A", side=CombatantSide.HOSTILE, attribution_confidence=0)
+    hi = MilitaryUnit(id="jsc:unit/b", name="B", side=CombatantSide.HOSTILE, attribution_confidence=100)
+    assert lo.attribution_confidence == 0
+    assert hi.attribution_confidence == 100
+
+    with pytest.raises(ValidationError):
+        MilitaryUnit(id="jsc:unit/c", name="C", side=CombatantSide.HOSTILE, attribution_confidence=101)
+    with pytest.raises(ValidationError):
+        MilitaryUnit(id="jsc:unit/d", name="D", side=CombatantSide.HOSTILE, attribution_confidence=-1)
+
+
+# ── Test 2: ThreatActor — STIX-mapped adversary model ─────────────────────────
+
+def test_threat_actor_nation_state():
+    """ThreatActor of type NATION_STATE with sophistication and motivation."""
+    actor = ThreatActor(
+        id="stix:threat-actor--12345678-1234-1234-1234-123456789abc",
+        name="APT-X",
+        threat_actor_types=[ThreatActorType.NATION_STATE],
+        sophistication=ThreatActorSophistication.ADVANCED,
+        primary_motivation=ThreatActorMotivation.IDEOLOGY,
+        aliases=["Fancy Bear", "Sofacy", "APT28"],
+    )
+
+    assert ThreatActorType.NATION_STATE         in actor.threat_actor_types
+    assert actor.sophistication                  == ThreatActorSophistication.ADVANCED
+    assert actor.primary_motivation             == ThreatActorMotivation.IDEOLOGY
+    assert "Fancy Bear"                          in actor.aliases
+
+
+def test_threat_actor_minimal():
+    """ThreatActor with only id and name is valid (all other fields optional)."""
+    actor = ThreatActor(
+        id="jsc:actor/unknown-threat",
+        name="Unknown Threat Actor",
+    )
+
+    assert actor.threat_actor_types is None
+    assert actor.sophistication     is None
+
+
+def test_threat_actor_stix_uri_id():
+    """ThreatActor id accepts a full STIX URN format."""
+    actor = ThreatActor(
+        id="stix:threat-actor--aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+        name="STIX Actor",
+    )
+    assert actor.id.startswith("stix:")
+
+
+# ── Test 3: InfluenceOperationActor — DISARM-mapped influence actor ────────────
+
+def test_influence_actor_state_media():
+    """InfluenceOperationActor of type STATE_ALIGNED_MEDIA is valid."""
+    actor = InfluenceOperationActor(
+        id="jsc:actor/rt-network",
+        name="RT Network",
+        influence_actor_type=InfluenceActorType.STATE_ALIGNED,
+        active_platforms=["YouTube", "Telegram", "X/Twitter"],
+        attributed_to_state_id="jsc:actor/russian-federation",
+        attribution_confidence=78,
+        influence_capabilities=["broadcast television", "social media amplification"],
+    )
+
+    assert actor.influence_actor_type    == InfluenceActorType.STATE_ALIGNED
+    assert "Telegram"                    in actor.active_platforms
+    assert actor.attribution_confidence  == 78
+    assert "broadcast television"        in actor.influence_capabilities
+
+
+def test_influence_actor_requires_id_and_name():
+    """InfluenceOperationActor without id and name must fail."""
+    with pytest.raises(ValidationError):
+        InfluenceOperationActor()
+
+
+def test_influence_actor_attribution_confidence_optional():
+    """attribution_confidence is optional; absent means unasserted."""
+    actor = InfluenceOperationActor(
+        id="jsc:actor/anon-troll-farm",
+        name="Anonymous Troll Farm",
+    )
+    assert actor.attribution_confidence  is None
+    assert actor.attributed_to_state_id  is None