feat(integrations): expand Oracle Fusion HCM workforce payroll talent and time

[BillLeoutsakosvl346]

Summary

Expands the existing Oracle Fusion Cloud HCM integration to 76 tools (67 reads, nine writes) in one block: 18 workforce/absence tools preserved, plus 21 payroll-record/result, seven compensation, 16 talent/performance, and 14 Time and Labor tools. Preserves the original four selectors and adds 12 credential-bound selectors.

Stacked directly on #7427, feat/oracle-fusion-foundation at 15294a2b40aaeb176f6ec79599ce790eadd969e9. The original HCM commit is its direct child, with expansion following it. No foundation implementation or shared behavioral changes.

Scope and contracts

• Dedicated payroll relationships, payroll/HR assignment identity, assigned payrolls, configuration discovery, element entries/values, processing results, run results, and contextual balance slots.
• Salary history by HR assignment without current-directory membership; salary bases/components/grade values; administrative creation and correction limited to user-entered salary bases. No approval submission.
• Read-only goal plans, performance/development goals, performance document roles/participants/tasks, and secured talent skill/certification sections/items.
• Time records/cards, attribute configuration and value discovery, fixed ADD/UPDATE/DELETE POST intake, request/event/message inspection. Asynchronous acceptance is not processing completion, approval, or payroll transfer.
• Explicit typed allowlists, exact nested integer requests, documented nullable/string fields, bounded one-page reads, validated opaque keys/self-links, cancellation, and non-retryable ambiguous mutations.
• Existing workforce projections are unchanged, without payroll/salary/talent enrichment. Selector metadata omits amounts/results.
• Reuses the existing NetSuiteIcon and foundation credentials/transport. No new routes, API-contract files, block tests, auth classification, icons, shared generators, or manual report files.

Recruiting, Learning, payroll-flow orchestration, tax/payment administration, approval-sensitive talent writes, device ingestion, and third-party transfer acknowledgements remain excluded.

Validation

Independent read-only validate-integration, validate-selector, and memory-load-check source review is approved, with no unresolved HCM correctness/contract findings. Review corrections cover documented time combinations and partial updates, deliberate element value clearing (explicit null or a model-expressible clear flag, using the existing Ashby precedent), nullable list identifiers, optional selector context, and authoring guidance.

Final revision: 4c4bfd00cb9bebcb061199dbb37aa1850a23c957.

• GitHub Test and Build: passed — lint, repository/registry-boundary/generated-metadata audits, docs-manifest check, all workspace type checks, all three test shards, and Build App.
• All 249 HCM-specific tests passed across the existing operation, schema, executor, selector, and tool-contract suites; existing selector-manifest coverage also passed.
• Greptile: 5/5, explicitly covering the final revision above.
• All review threads resolved; PR remains mergeable against the unchanged foundation base.
• This feature-branch stack uses the existing workflow's explicit dispatch because the automatic CI PR trigger does not include the foundation base. Its diff-based audit base is the workflow's existing HEAD~1 fallback; the independent source review additionally covered the complete foundation-relative HCM implementation and original-contract preservation.
• Cubic was not triggered or required for this handoff.

No local tests, builds, lint checks, type checks, or audits were run. Approved metadata/docs generators were run. No live-tenant writes were performed. Tests use official-documentation-grounded fixtures.

Boundaries and precedents

Expansion follows the approved file tree: one declaration per tool; extensions to existing HCM schema/projector/operations/executor/block/provider/tests; existing registries and generated metadata/catalog/docs only. Main precedents are the original HCM implementation, Workday compensation, NetSuite closed resource variants, Rocketlane time inputs, and Fusion SCM exact-integer mutation transport. Nullable direct execution follows tools/ashby/set_custom_field_value.ts; the explicit clear flag follows tools/ashby/update_candidate.ts and its block/tests; optional selector dependencies follow blocks/blocks/microsoft_excel.ts.

Foundation PR change requests: None. The shared required-parameter/null and model-schema nullable-scalar limitations are handled locally with the established Ashby clear-flag pattern, not shared changes. No file-tree deviations.

Oracle evidence and tenant prerequisites

• HCM REST API
• Payroll relationships
• Element entry creation
• Salary creation
• Performance documents
• Secured talent profiles
• Time intake
• Partial time updates

Before production, verify licensed/provisioned modules, country/LDG configuration, least-privilege data access, effective-dating behavior, supported salary bases, time attributes/reasons, and asynchronous processing in an explicitly authorized non-production tenant.

Leave open for human merge after the foundation. No auto-merge.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
docs	Skipped		Sep 6, 2026 12:41am UTC

[greptile-apps]

Greptile Summary

Expands Oracle Fusion Cloud HCM from workforce and absence support into payroll, compensation, talent, performance, and Time and Labor, providing 76 tools and 12 additional credential-bound selectors.

• Adds read and administrative-write operations with typed validation, projections, and generated tool metadata.
• Adds selector providers, documentation, registry integration, and mocked contract coverage.
• Preserves exact Oracle integer identifiers in mutation request bodies and constrains asynchronous time-entry intake to fixed operations.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/sim/lib/internal/oracle-fusion-hcm/operations.ts	Implements the expanded HCM read and mutation operations, including exact-integer request serialization and fixed asynchronous time-entry intake.
apps/sim/lib/internal/oracle-fusion-hcm/execute-tool.ts	Dispatches the expanded Oracle HCM tool set through validated operation handlers.
apps/sim/lib/internal/oracle-fusion-hcm/schema.ts	Defines validation contracts for payroll, compensation, talent, performance, and time operations.
apps/sim/lib/internal/oracle-fusion-hcm/projectors.ts	Projects Oracle responses into bounded integration-specific output shapes.
apps/sim/lib/selectors/server/providers/oracle-fusion-hcm.ts	Adds credential-bound option discovery for the expanded HCM resources.
apps/sim/blocks/blocks/oracle_fusion_hcm.ts	Exposes the expanded tool and selector configuration through the Oracle Fusion HCM block.
apps/docs/content/docs/integrations/oracle_fusion_hcm.mdx	Documents the 76-tool integration, operational boundaries, sensitive-data handling, and asynchronous time-entry behavior.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  W[Workflow tool input] --> V[HCM schema validation]
  V --> E[Tool executor]
  E --> O[Oracle HCM operation]
  O --> T[Shared Oracle Fusion transport]
  T --> A[Oracle Fusion HCM REST API]
  A --> P[Typed projection]
  P --> R[Workflow output]
  S[Credential-bound selectors] --> O

Loading

_{Reviews (20): Last reviewed commit: "style(oracle-hcm): finish source declara..." | Re-trigger Greptile}

[cubic-dev-ai]

All reported issues were addressed across 31 files

_{Re-trigger cubic}

[BillLeoutsakosvl346]

@greptile-apps @cubic-dev-ai please re-review the latest commit (20724c1), including the fixes and dispositions on the prior review threads.

[cubic-dev-ai]

@greptile-apps @cubic-dev-ai please re-review the latest commit (20724c1), including the fixes and dispositions on the prior review threads.

@BillLeoutsakosvl346 Incremental reviews are turned off for this repository. Comment @cubic review to run a full review.

[cubic-dev-ai]

All reported issues were addressed across 44 files

_{Fix all with cubic | Re-trigger cubic}

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@BillLeoutsakosvl346 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

All reported issues were addressed across 45 files

_{Fix all with cubic | Re-trigger cubic}

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@BillLeoutsakosvl346 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 45 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@BillLeoutsakosvl346 I have started the AI code review. It will take a few minutes to complete.

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile

[BillLeoutsakosvl346]

@greptile