Skip to content

Diff Directory Node

Data/Files/Operations

Diffs a folder against a manifest, emitting added, updated and deleted files while ignoring directory manifests. Auto mode trusts store ETags (hashing only weak/missing ones); Checksum mode always Blake3-hashes contents

path_get_changesdata
Inputs5
Outputs5
Security exposure8/10
Packagedata

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
8/10High
PrivacyPotential sensitivity of processed data.
8/10High
PerformanceRuntime or resource pressure.
9/10High
GovernancePolicy, audit, or compliance impact.
7/10High
ReliabilityOperational stability considerations.
8/10High
CostExternal or compute cost impact.
9/10High

Input Pins

5

Input

Execution
exec_in

Initiate Execution

Manifest

Struct
manifest

FlowPath to this workflow's manifest file. It may have any name and need not exist yet; use a distinct name when workflows share a root

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null
Schema enforced

Root

Struct
root

Root folder to scan for changes

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null
Schema enforced

Recursive

Boolean
recursive

Scan the root folder recursively

Default true

Change Detection

String
mode

Auto: trust store ETags, hashing only files with a missing/weak ETag (fast). Checksum: always Blake3-hash contents, ignoring ETags (correct on backends with mtime-based ETags such as local disk)

Default Auto
AutoChecksum

Output Pins

5

Output

Execution
exec_out

Done with the Execution

Added

Struct Array
added

Files present in the folder but not in the manifest

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null

Updated

Struct Array
updated

Files whose ETag/hash changed since the manifest

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null

Deleted

Struct Array
deleted

Files in the manifest that no longer exist in the folder

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null

Session

Struct
session

Diff session carrying the next manifest, feed into 'Write Directory Manifest'

DirDiffSessionDirDiffSession4 fields
manifestFlowPathrequired

Where the manifest lives / should be written.

pathstringrequired
store_refstringrequired
cache_store_refstring | null
rootanyOf (2)

Root that was scanned. Required when committing selected paths.

default null
variant 1FlowPathvariant
pathstringrequired
store_refstringrequired
cache_store_refstring | null
variant 2nullvariant
ignored_manifest_pathsArray<string>

Manifest files omitted from the snapshot and safe to purge from older baselines.

default []
itemsstringarray item
manifest_contentDirManifestrequired

The next manifest to persist, reflecting the current directory state.

$flow_like_manifestManifestKind

Content marker used to exclude manifests from directory diffs regardless of name.

enum "flow-like.directory-manifest"default "flow-like.directory-manifest"
versioninteger:uint32
format uint32default 0min 0
recursiveboolean

Whether the snapshot was taken recursively. Diffs against a manifest with a different scope skip deletion detection to avoid falsely reporting out-of-scope files as deleted.

default false
entriesArray<ManifestEntry>
default []
itemsManifestEntryarray item

A single tracked file inside a manifest. Change detection prefers a `hash` when present, else the store `e_tag`. Trusted ETags avoid a full-content hash read; `hash` is populated in Checksum mode or when the store reports a missing/weak ETag.

pathstringrequired

Object-store key of the file (path within the root's store).

e_tagstring | null

ETag reported by the store; used when no content hash is recorded.

hashstring | null

Blake3 content hash; the strongest signal when present.

sizeinteger:uint64required

File size in bytes.

format uint64min 0
last_modifiedstringrequired

Last-modified timestamp as reported by the store.

Node Info

Internal name
path_get_changes
Category
Data/Files/Operations
Version
1