waypoint-codex 0.19.2 → 1.0.0

package/templates/.codex/agents/code-reviewer.toml

@@ -3,11 +3,12 @@ model_reasoning_effort = "high"
 sandbox_mode = "read-only"
 developer_instructions = """
 Read these files in order before doing anything else:
-1. .waypoint/SOUL.md
-2. .waypoint/agent-operating-manual.md
-3. .waypoint/WORKSPACE.md
-4. .waypoint/context/MANIFEST.md
-5. every file listed in that manifest
+1. AGENTS.md
+2. .waypoint/WORKSPACE.md
+3. .waypoint/ACTIVE_PLANS.md
+4. .waypoint/DOCS_INDEX.md
+5. .waypoint/context/SNAPSHOT.md
+6. .waypoint/context/RECENT_THREAD.md
 
 After reading them, follow these operating instructions:
 

package/templates/.codex/agents/plan-reviewer.toml

@@ -3,11 +3,12 @@ model_reasoning_effort = "high"
 sandbox_mode = "read-only"
 developer_instructions = """
 Read these files in order before doing anything else:
-1. .waypoint/SOUL.md
-2. .waypoint/agent-operating-manual.md
-3. .waypoint/WORKSPACE.md
-4. .waypoint/context/MANIFEST.md
-5. every file listed in that manifest
+1. AGENTS.md
+2. .waypoint/WORKSPACE.md
+3. .waypoint/ACTIVE_PLANS.md
+4. .waypoint/DOCS_INDEX.md
+5. .waypoint/context/SNAPSHOT.md
+6. .waypoint/context/RECENT_THREAD.md
 
 After reading them, follow these operating instructions:
 

package/templates/.waypoint/ACTIVE_PLANS.md

@@ -1,21 +1,21 @@
 # Active Plans
 
-This file is the live execution-contract layer for approved plans that are currently in flight.
+This file is the live execution checklist for approved plan work that is currently in flight.
 
 Keep it short and current.
 
-For each active plan, include:
+For the active plan, include:
 - source plan path under `.waypoint/plans/`
 - whether the plan is approved
-- the current phase
-- the checklist or acceptance criteria for that phase
-- what checkpoint must pass before moving to the next phase
-- any explicit non-goals or approved deferrals
+- the current phase or focus
+- the remaining checklist / todos
+- blockers or approved deferrals
+- current verification state
 
 Rules:
 - Read this file during bootstrap and before meaningful implementation.
 - Follow the approved plan. Do not silently deviate from it.
-- Update this file whenever the active plan, current phase, checkpoint, or approved scope changes.
+- Update this file whenever the active plan, checklist, blockers, or verification state changes.
 - If no approved plan is active, say so plainly here.
 
 ## Active Plan

package/templates/.waypoint/README.md

@@ -2,16 +2,13 @@
 
 Repo-local Waypoint configuration and project memory files.
 
-- `config.toml` — Waypoint feature toggles and file locations
+- `config.toml` — Waypoint configuration and file locations
 - `WORKSPACE.md` — live operational state; new or materially revised entries in multi-topic sections are timestamped
-- `ACTIVE_PLANS.md` — live execution-contract view of the approved plan(s) and current phase checkpoints
-- `DOCS_INDEX.md` — generated docs and plans routing map
-- `SOUL.md` — agent identity and working values
-- `agent-operating-manual.md` — required session workflow
+- `ACTIVE_PLANS.md` — active plan pointer, execution checklist, blockers, and verification state
+- `DOCS_INDEX.md` — generated docs routing map
 - `docs/` — Waypoint-managed long-lived project memory (architecture, decisions, debugging knowledge); routable docs use `summary`, `last_updated`, and `read_when` frontmatter
-- `plans/` — durable implementation, rollout, and migration plans; routable plans use `summary`, `last_updated`, and `read_when` frontmatter
-- `agents/` — agent prompt files that Waypoint's reviewer agents can read and follow
-- `context/` — generated session context bundle
+- `plans/` — stored implementation, rollout, and migration plans
+- `context/` — generated volatile context (`SNAPSHOT.md` and `RECENT_THREAD.md`)
 - `scripts/` — repo-local Waypoint helper scripts
 
 Durable guidance now lives in `AGENTS.md`:

package/templates/.waypoint/config.toml

@@ -2,9 +2,4 @@ version = 1
 profile = "__PROFILE__"
 workspace_file = ".waypoint/WORKSPACE.md"
 docs_dirs = [".waypoint/docs"]
