waypoint-codex 0.1.7 → 0.1.9

package/README.md

@@ -50,6 +50,7 @@ repo/
 - `waypoint init` — scaffold or refresh the repo
 - `waypoint doctor` — check for drift and missing pieces
 - `waypoint sync` — rebuild `.waypoint/DOCS_INDEX.md` and sync optional automations/rules
+- `waypoint upgrade` — update the global Waypoint CLI and refresh the current repo with its existing config
 - `waypoint import-legacy` — import from an older repo layout
 
 ## Shipped skills
@@ -71,9 +72,13 @@ If you initialize with `--with-roles`, Waypoint scaffolds:
 ## Update
 
 ```bash
-npm install -g waypoint-codex@latest
-waypoint init --with-automations --with-roles
-waypoint doctor
+waypoint upgrade
+```
+
+If you only want to update the CLI without refreshing the repo:
+
+```bash
+waypoint upgrade --skip-repo-refresh
 ```
 
 ## Learn more

package/dist/src/cli.js

@@ -4,7 +4,8 @@ import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import path from "node:path";
 import process from "node:process";
-import { doctorRepository, importLegacyRepo, initRepository, syncRepository } from "./core.js";
+import { doctorRepository, importLegacyRepo, initRepository, loadWaypointConfig, syncRepository } from "./core.js";
+import { upgradeWaypoint } from "./upgrade.js";
 const VERSION = JSON.parse(readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json"), "utf8")).version;
 function resolveRepo(input) {
     return path.resolve(input ?? ".");
@@ -29,6 +30,7 @@ Commands:
   init                Initialize a repository with Waypoint scaffolding
   doctor              Validate repository health and report drift
   sync                Rebuild docs index and sync optional user-home artifacts
+  upgrade             Update the global Waypoint CLI and refresh this repo using existing config
   import-legacy       Analyze a legacy repository layout and produce a Waypoint adoption report
 `);
 }
@@ -128,6 +130,23 @@ async function main() {
         }
         return 0;
     }
+    if (command === "upgrade") {
+        const { values, positionals } = parseArgs({
+            args: argv.slice(1),
+            options: {
+                "skip-repo-refresh": { type: "boolean", default: false }
+            },
+            allowPositionals: true
+        });
+        const projectRoot = resolveRepo(positionals[0]);
+        const config = loadWaypointConfig(projectRoot);
+        return upgradeWaypoint({
+            projectRoot,
+            config,
+            cliEntry: process.argv[1] ? path.resolve(process.argv[1]) : fileURLToPath(import.meta.url),
+            skipRepoRefresh: values["skip-repo-refresh"],
+        });
+    }
     console.error(`Unknown command: ${command}`);
     printHelp();
     return 2;

package/dist/src/upgrade.js

@@ -0,0 +1,55 @@
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+export function npmBinaryForPlatform(platform = process.platform) {
+    return platform === "win32" ? "npm.cmd" : "npm";
+}
+export function buildInitArgs(projectRoot, config) {
+    const args = ["init", projectRoot];
+    if (config.profile === "app-friendly") {
+        args.push("--app-friendly");
+    }
+    const featureMap = config.features ?? {};
+    if (featureMap.roles) {
+        args.push("--with-roles");
+    }
+    if (featureMap.rules) {
+        args.push("--with-rules");
+    }
+    if (featureMap.automations) {
+        args.push("--with-automations");
+    }
+    return args;
+}
+function hasWaypointConfig(projectRoot) {
+    return existsSync(path.join(projectRoot, ".waypoint/config.toml"));
+}
+export function upgradeWaypoint(options) {
+    const nodeBinary = options.nodeBinary ?? process.execPath;
+    const npmBinary = options.npmBinary ?? process.env.WAYPOINT_NPM_COMMAND ?? npmBinaryForPlatform();
+    const stdio = options.stdio ?? "inherit";
+    const update = spawnSync(npmBinary, ["install", "-g", "waypoint-codex@latest"], {
+        stdio,
+    });
+    if ((update.status ?? 1) !== 0) {
+        return update.status ?? 1;
+    }
+    if (options.skipRepoRefresh) {
+        console.log("Waypoint CLI updated. Skipped repo refresh.");
+        return 0;
+    }
+    if (!hasWaypointConfig(options.projectRoot)) {
+        console.log("Waypoint CLI updated. No repo-local Waypoint config found, so repo refresh was skipped.");
+        return 0;
+    }
+    const init = spawnSync(nodeBinary, [options.cliEntry, ...buildInitArgs(options.projectRoot, options.config)], {
+        stdio,
+    });
+    if ((init.status ?? 1) !== 0) {
+        return init.status ?? 1;
+    }
+    const doctor = spawnSync(nodeBinary, [options.cliEntry, "doctor", options.projectRoot], {
+        stdio,
+    });
+    return doctor.status ?? 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waypoint-codex",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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

@@ -15,6 +15,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.
+
 ## Repository memory model
 
 The repository should contain the context the next agent needs.

package/templates/managed-agents-block.md

@@ -3,6 +3,8 @@
 
 This repository uses Waypoint as its Codex operating system.
 
+Stop here if the bootstrap has not been run yet.
+
 Before doing substantial work:
 1. Run `node .waypoint/scripts/prepare-context.mjs`
 2. Read `.waypoint/SOUL.md`
@@ -11,7 +13,12 @@ Before doing substantial work:
 5. Read `.waypoint/context/MANIFEST.md`
 6. Read every file listed in the manifest
 
-This is mandatory, not optional. Do not skip the context refresh or skip files in the manifest.
+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 the context refresh or skip files in the manifest.
 
 Working rules:
 - Keep `.waypoint/WORKSPACE.md` current as the live execution state