You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f57bc9a
Browse filesBrowse the repository at this point in the historyBrowse files
🌳 Name a Git repository and its checkouts inside a workflow run
`<Repository>`, `<Worktree>` and `<Dir>` are the composition a workflow
document writes to reach Git. Repository names a locator and gets one
primary named-branch checkout; Worktree names a linked checkout inside it;
Dir moves the working directory without creating anything. Each of the first
two is one durable Workspace effect, so the imported Git bytes, the metadata
row, the published Workspace root and the filtered journal result commit
together or not at all.
Authority is the database. The Deno provider exports a checkout into a
disposable host materialization, runs native Git there and imports the
result back inside the same transaction, reducing the absolute paths Git
writes into a linked worktree's administration to Workspace paths first. A
partial replay therefore reattaches and verifies after the remote and every
materialization are gone, without cloning anything; a completed replay
installs no provider at all. Retained state that disagrees with the record
is a fatal stale-input condition that `<PrintErrors>` cannot downgrade.
Schema version 1 is amended in place, per the maintainer decision on #293:
Repository and Worktree creation records join it, and a database an earlier
development build produced is refused as an incomplete pre-release. There is
no version 2, no migration and no legacy reader. Records are creation
identity only — HEAD, refs, index and linked-worktree administration live in
the versioned Workspace filesystem, so one selected root recovers the Git
state of that frontier.
The Git operations of §7 remain unbuilt and belong to #294.
Refs #293
Workspace-root tables, current-root state, and a non-null Workspace-root
233
-
association on every journal event. A fresh run starts with one
232
+
Workspace-root tables, current-root state, a non-null Workspace-root
233
+
association on every journal event, and the Repository and Worktree creation
234
+
records #293 added to it. A fresh run starts with one
234
235
content-addressed root manifest describing only the root directory, empty
235
236
retained manifest and blob reference sets, and the corresponding root-only DOFS
236
237
frontier.
@@ -736,6 +737,26 @@ Complete schema version 1 therefore remains one exact shape. Any later durable
736
737
input-delivery record for #300 requires its own schema-version decision and
737
738
strict recognition amendment.
738
739
740
+
Issue #293 amended that exact shape in place rather than introducing a second
741
+
version. This pre-release carries no persistence compatibility obligation, so
742
+
Repository and Worktree creation records joined version 1 and every database an
743
+
earlier development build produced is refused as an incomplete pre-release.
744
+
There is no version 2, no migration, no legacy reader and no upgrade path, and
745
+
strict recognition compares the amended declaration exactly.
746
+
747
+
A Repository record holds a Workspace-local name, the admitted credential-free
748
+
locator and its fingerprint, the requested base or its absence, the commit
749
+
pinned once at creation, the initial primary branch, the object format and a
750
+
stable Workspace-relative checkout path. A Worktree record holds its
751
+
Repository's name, its own name, the requested branch, the requested base or
752
+
its absence, the creation commit and its checkout path. Both are immutable
753
+
creation identity. Current HEAD, refs, index, checkout and linked-worktree
754
+
administration live in the versioned Workspace filesystem, so one selected
755
+
Workspace root recovers the Git state belonging to that frontier without any
756
+
unversioned "current commit" column to disagree with it. The locator is stored
757
+
beside the record rather than inside it: compatibility needs the bytes, while
758
+
the journal and the document receive only the fingerprint.
759
+
739
760
## Workflow Workspace
740
761
741
762
The command selects the environment; the document describes the procedure.
@@ -2060,8 +2081,9 @@ Status is measured against main.
2060
2081
|`ephemeral eval`| reconstructs live middleware and bindings without a journal entry | built on main |
2061
2082
|`useWorkflowServiceDenial()`| provides a non-delegating workflow service denial provider, installed inside every start and resume execution scope | built on the #366 stack |
2062
2083
|`xmd workflow start` / `xmd workflow resume`| starts or resumes a workflow run from the CLI, under the Deno entrypoints only | built on the #366 stack; both acquire #367's executor lock before any lifecycle transition |
2063
-
| implicit workflow Workspace | retains provider-neutral filesystem, repository and attachment state by run ID | document filesystem built on the #366 stack; repository, process and attachment capabilities unbuilt (#218) |
2064
-
| Repository / Worktree / transactional Git effects | compose named checkouts and publish local mutations with their journal result | defined in `specs/workflow-workspace-spec.md`, unbuilt |
2084
+
| implicit workflow Workspace | retains provider-neutral filesystem, repository and attachment state by run ID | document filesystem built on the #366 stack and Repository/Worktree composition on the #293 stack; process capabilities unbuilt (#218) |
2085
+
|`<Repository>` / `<Worktree>` / `<Dir>` composition | names a Git repository and its linked checkouts inside the run-owned Workspace, installs each as contextual working directory, and retains creation identity beside the retained Git bytes | built on the #293 stack, Deno provider only |
2086
+
| transactional Git effects (`Git.Switch` / `Git.Add` / `Git.Commit`) | publish local Git mutations with their journal result | defined in `specs/workflow-workspace-spec.md`, unbuilt (#294) |
2065
2087
| workflow lifecycle inspection and control | reads status/list/history without advancing a run, enforces the executor lock, refuses live cancellation, cancels non-live runs under that lock and deletes retained state | built on the #367 stack |
2066
2088
| historical authored source | retains an authored durable operation's normalized `SourcePosition` beside its identity, and history parses it or refuses the entry | built on the #367 stack |
2067
2089
| history fork | creates a new run from one compatible checkpoint and retained Workspace root | defined in `specs/workflow-workspace-spec.md`, unbuilt (#368) |
0 commit comments