-plans_dirs = [".waypoint/plans"]
 docs_index_file = ".waypoint/DOCS_INDEX.md"
-
-[features]
-repo_skills = true
-docs_index = true

package/templates/.waypoint/docs/README.md

@@ -14,8 +14,6 @@ These are **project docs**, not Waypoint internals.
 
 Put durable implementation and rollout plans in `.waypoint/plans/`.
 
-Do not use `.waypoint/docs/` as the execution tracker layer for active long-running work. That belongs under `.waypoint/track/`.
-
 Every routable doc needs YAML frontmatter:
 
 ```yaml
@@ -27,4 +25,4 @@ read_when:
 ---
 ```
 
-Refresh `last_updated` whenever you materially change a doc. `DOCS_INDEX.md` is generated from both `.waypoint/docs/` and `.waypoint/plans/`.
+Refresh `last_updated` whenever you materially change a doc. `DOCS_INDEX.md` is generated from routed docs only.

package/templates/.waypoint/scripts/build-docs-index.mjs

@@ -15,6 +15,7 @@ const SKIP_DIRS = new Set([
 ]);
 
 const SKIP_NAMES = new Set(["README.md", "CHANGELOG.md", "LICENSE.md"]);
+const DEFAULT_DOCS_DIR = ".waypoint/docs";
 
 export function findProjectRoot(startDir) {
   let current = path.resolve(startDir);
@@ -39,6 +40,28 @@ function detectProjectRoot() {
   return findProjectRoot(process.cwd());
 }
 
+function configuredDocsDirs(projectRoot) {
+  const configPath = path.join(projectRoot, ".waypoint", "config.toml");
+  if (!existsSync(configPath)) {
+    return [{ heading: `${DEFAULT_DOCS_DIR}/`, dir: path.join(projectRoot, DEFAULT_DOCS_DIR) }];
+  }
+
+  const configText = readFileSync(configPath, "utf8");
+  const docsDirsMatch = configText.match(/^\s*docs_dirs\s*=\s*\[(.*?)\]\s*$/ms);
+  const legacyDocsDirMatch = configText.match(/^\s*docs_dir\s*=\s*"([^"]+)"\s*$/m);
+
+  const rawRoots = docsDirsMatch
+    ? [...docsDirsMatch[1].matchAll(/"([^"]+)"/g)].map((match) => match[1])
+    : legacyDocsDirMatch
+      ? [legacyDocsDirMatch[1]]
+      : [DEFAULT_DOCS_DIR];
+
+  return rawRoots.map((root) => ({
+    heading: root.endsWith("/") ? root : `${root}/`,
+    dir: path.join(projectRoot, root),
+  }));
+}
+
 function parseFrontmatter(filePath) {
   const text = readFileSync(filePath, "utf8");
   if (!text.startsWith("---\n")) {
@@ -118,21 +141,12 @@ function collectDocEntries(projectRoot, docsDir) {
 }
 
 export function renderDocsIndex(projectRoot) {
-  const sections = [
-    {
-      heading: ".waypoint/docs/",
-      dir: path.join(projectRoot, ".waypoint", "docs"),
-    },
-    {
-      heading: ".waypoint/plans/",
-      dir: path.join(projectRoot, ".waypoint", "plans"),
-    },
-  ];
+  const sections = configuredDocsDirs(projectRoot);
 
   const lines = [
     "# Docs Index",
     "",
-    "Auto-generated by `.waypoint/scripts/build-docs-index.mjs`. Read matching docs and plans before working on a task.",
+    "Auto-generated by `.waypoint/scripts/build-docs-index.mjs`. Read matching docs before working on a task.",
     "",
   ];
 

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

@@ -7,10 +7,20 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { findProjectRoot, writeDocsIndex } from "./build-docs-index.mjs";
-import { writeTracksIndex } from "./build-track-index.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const CODEX_SESSION_DIR_NAMES = ["sessions", "archived_sessions"];
+const SECRET_PATTERNS = [
+  /npm_[A-Za-z0-9]+/g,
+  /github_pat_[A-Za-z0-9_]+/g,
+  /gh[pousr]_[A-Za-z0-9]+/g,
+  /sk-[A-Za-z0-9]+/g,
+  /sk_[A-Za-z0-9]+/g,
+  /fc-[A-Za-z0-9]+/g,
+  /AIza[0-9A-Za-z\-_]{20,}/g,
+];
+const MAX_RECENT_TURNS = 25;
 
 function detectProjectRoot() {
   const scriptBasedRoot = findProjectRoot(path.resolve(__dirname, "../.."));
@@ -49,11 +59,6 @@ function runCommand(command, cwd) {
   }
 }
 
-function safeExec(command, cwd) {
-  const result = runCommand(command, cwd);
-  return result.ok ? result.stdout : "";
-}
-
 function escapeRegex(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -116,18 +121,6 @@ function renderPullRequestBlock(result, emptyMessage) {
   return result.stdout || emptyMessage;
 }
 
-const CODEX_SESSION_DIR_NAMES = ["sessions", "archived_sessions"];
-const SECRET_PATTERNS = [
-  /npm_[A-Za-z0-9]+/g,
-  /github_pat_[A-Za-z0-9_]+/g,
-  /gh[pousr]_[A-Za-z0-9]+/g,
-  /sk-[A-Za-z0-9]+/g,
-  /sk_[A-Za-z0-9]+/g,
-  /fc-[A-Za-z0-9]+/g,
-  /AIza[0-9A-Za-z\-_]{20,}/g,
-];
-const MAX_RECENT_TURNS = 25;
-
 function codexHome() {
   return process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
 }
@@ -491,9 +484,7 @@ function writeRecentThread(contextDir, projectRoot, threadIdOverride = null) {
     `- Session cwd: \`${snapshot.sessionCwd}\``,
     `- Included turns: ${selectedTurns.length} of ${snapshot.turns.length} meaningful turns`,
     `- Compactions in source session: ${snapshot.compactionCount}`,
-    snapshot.selectedFromPreCompaction
-      ? "- Selection rule: take the 25 meaningful turns immediately before the last compaction."
-      : "- Selection rule: no compaction found, so take the latest meaningful turns from the local transcript.",
+    "- Selection rule: take the 25 meaningful turns immediately before the last compaction.",
     "- Noise filter: bootstrap AGENTS payloads are excluded.",
     "- Secret handling: obvious token formats are redacted before writing this file.",
     "",
@@ -512,91 +503,14 @@ function writeRecentThread(contextDir, projectRoot, threadIdOverride = null) {
   return filePath;
 }
 
-function writeContextFile(contextDir, name, title, body) {
-  const filePath = path.join(contextDir, name);
-  const content = `# ${title}\n\n${body && body.trim().length > 0 ? body.trim() : "None."}\n`;
-  writeFileSync(filePath, content, "utf8");
-  return filePath;
-}
-
-function writeActiveTrackers(contextDir, projectRoot, activeTracks) {
-  return writeContextFile(
-    contextDir,
-    "ACTIVE_TRACKERS.md",
-    "Active Trackers",
-    activeTracks.length === 0
-      ? "No active tracker files found."
-      : [
-          "These trackers should be read when resuming long-running work:",
-          "",
-          ...activeTracks.map((trackPath) => `- \`${trackPath}\``),
-        ].join("\n"),
-  );
-}
-
-function writeActivePlans(contextDir, projectRoot) {
-  const activePlansPath = path.join(projectRoot, ".waypoint", "ACTIVE_PLANS.md");
-  return writeContextFile(
-    contextDir,
-    "ACTIVE_PLANS.md",
-    "Active Plans",
-    existsSync(activePlansPath)
-      ? [
-          "Read this file before meaningful implementation when approved plan work is in flight:",
-          "",
-          `- \`${path.relative(projectRoot, activePlansPath)}\``,
-        ].join("\n")
-      : "`.waypoint/ACTIVE_PLANS.md` is missing.",
-  );
-}
-
-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);
-  const { outputPath: tracksIndexPath, activeTracks } = writeTracksIndex(projectRoot);
-  const codingAgent = loadCodingAgent(projectRoot);
-  const codingAgentLabelText = codingAgentLabel(codingAgent);
-
+function writeSnapshot(contextDir, projectRoot) {
+  const filePath = path.join(contextDir, "SNAPSHOT.md");
   const currentTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
   const currentLocalDatetime = new Date().toString();
 
-  const uncommittedChangesPath = writeContextFile(
-    contextDir,
-    "UNCOMMITTED_CHANGES.md",
-    "Uncommitted Changes",
-    (() => {
-      const status = runCommand(["git", "status", "--short", "--branch"], projectRoot);
-      const unstaged = runCommand(["git", "diff", "--stat"], projectRoot);
-      const staged = runCommand(["git", "diff", "--stat", "--cached"], projectRoot);
-      return [
-        "## Status",
-        "",
-        "```",
-        renderCommandBlock(status, "No uncommitted changes."),
-        "```",
-        "",
-        "## Diff Stat",
-        "",
-        "```",
-        renderCommandBlock(unstaged, "No unstaged tracked diff."),
-        "```",
-        "",
-        "## Staged Diff Stat",
-        "",
-        "```",
-        renderCommandBlock(staged, "No staged diff."),
-        "```",
-      ].join("\n");
-    })()
-  );
+  const status = runCommand(["git", "status", "--short", "--branch"], projectRoot);
+  const unstaged = runCommand(["git", "diff", "--stat"], projectRoot);
+  const staged = runCommand(["git", "diff", "--stat", "--cached"], projectRoot);
 
   const authorFilter = currentAuthorFilter(projectRoot);
   const recentCommitsResult = authorFilter
@@ -606,128 +520,129 @@ function main() {
         stdout: "",
         stderr: "Could not determine current git author from local git config.",
       };
-  const recentCommitsPath = writeContextFile(
-    contextDir,
-    "RECENT_COMMITS.md",
-    "Recent Commits",
+
+  const prContext = githubPullRequestContext(projectRoot);
+  const openPrs = prContext.ok
+    ? runCommand(
+        [
+          "gh",
+          "pr",
+          "list",
+          "--repo",
+          prContext.repo,
+          "--state",
+          "open",
+          "--author",
+          prContext.viewer,
+          "--limit",
+          "5",
+          "--json",
+          "number,title,author,headRefName",
+          "--template",
+          "{{range .}}#{{.number}} {{.title}} ({{.author.login}}) [{{.headRefName}}]\n{{end}}",
+        ],
+        projectRoot
+      )
+    : prContext;
+  const mergedPrs = prContext.ok
+    ? runCommand(
+        [
+          "gh",
+          "pr",
+          "list",
+          "--repo",
+          prContext.repo,
+          "--state",
+          "merged",
+          "--author",
+          prContext.viewer,
+          "--limit",
+          "5",
+          "--json",
+          "number,title,author,mergedAt",
+          "--template",
+          "{{range .}}#{{.number}} {{.title}} ({{.author.login}}) merged {{timeago .mergedAt}}\n{{end}}",
+        ],
+        projectRoot
+      )
+    : prContext;
+
+  writeFileSync(
+    filePath,
     [
+      "# Snapshot",
+      "",
+      "Generated volatile context for the current repo state.",
+      "",
+      "## Context Snapshot",
+      "",
+      `- Local timezone: ${currentTimezone}`,
+      `- Current local datetime: ${currentLocalDatetime}`,
+      "",
+      "## Git Status",
+      "",
+      "```",
+      renderCommandBlock(status, "No uncommitted changes."),
+      "```",
+      "",
+      "## Unstaged Diff Stat",
+      "",
+      "```",
+      renderCommandBlock(unstaged, "No unstaged tracked diff."),
+      "```",
+      "",
+      "## Staged Diff Stat",
+      "",
+      "```",
+      renderCommandBlock(staged, "No staged diff."),
+      "```",
+      "",
+      "## Recent Commits",
+      "",
       authorFilter ? `Author filter: ${authorFilter.label}` : "Author filter: unavailable",
       "",
       "```",
       renderCommandBlock(recentCommitsResult, "No recent commits found for the current author."),
       "```",
-    ].join("\n")
-  );
-
-  const prContext = githubPullRequestContext(projectRoot);
-  const openPrs =
-    prContext.ok
-      ? runCommand(
-          [
-            "gh",
-            "pr",
-            "list",
-            "--repo",
-            prContext.repo,
-            "--state",
-            "open",
-            "--author",
-            prContext.viewer,
-            "--limit",
-            "5",
-            "--json",
-            "number,title,author,headRefName",
-            "--template",
-            "{{range .}}#{{.number}} {{.title}} ({{.author.login}}) [{{.headRefName}}]\n{{end}}",
-          ],
-          projectRoot
-        )
-      : prContext;
-  const mergedPrs =
-    prContext.ok
-      ? runCommand(
-          [
-            "gh",
-            "pr",
-            "list",
-            "--repo",
-            prContext.repo,
-            "--state",
-            "merged",
-            "--author",
-            prContext.viewer,
-            "--limit",
-            "5",
-            "--json",
-            "number,title,author,mergedAt",
-            "--template",
-            "{{range .}}#{{.number}} {{.title}} ({{.author.login}}) merged {{timeago .mergedAt}}\n{{end}}",
-          ],
-          projectRoot
-        )
-      : prContext;
-  const prsPath = writeContextFile(
-    contextDir,
-    "PULL_REQUESTS.md",
-    "Pull Requests",
-    [
+      "",
+      "## Pull Requests",
+      "",
       prContext.ok ? `GitHub viewer: ${prContext.viewer}` : `GitHub context: ${prContext.error}`,
       prContext.ok ? `GitHub repo: ${prContext.repo}` : "",
       "",
-      "## Open PRs",
+      "### Open PRs",
       "",
       "```",
       renderPullRequestBlock(openPrs, "No open PRs found for the current GitHub user."),
       "```",
       "",
-      "## Recently Merged PRs",
+      "### Recently Merged PRs",
       "",
       "```",
       renderPullRequestBlock(mergedPrs, "No recently merged PRs found for the current GitHub user."),
       "```",
-    ].join("\n")
+      "",
+    ].join("\n"),
+    "utf8"
   );
-  const recentThreadPath = writeRecentThread(contextDir, projectRoot, threadIdOverride);
-  const activePlansPath = writeActivePlans(contextDir, projectRoot);
-  const activeTrackersPath = writeActiveTrackers(contextDir, projectRoot, activeTracks);
 
-  const manifestPath = path.join(contextDir, "MANIFEST.md");
-  const manifestLines = [
-    "# Waypoint Context Manifest",
-    "",
-    "Read every file listed below. This manifest is a required session-start context bundle.",
-    "",
-    "## Context Snapshot",
-    "",
-    `- Local timezone: ${currentTimezone}`,
-    `- Current local datetime: ${currentLocalDatetime}`,
-    "",
-    "## Required generated files",
-    "",
-    `- \`${path.relative(projectRoot, uncommittedChangesPath)}\` — uncommitted change summary`,
-    `- \`${path.relative(projectRoot, recentCommitsPath)}\` — recent commits`,
-    `- \`${path.relative(projectRoot, prsPath)}\` — open and recently merged pull requests`,
-    `- \`${path.relative(projectRoot, recentThreadPath)}\` — latest meaningful turns from the local ${codingAgentLabelText} session for this repo`,
-    `- \`${path.relative(projectRoot, activePlansPath)}\` — active plan summary`,
-    `- \`${path.relative(projectRoot, docsIndexPath)}\` — current docs index`,
-    `- \`${path.relative(projectRoot, tracksIndexPath)}\` — current tracker index`,
-    `- \`${path.relative(projectRoot, activeTrackersPath)}\` — active tracker summary`,
-    "",
-    "## Stable source-of-truth files to read before this manifest",
-    "",
-    "- `.waypoint/SOUL.md`",
-    "- `.waypoint/agent-operating-manual.md`",
-    "- `.waypoint/WORKSPACE.md`",
-    "- `.waypoint/ACTIVE_PLANS.md`",
-    "",
-    "## Active tracker files to read after this manifest",
-    "",
-    ...(activeTracks.length > 0 ? activeTracks.map((trackPath) => `- \`${trackPath}\``) : ["- None."]),
-    "",
-    `Generated by: \`${path.relative(projectRoot, fileURLToPath(import.meta.url))}\``,
-    "",
-  ];
-  writeFileSync(manifestPath, `${manifestLines.join("\n")}`, "utf8");
+  return filePath;
+}
+
+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;
+
+  writeDocsIndex(projectRoot);
+  writeSnapshot(contextDir, projectRoot);
+  writeRecentThread(contextDir, projectRoot, threadIdOverride);
 
   console.log(`Prepared Waypoint context in ${contextDir}`);
 }

package/templates/WORKSPACE.md

@@ -1,6 +1,6 @@
 # Workspace
 
-Timestamp discipline: Prefix new or materially revised bullets in `Active Plans`, `Active Trackers`, `Current State`, `In Progress`, `Next`, `Parked`, and `Done Recently` with `[YYYY-MM-DD HH:MM TZ]`.
+Timestamp discipline: Prefix new or materially revised bullets in `Active Plans`, `Current State`, `In Progress`, `Next`, `Parked`, and `Done Recently` with `[YYYY-MM-DD HH:MM TZ]`.
 
 ## Active Goal
 
@@ -8,11 +8,7 @@ Describe the main thing currently being built or changed.
 
 ## Active Plans
 
-Point at `.waypoint/ACTIVE_PLANS.md` and note the currently active approved plan and phase.
-
-## Active Trackers
-
-List any active tracker docs under `.waypoint/track/`, with the current phase or next step.
+Point at `.waypoint/ACTIVE_PLANS.md` and note the currently active approved plan or execution focus.
 
 ## Current State