aboutsummaryrefslogtreecommitdiff
path: root/.ai/scripts/session-context-path
diff options
context:
space:
mode:
Diffstat (limited to '.ai/scripts/session-context-path')
-rwxr-xr-x.ai/scripts/session-context-path8
1 files changed, 8 insertions, 0 deletions
diff --git a/.ai/scripts/session-context-path b/.ai/scripts/session-context-path
index 8cc56f6..670a610 100755
--- a/.ai/scripts/session-context-path
+++ b/.ai/scripts/session-context-path
@@ -10,6 +10,14 @@
# instead of clobbering the singleton. The id is sanitized to filename-safe
# characters so a stray value can't escape the .d/ directory.
#
+# The id must be unique per run; the spawner appends an epoch on the tail
+# (recommended shape host.project.runtime.<epoch>) so a re-run of the same
+# logical agent gets a fresh anchor instead of resolving to a prior run's
+# leftover. The epoch is never minted here: this resolver is called many times
+# per session and must return the same path each call, so it can't generate a
+# new value. See protocols.org "Agent-scoped path". A bare, reused id (just
+# "codex") is the bug that motivated this note.
+#
# Workflows call this to resolve the path; both startup (existence check) and
# wrap-up (rename source) read/write through it. Callers should fall back to
# .ai/session-context.org if this script isn't present yet (older checkouts