experiment-core 0.1.0__tar.gz

experiment_core-0.1.0/.secrets.baseline

@@ -0,0 +1,123 @@
+{
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "generated_at": "2026-10-30T16:34:54Z",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "limit": 4.5,
+      "name": "Base64HighEntropyString"
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "limit": 3.0,
+      "name": "HexHighEntropyString"
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "keyword_exclude": "",
+      "name": "KeywordDetector"
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "results": {},
+  "version": "1.5.0"
+}

experiment_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FanHarvard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

experiment_core-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE README.md
+recursive-include docs *.html
+recursive-include scripts *.py
+recursive-include tests *.py *.cjs *.json *.yaml
+recursive-include examples *.json
+global-exclude __pycache__ *.py[cod] .env .pypirc *.pem *.key
+include .secrets.baseline

experiment_core-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: experiment-core
+Version: 0.1.0
+Summary: Domain-neutral contracts and local runtime for supervised experimental operations
+Author: FanHarvard contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/FanHarvard/experiment-core
+Project-URL: Repository, https://github.com/FanHarvard/experiment-core
+Project-URL: Issues, https://github.com/FanHarvard/experiment-core/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema<5,>=4.19
+Dynamic: license-file
+
+# experiment-core
+
+**Still in active development.**
+
+Small, domain-neutral contracts and a local runtime for supervised experiments:
+bounded operations, resource ownership, durable intent/result records,
+cancellation, explicit approvals and immutable artifacts.
+
+```sh
+pip install experiment-core
+```
+
+Python 3.10+; depends only on `jsonschema`. No LDCon, agentbridge, provider CLI
+or hardware dependency. Host applications supply authentication and physical
+device adapters; unknown writes are never replayed automatically.
+
+Tests cover schemas, lifecycle transitions, resource conflicts, cancellation,
+approval/adoption and recovery of recorded operations. Run `python -m pytest -q`.
+The process-locking runtime is tested on Linux.
+
+[JSON examples](examples/) · [Publishing](docs/publishing.html) · [MIT license](LICENSE)

experiment_core-0.1.0/README.md

@@ -0,0 +1,21 @@
+# experiment-core
+
+**Still in active development.**
+
+Small, domain-neutral contracts and a local runtime for supervised experiments:
+bounded operations, resource ownership, durable intent/result records,
+cancellation, explicit approvals and immutable artifacts.
+
+```sh
+pip install experiment-core
+```
+
+Python 3.10+; depends only on `jsonschema`. No LDCon, agentbridge, provider CLI
+or hardware dependency. Host applications supply authentication and physical
+device adapters; unknown writes are never replayed automatically.
+
+Tests cover schemas, lifecycle transitions, resource conflicts, cancellation,
+approval/adoption and recovery of recorded operations. Run `python -m pytest -q`.
+The process-locking runtime is tested on Linux.
+
+[JSON examples](examples/) · [Publishing](docs/publishing.html) · [MIT license](LICENSE)

experiment_core-0.1.0/docs/publishing.html

