Skip to main content

snapIsoToGranularity

8.0.0 engine API transition

This method is a candidate for removal from production governors and engine exports at 8.0.0. Its 7.x route has not been removed. Final removal and standalone package-export decisions require the per-method review and external-integrator confirmation described in the transition index.

Source-local contract​

The declaration below is copied from the pinned source revision; referenced types are defined there. It is an implementation signature, not a package import example.

/**
 * Snap an ISO datetime's time component to the nearest granularity boundary.
 * Returns a new ISO datetime string with the snapped time.
 *
 * @param iso - ISO datetime string (e.g. '2026-06-15T10:07:00')
 * @param granularity - Granularity in minutes
 * @param mode - Rounding mode
 */
export function snapIsoToGranularity(
  iso: string,
  granularity: number,
  mode: 'floor' | 'ceil' | 'round' = 'round',
): string;

Engine effects​

State writes: not yet assessed. Notices: not yet assessed. Governor query/mutate placement is not proof of purity; review the implementation and engine path before deciding exposure.

Consumer evidence​

The refreshed source-name scan found no name mentions in the scanned product source files. This does not establish external-integrator non-use. The manifest records repository revisions and scan exclusions. External-integrator confirmation is pending.

Availability and ownership​

  • Production governor declarations: availabilityGovernor.
  • Standalone package API after 8.0.0: decision pending; this page does not establish a supported import.
  • Implementation: src/assemblies/governors/availabilityGovernor/timeGranularity.ts — snapIsoToGranularity. Source paths and aliases are not package import paths.
  • Replacement workflow: not yet established; no supported replacement is promised.
  • Test-only adapters: may exercise this implementation independently of production engine exports; this is not evidence of product use.

Implementation contract​

This candidate had no dedicated governor method section to relocate. Its existing explanations remain at the documentation links below. Consult the linked source for its current signature, state requirements, returns and refusal behavior; this index does not invent a new supported contract.