Apps Common
Purpose
This stable entry point preserves compatibility for callers that invoke
core/fusion-api/apps-common. Select and follow exactly one nested skill;
callers that already know the feature may invoke that nested skill directly.
Route the Request
| Calling context | Nested skill |
|---|---|
| Lookup type, lookup code, translation, or reference-data set | lookups |
| Descriptive Flexfield (DFF) setup task | descriptive-flexfields |
| Extensible Flexfield (EFF) request | extensible-flexfields |
| Attachment entity, category, or file-format setup task | attachments |
| Key Flexfield (KFF) request | key-flexfields |
| Effective or configured profile option value | profile-options |
| Tree or tree-version request | trees |
| Value set, validation table, or value-set value | value-sets |
If the request crosses these boundaries, route each independently. Do not use this router to select a REST endpoint or substitute a direct client call for a nested workflow.
DFF, EFF, and KFF setup-task exports route through
shared.setup-export.task-level-export. Their setup-task imports route through
core.data-loader as FSM CSV Import after the respective nested skill
resolves task context and verifies its eligibility.
Shared Boundaries
Nested skills use the shared REST client or the declared setup-task workflow. They require target, operation, resource identity, and body validation before an external operation; writes require explicit approval immediately before the declared execution step. Do not retry a mutating request automatically.
Preflight and Error Handling
Preflight the selected nested skill's inputs, target environment, privileges,
resource identity, and approval gate before an external operation. Classify a
failure using governance/error-handling-guidelines.md and return the selected
route plus safe next action. Redact credentials, bearer tokens, headers, and
sensitive feature values from diagnostics and audit summaries.
Run the focused offline contract tests from the repository root:
for test_dir in core/fusion-api/apps-common/*/tests; do
python3 -m unittest discover -s "$test_dir" -p 'test_*.py' -v
done