@@ -0,0 +1,33 @@
+<!doctype html><html lang="en"><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1"><title>Publishing experiment-core</title>
+<style>body{font:16px/1.7 system-ui;max-width:900px;margin:3rem auto;padding:0 1rem}pre{background:#f2f4f6;padding:1rem;overflow:auto}code{font-size:.9em}</style>
+<h1>Publishing experiment-core</h1><p>Public repository: <a href="https://github.com/FanHarvard/experiment-core">FanHarvard/experiment-core</a>.
+Initial version: 0.1.0. No production service is activated by publication.</p>
+<h2>One-time PyPI setup</h2><p>A PyPI account owner creates a pending publisher at
+<a href="https://pypi.org/manage/account/publishing/">PyPI publishing settings</a> with:</p>
+<table><tr><th>Project name</th><td>experiment-core</td></tr><tr><th>Owner</th><td>FanHarvard</td></tr>
+<tr><th>Repository</th><td>experiment-core</td></tr><tr><th>Workflow</th><td>release.yml</td></tr>
+<tr><th>Environment</th><td>pypi</td></tr></table>
+<p>Use the repository's <code>pypi</code> environment to restrict release access. Authentication uses
+GitHub OIDC and PyPI Trusted Publishing; no long-lived PyPI API token belongs in this repository.
+See the <a href="https://docs.pypi.org/trusted-publishers/creating-a-project-through-oidc/">official PyPI setup</a>.</p>
+<h2>Release</h2><p>Publish experiment-core before LDCon. LDCon pins the verified compatible core version.
+Update package metadata and the LDCon CI core tag together for a future version.</p>
+<pre>python -m build
+python -m twine check --strict dist/*
+python scripts/check_dist.py dist
+python scripts/check_secrets.py
+python -m pytest -q
+git tag v0.1.0
+git push origin v0.1.0</pre>
+<p>Create a GitHub Release for the tag to run <code>release.yml</code>, or dispatch that workflow at
+the tag. The workflow checks the tag against package metadata, builds and audits distributions,
+tests the wheel, and publishes through the dedicated environment. Do not reuse an uploaded PyPI version.
+The CI workflow also checks Python 3.10, 3.12 and 3.13.</p>
+<h2>Public/private boundary</h2><p>Public: source, tests, documentation, MIT license and reviewed examples.
+Private: credentials, .env/.pypirc files, runtime databases, job logs, agent conversations,
+approval receipts, local deployment history and live service configuration. New public repositories
+start from a reviewed snapshot; the internal Git history is not uploaded.</p>
+<p>The secret scanner compares findings against individually reviewed non-secret fixtures and code
+literals in <code>.secrets.baseline</code>. New findings fail CI. This complements artifact inspection;
+it is not a proof that arbitrary future data is safe to publish.</p></html>

experiment_core-0.1.0/examples/capabilities.json

@@ -0,0 +1,51 @@
+{
+  "version": "0.1",
+  "kind": "capabilities",
+  "message_id": "capabilities-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "revisions": {
+      "configuration": "cfg-1",
+      "policy": "policy-1",
+      "owner_state": "state-1"
+    },
+    "operations": [
+      {
+        "capability_id": "fixture.measure_point",
+        "effect": "control",
+        "access": "attached",
+        "resource_ids": [
+          "axis-a"
+        ],
+        "available": true,
+        "reason": "",
+        "parameter_schema_id": "fixture.point.v1",
+        "result_schema_id": "fixture.point-result.v1",
+        "adoption_boundaries": [
+          "between_points"
+        ]
+      }
+    ],
+    "parameters": [
+      {
+        "parameter_id": "axis.max_step",
+        "value_schema_id": "fixture.distance.v1",
+        "unit": "mm",
+        "owner_role": "application",
+        "classification": "safety",
+        "approval": "exact_human_approval",
+        "adoption": "live_boundary",
+        "boundaries": [
+          "between_points"
+        ],
+        "coupled_group": "axis-motion",
+        "validator_id": "fixture.motion-proof.v1",
+        "enforcement_scope": [
+          "host_command"
+        ]
+      }
+    ]
+  }
+}

experiment_core-0.1.0/examples/empty-quality.json

@@ -0,0 +1,25 @@
+{
+  "version": "0.1",
+  "kind": "operation_status",
+  "message_id": "operation_status-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "request_id": "request-1",
+    "state": "running",
+    "effect_state": "confirmed",
+    "revisions": {
+      "configuration": "cfg-1",
+      "policy": "policy-1",
+      "owner_state": "state-1"
+    },
+    "objective": "not_evaluated",
+    "quality": {
+      "state": "not_configured",
+      "evaluators": []
+    },
+    "reason": "No optional quality evaluator configured.",
+    "artifacts": []
+  }
+}

experiment_core-0.1.0/examples/fixture-decision.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.1",
+  "kind": "decision",
+  "message_id": "decision-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "observation_id": "obs-1",
+    "expected": {
+      "configuration": "cfg-1",
+      "policy": "policy-1",
+      "owner_state": "state-1"
+    },
+    "action": "execute",
+    "capability_id": "fixture.measure_point",
+    "parameter_schema_id": "fixture.point.v1",
+    "parameters": {
+      "position_mm": 1.2
+    },
+    "reason": "Measure the next point in the approved interval."
+  }
+}

experiment_core-0.1.0/examples/fixture-measurement.json

@@ -0,0 +1,32 @@
+{
+  "version": "0.1",
+  "kind": "measurement",
+  "message_id": "measurement-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "observation_id": "obs-1",
+    "revisions": {
+      "configuration": "cfg-1",
+      "policy": "policy-1",
+      "owner_state": "state-1"
+    },
+    "observed_at": "2026-10-23T22:00:00-04:00",
+    "metrics": [
+      {
+        "quantity_id": "temperature",
+        "unit": "K",
+        "value": 295.1,
+        "state": "valid",
+        "source_time": "2026-10-23T21:59:59-04:00",
+        "reason": ""
+      }
+    ],
+    "quality": {
+      "state": "not_configured",
+      "evaluators": []
+    },
+    "artifacts": []
+  }
+}

experiment_core-0.1.0/examples/operation-request.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.1",
+  "kind": "operation_request",
+  "message_id": "operation_request-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "capability_id": "fixture.measure_point",
+    "parameter_schema_id": "fixture.point.v1",
+    "parameters": {
+      "position_mm": 1.2
+    },
+    "expected": {
+      "configuration": "cfg-1",
+      "policy": "policy-1",
+      "owner_state": "state-1"
+    },
+    "parent_run_id": null,
+    "execution_mode": "manual",
+    "reason": "Example operation request; not authorized by schema validation."
+  }
+}

experiment_core-0.1.0/examples/policy-deferred.json

@@ -0,0 +1,17 @@
+{
+  "version": "0.1",
+  "kind": "policy_status",
+  "message_id": "policy_status-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "proposal_id": "proposal-1",
+    "state": "deferred",
+    "desired_revision": "policy-2",
+    "effective_revision": "policy-1",
+    "hardware_revision": null,
+    "boundary": "between_points",
+    "reason": "Current admitted trajectory still uses policy-1."
+  }
+}

experiment_core-0.1.0/examples/policy-proposal.json

@@ -0,0 +1,19 @@
+{
+  "version": "0.1",
+  "kind": "policy_proposal",
+  "message_id": "policy_proposal-1",
+  "subject_id": "fixture-a",
+  "run_id": "run-a",
+  "issued_at": "2026-10-23T22:00:00-04:00",
+  "body": {
+    "expected_policy_revision": "policy-1",
+    "changes": [
+      {
+        "parameter_id": "axis.max_step",
+        "old": 0.1,
+        "new": 0.2
+      }
+    ],
+    "reason": "Draft example only; no approval or physical operation."
+  }
+}

experiment_core-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "experiment-core"
+version = "0.1.0"
+description = "Domain-neutral contracts and local runtime for supervised experimental operations"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "FanHarvard contributors"}]
+classifiers = ["Development Status :: 3 - Alpha",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Operating System :: POSIX :: Linux",
+  "Topic :: Scientific/Engineering",
+]
+dependencies = ["jsonschema>=4.19,<5"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+experiment_core = ["schemas/*.json"]
+
+[project.urls]
+Homepage = "https://github.com/FanHarvard/experiment-core"
+Repository = "https://github.com/FanHarvard/experiment-core"
+Issues = "https://github.com/FanHarvard/experiment-core/issues"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--import-mode=importlib"
+norecursedirs = ["support"]

experiment_core-0.1.0/scripts/check_dist.py

@@ -0,0 +1,28 @@
+"""Audit source/wheel contents and strongly identifiable credential formats."""
+from pathlib import Path, PurePosixPath
+import re
+import sys
+import tarfile
+import zipfile
+
+pattern = re.compile(rb'(?:gh[pousr]_[A-Za-z0-9_]{30,}|github_pat_[A-Za-z0-9_]{30,}|pypi-[A-Za-z0-9_-]{30,}|AKIA[A-Z0-9]{16}|-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----)')
+for artifact in sorted(Path(sys.argv[1]).iterdir()):
+    if artifact.suffix == '.whl':
+        with zipfile.ZipFile(artifact) as archive:
+            items = [(n, archive.read(n)) for n in archive.namelist() if not n.endswith('/')]
+    elif artifact.name.endswith('.tar.gz'):
+        with tarfile.open(artifact) as archive:
+            items = [(m.name.partition('/')[2], archive.extractfile(m).read()) for m in archive if m.isfile()]
+    else:
+        raise SystemExit('Unexpected distribution file: ' + artifact.name)
+    for name, data in items:
+        path = PurePosixPath(name)
+        if path.is_absolute() or '..' in path.parts:
+            raise SystemExit('Invalid archive path: ' + name)
+        if any(p in {'.git', '.venv', '__pycache__', 'node_modules', '.env', '.pypirc'} for p in path.parts) or path.suffix in {'.pem', '.key', '.sqlite3', '.jsonl', '.pyc'}:
+            raise SystemExit('Private/generated file in artifact: ' + name)
+        if artifact.suffix == '.whl' and any(p in {'tests', 'support'} for p in path.parts):
+            raise SystemExit('Test data in wheel: ' + name)
+        if pattern.search(data):
+            raise SystemExit('Potential credential in artifact (redacted): ' + name)
+    print(artifact.name, len(items), 'files audited')

experiment_core-0.1.0/scripts/check_secrets.py

@@ -0,0 +1,19 @@
+"""Fail on newly detected secrets without printing their values."""
+import json
+from pathlib import Path
+import subprocess
+import sys
+
+baseline = json.loads(Path('.secrets.baseline').read_text())
+allowed = {(p, item['type'], item['hashed_secret']) for p, items in baseline['results'].items()
+           for item in items if item.get('is_secret') is False}
+result = subprocess.run([sys.executable, '-m', 'detect_secrets', 'scan', '--no-verify', '--exclude-files', r'^\.secrets\.baseline$'],
+                        check=True, capture_output=True, text=True)
+current = json.loads(result.stdout)
+findings = [(p, item['line_number'], item['type']) for p, items in current['results'].items()
+            for item in items if (p, item['type'], item['hashed_secret']) not in allowed]
+for path, line, kind in findings:
+    print(f'{path}:{line}: {kind} (value redacted)')
+if findings:
+    raise SystemExit('Unreviewed potential credential detected')
+print('No unreviewed credential findings')

experiment_core-0.1.0/scripts/check_tag.py

@@ -0,0 +1,12 @@
+"""Refuse a release from a branch or a tag for another version."""
+from email.parser import BytesParser
+import os
+from pathlib import Path
+import zipfile
+
+wheel, = Path('dist').glob('*.whl')
+with zipfile.ZipFile(wheel) as archive:
+    metadata, = [n for n in archive.namelist() if n.endswith('.dist-info/METADATA')]
+    version = BytesParser().parsebytes(archive.read(metadata))['Version']
+if os.environ.get('GITHUB_REF') != 'refs/tags/v' + version:
+    raise SystemExit('Run this release at tag v' + version)

experiment_core-0.1.0/scripts/install_wheel.py

@@ -0,0 +1,11 @@
+"""Install the built wheel, including declared role extras for LDCon."""
+from pathlib import Path
+import subprocess
+import sys
+
+wheels = list(Path('dist').glob('*.whl'))
+if len(wheels) != 1:
+    raise SystemExit('Expected exactly one wheel')
+wheel = wheels[0]
+extras = '[web,instruments,analysis]' if wheel.name.startswith('ldcon-') else ''
+subprocess.run([sys.executable, '-m', 'pip', 'install', str(wheel.resolve()) + extras], check=True)

experiment_core-0.1.0/setup.cfg

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

experiment_core-0.1.0/src/experiment_core/__init__.py

@@ -0,0 +1,8 @@
+"""Domain-neutral contracts and an explicit local reference runtime.
+
+Runtime components are imported from their documented modules. Importing this
+package does not create stores, register applications or contact any service.
+"""
+from experiment_core.validation import ContractError, schema, validate_message
+
+__all__ = ["ContractError", "schema", "validate_message"]

experiment_core-0.1.0/src/experiment_core/adjustment_guidance.py

@@ -0,0 +1,49 @@
+"""Advisory proposal sizes; never physical limits or execution authority."""
+from copy import deepcopy
+import math
+
+from experiment_core.records import digest, safe_id
+
+
+def validate(value):
+    if (not isinstance(value, dict) or set(value) != {'schema_version', 'knobs'}
+            or type(value['schema_version']) is not int or value['schema_version'] != 1
+            or not isinstance(value['knobs'], dict) or len(value['knobs']) > 128):
+        raise ValueError('Expected versioned per-knob adjustment guidance')
+    for name, item in value['knobs'].items():
+        safe_id(name)
+        if not isinstance(item, dict) or set(item) != {'kind', 'step', 'unit', 'reason'}:
+            raise ValueError('Guidance requires kind, step, unit and reason')
+        if item['kind'] not in ('absolute', 'relative'):
+            raise ValueError('Guidance kind must be absolute or relative')
+        if type(item['step']) not in (int, float) or not math.isfinite(item['step']) or item['step'] <= 0:
+            raise ValueError('Suggested step must be positive and finite')
+        for key, maximum in (('unit', 64), ('reason', 1024)):
+            text = item[key]
+            if (not isinstance(text, str) or not text.strip() or len(text.encode()) > maximum
+                    or any(ord(c) < 32 or ord(c) == 127 for c in text)):
+                raise ValueError('Invalid guidance '+key)
+        if item['kind'] == 'relative' and item['unit'] != 'fraction':
+            raise ValueError('Relative advice uses a dimensionless fraction of the current magnitude')
+    return deepcopy(value)
+
+
+def snapshot(value):
+    value = validate(value)
+    return dict(document=value, revision=digest(value), advisory_only=True,
+                interpretation='An initial proposal size, not a minimum, maximum, safety limit or permission')
+
+
+def instructions():
+    return ('Per-knob adjustment_guidance is advisory, not an execution bound. Start a local comparison '
+            'near the suggested initial step when it is appropriate to the current evidence. An absolute '
+            'step uses the stated physical unit; a relative step is a fraction of the magnitude of the '
+            'current parameter, not of its allowed range. Relative advice at zero does not define a step. '
+            'Use previous comparable responses, sensitivity, resolution, drift and recovery cost to choose '
+            'a smaller or larger step, and explain deviations in the decision reason. A permitted excursion '
+            'is not a recommended trial step: never select half the allowed span merely because it is allowed. '
+            'Characterization mode does not remove this distinction. Enlarge only when observations support '
+            'it; reduce after a large response or loss of the branch. Missing guidance means unknown, not '
+            'permission to use the range endpoint. Read current adjustment guidance before planning a new knob '
+            'trial if no current guidance snapshot was supplied. Advice alone never changes output, supported '
+            'capabilities, approved envelopes, physical limits, freshness requirements or foreground priority.')