Skip to content

Commit 3af75c3

Browse files
committed
docs(documentation): Update cache metadata
1 parent ef2fe62 commit 3af75c3

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

rfcs/0017-incremental-build.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ The cache consists of two main parts:
127127
"index": {
128128
// Map of source paths to their fs-stat metadata and content hashes
129129
"/resources/project/namespace/Component.js": {
130-
"mtime": 1764688556165,
130+
"lastModified": 1764688556165,
131131
"size": 1234,
132132
"inode": 5678,
133133
"integrity": "sha256-R70pB1+LgBnwvuxthr7afJv2eq8FBT3L4LO8tjloUX8="
@@ -151,15 +151,15 @@ The cache consists of two main parts:
151151
"input": {
152152
// Virtual paths read by the task during execution, mapped to their cache metadata
153153
"/resources/project/namespace/Component.js": {
154-
"mtime": 1764688556165,
154+
"lastModified": 1764688556165,
155155
"size": 1234,
156156
"integrity": "sha256-R70pB1+LgBnwvuxthr7afJv2eq8FBT3L4LO8tjloUX8="
157157
}
158158
},
159159
"output": {
160160
// Virtual paths written by the task during execution, mapped to their cache metadata
161161
"/resources/project/namespace/Component.js": {
162-
"mtime": 176468853453,
162+
"lastModified": 176468853453,
163163
"size": 4567,
164164
"integrity": "sha256-EvQbHDId8MgpzlgZllZv3lKvbK/h0qDHRmzeU+bxPMo="
165165
}
@@ -199,7 +199,7 @@ The index provides metadata for all source files of the project. This allows the
199199
The integrity of a source file shall be calculated based on its raw content. A SHA256 hash should be used for this purpose. The hash should stored in Base64 format to reduce the size of the manifest file. A library like [ssri](https://github.com/npm/ssri) should be used for this purpose, allowing easy interoperability with [cacache](#cacache) (see below).
200200

201201
When comparing the stored metadata with the current metadata of a source file, the following attributes should be considered initially:
202-
* `mtime` - Modification time
202+
* `lastModified` - Modification time
203203
* `size` - File size
204204
* `inode` - Inode number (to detect file replacements)
205205

@@ -220,8 +220,8 @@ An object containing entries for each build task executed during the build proce
220220
For each task, the following information is stored:
221221

222222
* `projectRequests` and `dependencyRequests`: Resource paths and glob patterns that the task requested from the project and its dependencies during its execution. This information is required for determining whether the task needs to be re-executed in future builds, based on changes to the requested resources. The glob patterns are needed in particular to detect newly added resources that match the patterns.
223-
* `inputs`: Metadata for all resources **read** by the task during its execution. This is tracked via the provided workspace and dependencies readers. The metadata includes the `mtime`, `size` and `integrity` of each resource. Similar to the index. This information is required for determining whether the task needs to be re-executed in future builds, based on changes to the input resources.
224-
* `outputs`: Metadata for all resources **written** by the task during its execution. This is tracked via the provided workspace writer. The metadata includes the `mtime`, `size` and `integrity` of each resource. This information is required for determining whether subsequent tasks need to be re-executed.
223+
* `inputs`: Metadata for all resources **read** by the task during its execution. This is tracked via the provided workspace and dependencies readers. The metadata includes the `lastModified`, `size` and `integrity` of each resource. Similar to the index. This information is required for determining whether the task needs to be re-executed in future builds, based on changes to the input resources.
224+
* `outputs`: Metadata for all resources **written** by the task during its execution. This is tracked via the provided workspace writer. The metadata includes the `lastModified`, `size` and `integrity` of each resource. This information is required for determining whether subsequent tasks need to be re-executed.
225225

226226

227227
#### Cache Directory Structure

0 commit comments

Comments
 (0)