Skip to content

Commit 888065a

Browse files
author
Grace Lee Rui Yue
committed
Clarify finite partition verification scope
1 parent 614fdc4 commit 888065a

2 files changed

Lines changed: 32 additions & 4 deletions

File tree

src/jacobian/finite_partition.py

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,10 @@ def __init__(
195195
title="Partition an explicit finite domain",
196196
description=(
197197
"Materialize named cases over an explicit finite scope and optionally "
198-
"replay exact coverage and disjointness with an authorized checker."
198+
"replay exact coverage and disjointness with an authorized checker. "
199+
"Members and case labels are opaque caller-supplied strings; the "
200+
"checker does not establish their mathematical meaning or that the "
201+
"supplied universe exhausts an external domain."
199202
),
200203
provider="jacobian.finite",
201204
provider_runtime=known_provider_runtime(
@@ -397,7 +400,10 @@ def invoke(self, request: CapabilityRequest) -> CapabilityResult:
397400
"duplicate_case_ids": duplicate_case_ids,
398401
},
399402
scope=CapabilityScope(
400-
description="the exact supplied finite universe",
403+
description=(
404+
"the exact caller-supplied finite universe; external-domain "
405+
"completeness and member semantics are not checked"
406+
),
401407
parameters={"element_count": len(universe)},
402408
artifact_uri=scope.artifact_uri,
403409
),
@@ -408,7 +414,9 @@ def invoke(self, request: CapabilityRequest) -> CapabilityResult:
408414
else CapabilityCompletenessStatus.PARTIAL
409415
),
410416
basis=(
411-
"authorized checker replayed exact finite membership"
417+
"authorized checker replayed equality-based coverage and "
418+
"disjointness within the caller-supplied universe; it did not "
419+
"check external-domain completeness or member/case semantics"
412420
if verified
413421
else "generator-side membership accounting; not independently checked"
414422
),
@@ -435,7 +443,9 @@ def invoke(self, request: CapabilityRequest) -> CapabilityResult:
435443
assurance=CapabilityAssurance(
436444
level=assurance_level,
437445
basis=(
438-
"operator-authorized independent finite partition checker accepted"
446+
"operator-authorized checker accepted equality-based coverage and "
447+
"disjointness within the caller-supplied universe; external-domain "
448+
"completeness and member/case semantics were not checked"
439449
if verified
440450
else "partition was proposed and inspected by its generator only"
441451
),

tests/composition/runtime/test_finite_partition_capability.py

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,24 @@ def test_finite_partition_verify_replays_and_discharges_obligation(
6060
assert result.obligations[0].status is CapabilityObligationStatus.DISCHARGED
6161

6262

63+
def test_finite_partition_contract_and_result_preserve_semantic_boundary(
64+
authorized_complete_runtime,
65+
) -> None:
66+
runtime = authorized_complete_runtime
67+
descriptor = next(
68+
item
69+
for item in runtime.core.capabilities.catalog().capabilities
70+
if item.capability_id == "case.partition.finite"
71+
)
72+
result = runtime.core.capabilities.invoke(_request(CapabilityMode.VERIFY))
73+
74+
assert "opaque caller-supplied strings" in descriptor.description
75+
assert "does not establish their mathematical meaning" in descriptor.description
76+
assert "external-domain completeness" in result.scope.description
77+
assert "member/case semantics were not checked" in result.assurance.basis
78+
assert "member/case semantics" in result.completeness.basis
79+
80+
6381
def test_finite_partition_verify_fails_closed_on_incomplete_cases(
6482
authorized_complete_runtime,
6583
) -> None:

0 commit comments

Comments
 (0)