waypoint-codex 0.1.9 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waypoint-codex",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Codex-native repository operating system: scaffolding, docs routing, repo-local skills, doctor, and sync.",
   "license": "MIT",
   "type": "module",

package/templates/.waypoint/agent-operating-manual.md

@@ -2,9 +2,17 @@
 
 This repository uses Waypoint as its operating system for Codex.
 
+If the repo needs custom AGENTS guidance, write it outside the managed `waypoint:start/end` block in `AGENTS.md`. Treat the managed block as Waypoint-owned and replaceable.
+
 ## Session start
 
-At the start of every session:
+Run the Waypoint bootstrap only:
+
+- at the start of every new session
+- immediately after a compaction
+- when the user explicitly asks for a rerun
+
+Bootstrap sequence:
 
 1. Run `node .waypoint/scripts/prepare-context.mjs`
 2. Read `.waypoint/SOUL.md`
@@ -15,9 +23,10 @@ At the start of every session:
 
 Do not skip this sequence.
 
-- Do not read code, search the repo, inspect runtime behavior, or start planning before the sequence is complete.
-- Earlier chat context or partial memory from the current session does not count as a substitute.
-- If you are unsure whether the bootstrap already ran, rerun it instead of guessing.
+- Do not skip it at new-session start or after compaction.
+- Do not rerun it mid-conversation just because a task becomes more substantial.
+- Earlier chat context or partial memory from the current session does not count as a substitute when a new session starts or a compaction happens.
+- If you are unsure whether a new session started or a compaction happened, rerun it instead of guessing.
 
 ## Repository memory model
 

package/templates/.waypoint/scripts/prepare-context.mjs

@@ -213,7 +213,9 @@ function mergeConsecutiveTurns(turns) {
 }
 
 function parseSession(sessionFile, projectRoot) {
+  let sessionId = null;
   let sessionCwd = null;
+  let sessionStartedAt = null;
   let compactionCount = 0;
   const rawTurns = [];
   const compactionBoundaries = [];
@@ -231,10 +233,18 @@ function parseSession(sessionFile, projectRoot) {
     }
 
     if (parsed.type === "session_meta") {
+      const sessionMetaId = parsed.payload?.id;
+      if (typeof sessionMetaId === "string") {
+        sessionId = sessionMetaId;
+      }
       const cwd = parsed.payload?.cwd;
       if (typeof cwd === "string") {
         sessionCwd = cwd;
       }
+      const timestamp = parsed.payload?.timestamp;
+      if (typeof timestamp === "string") {
+        sessionStartedAt = timestamp;
+      }
       continue;
     }
 
@@ -279,14 +289,16 @@ function parseSession(sessionFile, projectRoot) {
 
   return {
     path: sessionFile,
+    sessionId,
     sessionCwd,
     turns,
     compactionCount,
     selectedFromPreCompaction,
+    sessionStartedAt,
   };
 }
 
-function latestMatchingSession(projectRoot) {
+function latestMatchingSession(projectRoot, threadIdOverride = null) {
   const matches = [];
   for (const dirName of SESSION_DIR_NAMES) {
     for (const sessionFile of collectSessionFiles(path.join(codexHome(), dirName))) {
@@ -297,13 +309,28 @@ function latestMatchingSession(projectRoot) {
     }
   }
 
-  matches.sort((a, b) => statSync(b.path).mtimeMs - statSync(a.path).mtimeMs);
+  const requestedThreadId = threadIdOverride || process.env.CODEX_THREAD_ID || null;
+  if (requestedThreadId) {
+    const exact = matches.find((item) => item.sessionId === requestedThreadId);
+    if (exact) {
+      return exact;
+    }
+  }
+
+  matches.sort((a, b) => {
+    const left = a.sessionStartedAt || "";
+    const right = b.sessionStartedAt || "";
+    if (left === right) {
+      return b.path.localeCompare(a.path);
+    }
+    return right.localeCompare(left);
+  });
   return matches[0] || null;
 }
 
-function writeRecentThread(contextDir, projectRoot) {
+function writeRecentThread(contextDir, projectRoot, threadIdOverride = null) {
   const filePath = path.join(contextDir, "RECENT_THREAD.md");
-  const snapshot = latestMatchingSession(projectRoot);
+  const snapshot = latestMatchingSession(projectRoot, threadIdOverride);
   const generatedAt = new Date().toString();
 
   if (!snapshot) {
@@ -414,6 +441,11 @@ function main() {
   const projectRoot = detectProjectRoot();
   const contextDir = path.join(projectRoot, ".waypoint", "context");
   ensureDir(contextDir);
+  const threadIdFlagIndex = process.argv.indexOf("--thread-id");
+  const threadIdOverride =
+    threadIdFlagIndex >= 0 && threadIdFlagIndex + 1 < process.argv.length
+      ? process.argv[threadIdFlagIndex + 1]
+      : null;
 
   const docsIndexPath = writeDocsIndex(projectRoot);
 
@@ -557,7 +589,7 @@ function main() {
       "```",
     ].join("\n")
   );
-  const recentThreadPath = writeRecentThread(contextDir, projectRoot);
+  const recentThreadPath = writeRecentThread(contextDir, projectRoot, threadIdOverride);
 
   const manifestPath = path.join(contextDir, "MANIFEST.md");
   const manifestLines = [

package/templates/managed-agents-block.md

@@ -3,9 +3,18 @@
 
 This repository uses Waypoint as its Codex operating system.
 
+Waypoint owns only the text inside these `waypoint:start/end` markers.
+If you need repo-specific AGENTS instructions, write them outside this managed block.
+Do not put durable repo guidance inside the managed block, because `waypoint init` may replace it during upgrades.
+
 Stop here if the bootstrap has not been run yet.
 
-Before doing substantial work:
+Run the Waypoint bootstrap only in these cases:
+- at the start of a new session
+- immediately after a compaction
+- if the user explicitly tells you to rerun it
+
+Bootstrap sequence:
 1. Run `node .waypoint/scripts/prepare-context.mjs`
 2. Read `.waypoint/SOUL.md`
 3. Read `.waypoint/agent-operating-manual.md`
@@ -15,9 +24,10 @@ Before doing substantial work:
 
 This is mandatory, not optional.
 
-- Do not inspect code, run searches, read docs, draft plans, or analyze behavior before this bootstrap is complete.
-- Earlier chat context or earlier work in the session does not replace the bootstrap.
-- If you are not sure whether the bootstrap already ran, run it again. It is cheap and safe.
+- Do not skip it at session start or after compaction.
+- Do not rerun it mid-conversation just because a task is substantial.
+- Earlier chat context or earlier work in the session does not replace the bootstrap when a new session starts or a compaction happens.
+- If you are not sure whether a new session started or a compaction happened, rerun it.
 - Do not skip the context refresh or skip files in the manifest.
 
 Working rules: