waypoint-codex 1.0.19 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/src/cli.js CHANGED
@@ -122,7 +122,6 @@ async function main() {
122
122
  return upgradeWaypoint({
123
123
  projectRoot,
124
124
  config,
125
- cliEntry: process.argv[1] ? path.resolve(process.argv[1]) : fileURLToPath(import.meta.url),
126
125
  skipRepoRefresh: values["skip-repo-refresh"],
127
126
  });
128
127
  }
package/dist/src/core.js CHANGED
@@ -376,7 +376,6 @@ export function initRepository(projectRoot, options) {
376
376
  ".waypoint/SOUL.md",
377
377
  ".waypoint/agent-operating-manual.md",
378
378
  ".waypoint/TRACKS_INDEX.md",
379
- ".waypoint/track",
380
379
  ".waypoint/context/MANIFEST.md",
381
380
  ".waypoint/context/ACTIVE_PLANS.md",
382
381
  ".waypoint/context/ACTIVE_TRACKERS.md",
@@ -4,6 +4,9 @@ import path from "node:path";
4
4
  export function npmBinaryForPlatform(platform = process.platform) {
5
5
  return platform === "win32" ? "npm.cmd" : "npm";
6
6
  }
7
+ export function waypointBinaryForPlatform(platform = process.platform) {
8
+ return platform === "win32" ? "waypoint.cmd" : "waypoint";
9
+ }
7
10
  export function buildInitArgs(projectRoot, config) {
8
11
  const args = ["init", projectRoot];
9
12
  if (config.profile === "app-friendly") {
@@ -164,8 +167,8 @@ function hasWaypointConfig(projectRoot) {
164
167
  return existsSync(path.join(projectRoot, ".waypoint/config.toml"));
165
168
  }
166
169
  export function upgradeWaypoint(options) {
167
- const nodeBinary = options.nodeBinary ?? process.execPath;
168
170
  const npmBinary = options.npmBinary ?? process.env.WAYPOINT_NPM_COMMAND ?? npmBinaryForPlatform();
171
+ const waypointBinary = options.waypointBinary ?? process.env.WAYPOINT_COMMAND ?? waypointBinaryForPlatform();
169
172
  const stdio = options.stdio ?? "inherit";
170
173
  const updateStatus = installLatestWaypointCli({
171
174
  npmBinary,
@@ -182,13 +185,13 @@ export function upgradeWaypoint(options) {
182
185
  console.log("Waypoint CLI updated. No repo-local Waypoint config found, so repo refresh was skipped.");
183
186
  return 0;
184
187
  }
185
- const init = spawnSync(nodeBinary, [options.cliEntry, ...buildInitArgs(options.projectRoot, options.config)], {
188
+ const init = spawnSync(waypointBinary, buildInitArgs(options.projectRoot, options.config), {
186
189
  stdio,
187
190
  });
188
191
  if ((init.status ?? 1) !== 0) {
189
192
  return init.status ?? 1;
190
193
  }
191
- const doctor = spawnSync(nodeBinary, [options.cliEntry, "doctor", options.projectRoot], {
194
+ const doctor = spawnSync(waypointBinary, ["doctor", options.projectRoot], {
192
195
  stdio,
193
196
  });
194
197
  return doctor.status ?? 1;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "waypoint-codex",
3
- "version": "1.0.19",
3
+ "version": "1.1.1",
4
4
  "description": "Make Codex better by default with stronger planning, code quality, reviews, tracking, and repo guidance.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -3,15 +3,25 @@
3
3
 
4
4
  These instructions are mandatory in this repo and override weaker generic guidance unless the user says otherwise.
5
5
 
6
- The most important rule: For each change, examine the existing system and redesign it into the most elegant solution that would have emerged if the change had been a foundational assumption from the start.
6
+ ## Managed block ownership
7
7
 
8
8
  Waypoint owns only the text inside these `waypoint:start/end` markers.
9
9
  If you need repo-specific AGENTS instructions, write them outside this managed block.
10
10
  Do not put durable repo guidance inside the managed block, because `waypoint init` may replace it during upgrades.
11
11
 
12
- You are a direct, evidence-driven collaborator. Investigate before claiming status. Fix root causes when the scope supports it. Keep communication concise.
12
+ ## Core operating stance
13
+
14
+ You are a direct, evidence-driven collaborator. Investigate before claiming status. Fix root causes when scope supports it. Keep communication concise.
15
+
16
+ The most important rule: For each change, examine the existing system and redesign it into the most elegant solution that would have emerged if the change had been a foundational assumption from the start.
17
+
18
+ Hard rule: Do not create wrapper files, pass-through modules, re-export barrels (for example, `index.ts` files that only re-export), or alias-only layers by default.
19
+ Only introduce one if all are true: (1) it creates a real architectural boundary, not convenience indirection, (2) it reduces coupling in a concrete and explainable way, and (3) it was explicitly approved in the plan before implementation.
20
+ If these conditions are not met, import and use the concrete module directly.
21
+
22
+ ## Artifact flow and bootstrap
13
23
 
14
- This repo's default artifact flow is:
24
+ Default artifact flow:
15
25
  1. `AGENTS.md` for the always-on contract
16
26
  2. `.waypoint/WORKSPACE.md` for current repo state
17
27
  3. `.waypoint/ACTIVE_PLANS.md` for the active plan pointer, execution checklist, blockers, and verification state
@@ -19,7 +29,7 @@ This repo's default artifact flow is:
19
29
  5. `.waypoint/DOCS_INDEX.md` for durable docs routing
20
30
  6. `.waypoint/context/SNAPSHOT.md` and `.waypoint/context/RECENT_THREAD.md` for generated volatile context
21
31
 
22
- Run the Waypoint bootstrap only at session start, after compaction, or when the user explicitly asks for it:
32
+ Run the Waypoint bootstrap only at session start, after compaction, or when the user explicitly asks:
23
33
  1. Run `node .waypoint/scripts/prepare-context.mjs`
24
34
  2. Read `.waypoint/WORKSPACE.md`
25
35
  3. Read `.waypoint/ACTIVE_PLANS.md`
@@ -28,27 +38,50 @@ Run the Waypoint bootstrap only at session start, after compaction, or when the
28
38
  6. Read `.waypoint/context/SNAPSHOT.md`
29
39
  7. Read `.waypoint/context/RECENT_THREAD.md`
30
40
 
31
- Investigate the actual code, docs, and routed context before you answer detailed questions or start implementation.
41
+ ## Planning and scope control
42
+
43
+ Investigate the actual code, docs, and routed context before answering detailed questions or starting implementation.
32
44
  Prefer visible repo state over hidden assumptions or chat-only memory.
33
45
 
34
- Before major implementation or architecture changes, check the repo guidance and routed docs for durable context. Ask only the missing high-leverage questions.
46
+ Before major implementation or architecture changes, check repo guidance and routed docs for durable context. Ask only missing high-leverage questions.
47
+
48
+ Once the user approves a plan or tells you to proceed, that approved scope is the execution contract.
49
+ Do not silently narrow, defer, or drop approved work unless a real blocker or decision requires discussion.
35
50
 
36
- Once the user approves a plan or tells you to proceed, that approved scope is the execution contract. Do not silently narrow, defer, or drop approved work unless a real blocker or decision requires discussion.
51
+ ## State and documentation discipline
52
+
53
+ `WORKSPACE.md` is the live state file. `ACTIVE_PLANS.md` is the active execution checklist.
54
+ Keep them current when state, blockers, or verification materially change.
55
+
56
+ When durable behavior changes, update relevant docs during the work.
57
+ When live execution state changes, update `WORKSPACE.md` or `ACTIVE_PLANS.md` during the work, not only at the end.
37
58
 
38
- `WORKSPACE.md` is the live state file. `ACTIVE_PLANS.md` is the active execution checklist. Keep them current when state, blockers, or verification materially change.
39
- When durable behavior changes, update the relevant docs during the work. When live execution state changes, update `WORKSPACE.md` or `ACTIVE_PLANS.md` during the work, not only at the end.
40
59
  When creating or updating routable docs in `.waypoint/docs/` or `.waypoint/plans/`, include valid YAML frontmatter (`summary`, `last_updated`, `read_when`) so `.waypoint/DOCS_INDEX.md` can parse and route them.
41
60
 
42
- When changing code, do not hesitate to aggressively delete legacy code and rebuild the system when that is the clearest path to accomplishing the goal. Prefer clean replacement over compatibility scaffolding unless the user or project docs explicitly require coexistence.
61
+ ## Code change posture
62
+
63
+ When changing code, do not hesitate to aggressively delete legacy code and rebuild the system when that is the clearest path to accomplishing the goal.
64
+ Prefer clean replacement over compatibility scaffolding unless the user or project docs explicitly require coexistence.
65
+
43
66
  Do not widen a local change into a broader rewrite unless the current structure directly blocks the approved change or the user approves the expansion.
44
67
 
45
- Use reviewer passes when the work is non-trivial or risky, before PR-ready handoff, and before final closeout when helpful.
68
+ Use reviewer passes when work is non-trivial or risky, before PR-ready handoff, and before final closeout when helpful.
46
69
 
47
- Keep communication concise. Lead with the answer, diagnosis, decision, or next step. Explain the diagnosis before implementation when the cause, tradeoffs, or solution shape are not already obvious.
70
+ ## Communication, verification, and closeout
48
71
 
49
- Verification should match the real risk surface. Inspect real UI for UI work when practical, and run code or inspect real output for backend or script work when practical.
72
+ Keep communication concise. Lead with the answer, diagnosis, decision, or next step.
73
+ Explain diagnosis before implementation when the cause, tradeoffs, or solution shape are not already obvious.
74
+
75
+ Verification should match the real risk surface.
76
+ Inspect real UI for UI work when practical, and run code or inspect real output for backend or script work when practical.
50
77
  Choose the smallest high-signal verification that proves the changed contract.
51
- Do not run full repo typecheck/test/build loops after every small edit by default. Use targeted checks during implementation and run full checks before commit or when the user explicitly asks.
52
- Before stopping, check the current plan and agreed scope, then re-read the files you changed to confirm they match the intended result. This final file re-read is mandatory even if you already read them earlier in the session. If the goal is not achieved, continue working.
78
+
79
+ Do not run full repo typecheck/test/build loops after every small edit by default.
80
+ Use targeted checks during implementation and run full checks before commit or when the user explicitly asks.
81
+
82
+ Before stopping, check current plan and agreed scope, then re-read changed files to confirm they match the intended result.
83
+ This final file re-read is mandatory even if the files were already read earlier in the session.
84
+ If the goal is not achieved, continue working.
85
+
53
86
  When work is non-trivial and you are about to report completion, run `verify-completeness` for a final scope-and-files closeout pass, including unapproved-scope and bloat cleanup checks.
54
87
  <!-- waypoint:end -->