@wayai/cli 0.3.155 → 0.3.157

package/dist/index.js

@@ -7554,7 +7554,15 @@ var init_contracts = __esm({
     dataUsageCountersSchema = external_exports.object({
       ops_tenths_this_month: external_exports.number().nonnegative(),
       records_count: external_exports.number().nonnegative(),
-      month_key: external_exports.string()
+      month_key: external_exports.string(),
+      // The closed window's meter reading (§2.7's prior-window snapshot). OPTIONAL for the same
+      // reason this object is not `.strict()`: the producer deploys on its own cadence, and a
+      // required field would fail the parse for every counter on any producer build that predates
+      // it — turning an additive wire change into an outage of the gauge above. Absence and a
+      // non-matching key are the SAME outcome for a reader (§2.7 property 1: do not bill), so
+      // nothing is lost by tolerating it.
+      prior_window_key: external_exports.string().optional(),
+      prior_window_ops_tenths: external_exports.number().nonnegative().optional()
     });
     REKOR_ENTITLEMENT_CONTRACT_VERSION = 1;
     entitlementProjectionSchema = external_exports.object({
@@ -13259,7 +13267,15 @@ var init_dist = __esm({
     dataUsageCountersSchema2 = external_exports.object({
       ops_tenths_this_month: external_exports.number().nonnegative(),
       records_count: external_exports.number().nonnegative(),
-      month_key: external_exports.string()
+      month_key: external_exports.string(),
+      // The closed window's meter reading (§2.7's prior-window snapshot). OPTIONAL for the same
+      // reason this object is not `.strict()`: the producer deploys on its own cadence, and a
+      // required field would fail the parse for every counter on any producer build that predates
+      // it — turning an additive wire change into an outage of the gauge above. Absence and a
+      // non-matching key are the SAME outcome for a reader (§2.7 property 1: do not bill), so
+      // nothing is lost by tolerating it.
+      prior_window_key: external_exports.string().optional(),
+      prior_window_ops_tenths: external_exports.number().nonnegative().optional()
     });
     REKOR_ENTITLEMENT_CONTRACT_VERSION2 = 1;
     entitlementProjectionSchema2 = external_exports.object({
@@ -17307,78 +17323,6 @@ var init_constants = __esm({
   }
 });
 
-// src/lib/workspace-files.ts
-import * as fs9 from "fs";
-import * as path9 from "path";
-function perHubAgentsMd(hubFolderName) {
-  return [
-    `# ${hubFolderName}`,
-    "",
-    "Notes about THIS hub that the config files (hub.yaml, agents/) don't capture:",
-    "why it exists, key decisions and the reasons behind them, business rules that",
-    "only apply here, terminology, integration quirks.",
-    "",
-    "Keep it short and about *why / what is different* \u2014 platform mechanics live in",
-    "the WayAI skill. Fill this in as you learn about the hub; delete this",
-    "placeholder once you do.",
-    ""
-  ].join("\n");
-}
-function isWorkspace(gitRoot) {
-  if (fs9.existsSync(workspaceManifestPath(gitRoot))) return true;
-  if (fs9.existsSync(rootConfigPath(gitRoot))) return true;
-  return isDirectory(resolveLayout(gitRoot).hubsDir);
-}
-function writeIfAbsent(filePath, content) {
-  if (fs9.existsSync(filePath)) return null;
-  fs9.writeFileSync(filePath, content, "utf-8");
-  return path9.basename(filePath);
-}
-function ensureWorkspaceFiles(gitRoot) {
-  if (!isWorkspace(gitRoot)) return [];
-  const created = [];
-  const agents = writeIfAbsent(path9.join(gitRoot, "AGENTS.md"), ROOT_AGENTS_MD);
-  if (agents) created.push(agents);
-  const claude = writeIfAbsent(path9.join(gitRoot, "CLAUDE.md"), CLAUDE_MD_SHIM);
-  if (claude) created.push(claude);
-  return created;
-}
-var CLAUDE_MD_SHIM, ROOT_AGENTS_MD;
-var init_workspace_files = __esm({
-  "src/lib/workspace-files.ts"() {
-    "use strict";
-    init_constants();
-    init_layout();
-    init_workspace_manifest();
-    CLAUDE_MD_SHIM = "@AGENTS.md\n";
-    ROOT_AGENTS_MD = [
-      "# Working with WayAI",
-      "",
-      "WayAI is the layer that talks to people across channels, plus the data layer",
-      "(Bases) behind it. One CLI, one skill, one login.",
-      "",
-      "## At the start of every session",
-      "",
-      "1. Check for updates first, and update whatever is not current:",
-      `   - Skill: \`wayai status\` \u2192 if newer, \`${SKILL_INSTALL_COMMAND}\``,
-      "   - CLI: `wayai update`",
-      "2. Load the WayAI skill at the start of every session \u2014 every time, even for a",
-      "   quick task. It holds the real instructions for everything else.",
-      "",
-      "More detail if you need it: https://wayai.pro",
-      "",
-      "## When helping the person you are working with",
-      "",
-      "- They may be new to WayAI \u2014 use plain language, not jargon.",
-      "- Don't explain things they didn't ask about. Only if they seem stuck or ask",
-      "  what something means, give a one-line answer, then move on \u2014 don't turn",
-      "  replies into tutorials.",
-      "- Keep answers short and to the point.",
-      ""
-    ].join("\n");
-  }
-});
-
 // src/commands/init.ts
 var init_exports = {};
 __export(init_exports, {
@@ -17388,12 +17332,12 @@ __export(init_exports, {
   parseArgs: () => parseArgs3
 });
 import { mkdirSync as mkdirSync6 } from "fs";
-import path10 from "path";
+import path9 from "path";
 function ensureHubsDir(gitRoot) {
   const hubsDir = resolveLayout(gitRoot).hubsDir;
   if (isDirectory(hubsDir)) return null;
   mkdirSync6(hubsDir, { recursive: true });
-  return `${path10.relative(gitRoot, hubsDir)}/`;
+  return `${path9.relative(gitRoot, hubsDir)}/`;
 }
 function parseArgs3(args2) {
   let orgId;
@@ -17436,9 +17380,6 @@ async function initCommand(args2) {
     if (createdDir) {
       console.log(`Created ${createdDir}`);
     }
-    for (const file of ensureWorkspaceFiles(gitRoot)) {
-      console.log(`Created ${file}`);
-    }
   }
   console.log(
     `Run \`${SKILL_INSTALL_CMD}\` to install the WayAI skill in your AI harness, then \`wayai pull\` to fetch hub configuration.`
@@ -17519,7 +17460,6 @@ var init_init = __esm({
     init_repo_config();
     init_workspace();
     init_layout();
-    init_workspace_files();
     init_utils();
     init_constants();
     SKILL_INSTALL_CMD = SKILL_INSTALL_COMMAND;
@@ -17527,18 +17467,18 @@ var init_init = __esm({
 });
 
 // src/lib/fs-safety.ts
-import * as fs10 from "fs";
-import * as path11 from "path";
+import * as fs9 from "fs";
+import * as path10 from "path";
 function fileHasBytes(abs, data) {
   let st;
   try {
-    st = fs10.lstatSync(abs);
+    st = fs9.lstatSync(abs);
   } catch {
     return false;
   }
   if (!st.isFile() || st.isSymbolicLink()) return false;
   try {
-    return fs10.readFileSync(abs).equals(data);
+    return fs9.readFileSync(abs).equals(data);
   } catch {
     return false;
   }
@@ -17547,22 +17487,22 @@ function realpathContained(root, abs) {
   let realRoot;
   let realAbs;
   try {
-    realRoot = fs10.realpathSync(root);
-    realAbs = fs10.realpathSync(abs);
+    realRoot = fs9.realpathSync(root);
+    realAbs = fs9.realpathSync(abs);
   } catch {
     return false;
   }
-  return realAbs === realRoot || realAbs.startsWith(realRoot + path11.sep);
+  return realAbs === realRoot || realAbs.startsWith(realRoot + path10.sep);
 }
 function mkdirTolerateRace(dir) {
   try {
-    fs10.mkdirSync(dir);
+    fs9.mkdirSync(dir);
     return true;
   } catch (err) {
     if (err.code !== "EEXIST") throw err;
     let st;
     try {
-      st = fs10.lstatSync(dir);
+      st = fs9.lstatSync(dir);
     } catch {
       st = void 0;
     }
@@ -17570,22 +17510,22 @@ function mkdirTolerateRace(dir) {
   }
 }
 function ensureRealSubdirNoSymlink(root, target, create) {
-  const rootResolved = path11.resolve(root);
-  const targetResolved = path11.resolve(target);
-  if (targetResolved !== rootResolved && !targetResolved.startsWith(rootResolved + path11.sep)) return false;
+  const rootResolved = path10.resolve(root);
+  const targetResolved = path10.resolve(target);
+  if (targetResolved !== rootResolved && !targetResolved.startsWith(rootResolved + path10.sep)) return false;
   try {
-    if (!fs10.lstatSync(rootResolved).isDirectory()) return false;
+    if (!fs9.lstatSync(rootResolved).isDirectory()) return false;
   } catch {
     return false;
   }
-  const rel = path11.relative(rootResolved, targetResolved);
+  const rel = path10.relative(rootResolved, targetResolved);
   if (rel === "") return true;
   let cur = rootResolved;
-  for (const segment of rel.split(path11.sep)) {
-    cur = path11.join(cur, segment);
+  for (const segment of rel.split(path10.sep)) {
+    cur = path10.join(cur, segment);
     let st;
     try {
-      st = fs10.lstatSync(cur);
+      st = fs9.lstatSync(cur);
     } catch {
       st = void 0;
     }
@@ -17600,24 +17540,24 @@ function ensureRealSubdirNoSymlink(root, target, create) {
   return true;
 }
 function readFileNoFollow(root, abs) {
-  if (!ensureRealSubdirNoSymlink(root, path11.dirname(abs), false)) return null;
+  if (!ensureRealSubdirNoSymlink(root, path10.dirname(abs), false)) return null;
   try {
-    if (!fs10.lstatSync(abs).isFile()) return null;
-    return fs10.readFileSync(abs);
+    if (!fs9.lstatSync(abs).isFile()) return null;
+    return fs9.readFileSync(abs);
   } catch {
     return null;
   }
 }
 function writeFileNoFollow(root, abs, data) {
-  const parent = path11.dirname(abs);
+  const parent = path10.dirname(abs);
   if (!ensureRealSubdirNoSymlink(root, parent, true)) return false;
   let st;
   try {
-    st = fs10.lstatSync(abs);
+    st = fs9.lstatSync(abs);
   } catch {
   }
-  if (st?.isSymbolicLink()) fs10.rmSync(abs);
-  fs10.writeFileSync(abs, data);
+  if (st?.isSymbolicLink()) fs9.rmSync(abs);
+  fs9.writeFileSync(abs, data);
   return true;
 }
 var init_fs_safety = __esm({
@@ -17627,8 +17567,8 @@ var init_fs_safety = __esm({
 });
 
 // src/lib/resource-files.ts
-import * as fs11 from "fs";
-import * as path12 from "path";
+import * as fs10 from "fs";
+import * as path11 from "path";
 import * as crypto3 from "crypto";
 function isBinaryFile(filename) {
   const ext = filename.split(".").pop()?.toLowerCase() || "";
@@ -17674,14 +17614,14 @@ function computeHash(data) {
 }
 function scanResourceFiles(dir, prefix = "") {
   const files = [];
-  const entries = fs11.readdirSync(dir, { withFileTypes: true });
+  const entries = fs10.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
     if (entry.isDirectory()) {
-      files.push(...scanResourceFiles(path12.join(dir, entry.name), relPath));
+      files.push(...scanResourceFiles(path11.join(dir, entry.name), relPath));
     } else if (entry.isFile()) {
-      const fullPath = path12.join(dir, entry.name);
-      const stat2 = fs11.statSync(fullPath);
+      const fullPath = path11.join(dir, entry.name);
+      const stat2 = fs10.statSync(fullPath);
       if (stat2.size > MAX_RESOURCE_FILE_SIZE3) {
         console.warn(`  Warning: skipping ${relPath} (${(stat2.size / 1024 / 1024).toFixed(1)}MB exceeds 10MB limit)`);
         continue;
@@ -17691,7 +17631,7 @@ function scanResourceFiles(dir, prefix = "") {
         mime_type: guessMimeType(entry.name),
         file_size: stat2.size
       };
-      const data = fs11.readFileSync(fullPath);
+      const data = fs10.readFileSync(fullPath);
       fileEntry.hash = computeHash(data);
       if (isBinaryFile(entry.name)) {
         fileEntry.content_base64 = data.toString("base64");
@@ -17751,13 +17691,13 @@ function writeResourceFileTree(resDir, files, root, log) {
     return;
   }
   if (files.length === 0) {
-    if (fs11.existsSync(resDir)) cleanOrphanFiles(resDir, "", /* @__PURE__ */ new Set(), root, log);
+    if (fs10.existsSync(resDir)) cleanOrphanFiles(resDir, "", /* @__PURE__ */ new Set(), root, log);
     return;
   }
   const writtenPaths = /* @__PURE__ */ new Set();
   for (const file of files) {
-    const filePath = path12.join(resDir, file.path);
-    if (!filePath.startsWith(resDir + path12.sep) && filePath !== resDir) {
+    const filePath = path11.join(resDir, file.path);
+    if (!filePath.startsWith(resDir + path11.sep) && filePath !== resDir) {
       console.warn(`  Warning: skipping ${file.path} (path traversal detected)`);
       continue;
     }
@@ -17766,25 +17706,25 @@ function writeResourceFileTree(resDir, files, root, log) {
     if (buf === void 0) continue;
     if (fileHasBytes(filePath, buf)) continue;
     if (writeFileNoFollow(resDir, filePath, buf)) {
-      log?.changed.push(path12.relative(root, filePath));
+      log?.changed.push(path11.relative(root, filePath));
     } else {
       console.warn(`  Warning: skipping ${file.path} (destination escapes the resource folder via a symlink)`);
       writtenPaths.delete(file.path);
     }
   }
-  if (fs11.existsSync(resDir)) cleanOrphanFiles(resDir, "", writtenPaths, root, log);
+  if (fs10.existsSync(resDir)) cleanOrphanFiles(resDir, "", writtenPaths, root, log);
 }
 function cleanOrphanFiles(dir, prefix, writtenPaths, root, log) {
-  const entries = fs11.readdirSync(dir, { withFileTypes: true });
+  const entries = fs10.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
-    const fullPath = path12.join(dir, entry.name);
+    const fullPath = path11.join(dir, entry.name);
     if (entry.isDirectory()) {
       cleanOrphanFiles(fullPath, relPath, writtenPaths, root, log);
-      if (fs11.readdirSync(fullPath).length === 0) fs11.rmdirSync(fullPath);
+      if (fs10.readdirSync(fullPath).length === 0) fs10.rmdirSync(fullPath);
     } else if (!writtenPaths.has(relPath)) {
-      fs11.unlinkSync(fullPath);
-      if (log && root) log.removed.push(path12.relative(root, fullPath));
+      fs10.unlinkSync(fullPath);
+      if (log && root) log.removed.push(path11.relative(root, fullPath));
     }
   }
 }
@@ -17797,15 +17737,15 @@ async function downloadBinaryFiles(resDir, files, root, log) {
   for (const file of files) {
     if (!file.download_url || file.content !== void 0) continue;
     try {
-      const filePath = path12.join(resDir, file.path);
-      if (!filePath.startsWith(resDir + path12.sep) && filePath !== resDir) {
+      const filePath = path11.join(resDir, file.path);
+      if (!filePath.startsWith(resDir + path11.sep) && filePath !== resDir) {
         console.warn(`  Warning: skipping ${file.path} (path traversal detected)`);
         continue;
       }
       if (file.hash) {
         try {
-          const st = fs11.lstatSync(filePath);
-          if (st.isFile() && !st.isSymbolicLink() && computeHash(fs11.readFileSync(filePath)) === file.hash) continue;
+          const st = fs10.lstatSync(filePath);
+          if (st.isFile() && !st.isSymbolicLink() && computeHash(fs10.readFileSync(filePath)) === file.hash) continue;
         } catch {
         }
       }
@@ -17818,7 +17758,7 @@ async function downloadBinaryFiles(resDir, files, root, log) {
       if (fileHasBytes(filePath, buffer)) continue;
       if (writeFileNoFollow(resDir, filePath, buffer)) {
         count++;
-        log?.changed.push(path12.relative(root, filePath));
+        log?.changed.push(path11.relative(root, filePath));
       } else {
         console.warn(`  Warning: skipping ${file.path} (destination escapes the resource folder via a symlink)`);
       }
@@ -17859,8 +17799,8 @@ var init_resource_files = __esm({
 });
 
 // src/lib/eval-attachments.ts
-import * as fs12 from "fs";
-import * as path13 from "path";
+import * as fs11 from "fs";
+import * as path12 from "path";
 function resolveTurnAttachments(hubFolder, turn, label, bytesByHash) {
   const raw = turn.attachments;
   if (raw === void 0 || raw === null) return void 0;
@@ -17876,14 +17816,14 @@ function resolveTurnAttachments(hubFolder, turn, label, bytesByHash) {
     if (typeof entry !== "string" || !entry.trim()) {
       throw expected(`${label}: each attachment must be a hub-relative file path string.`);
     }
-    const abs = path13.resolve(hubFolder, entry);
-    const root = path13.resolve(hubFolder);
-    if (abs !== root && !abs.startsWith(root + path13.sep)) {
+    const abs = path12.resolve(hubFolder, entry);
+    const root = path12.resolve(hubFolder);
+    if (abs !== root && !abs.startsWith(root + path12.sep)) {
       throw expected(`${label}: attachment "${entry}" escapes the hub folder.`);
     }
     let stat2;
     try {
-      stat2 = fs12.statSync(abs);
+      stat2 = fs11.statSync(abs);
     } catch {
     }
     if (!stat2?.isFile()) {
@@ -17897,9 +17837,9 @@ function resolveTurnAttachments(hubFolder, turn, label, bytesByHash) {
         `${label}: attachment "${entry}" is ${(stat2.size / 1024 / 1024).toFixed(1)}MB, over the 10MB limit.`
       );
     }
-    const data = fs12.readFileSync(abs);
+    const data = fs11.readFileSync(abs);
     const hash = computeHash(data);
-    const fileName = path13.basename(abs);
+    const fileName = path12.basename(abs);
     const mimeType = guessMimeType(fileName) ?? "application/octet-stream";
     refs.push({ hash, file_name: fileName, mime_type: mimeType, file_size: stat2.size });
     if (!bytesByHash.has(hash)) {
@@ -17942,7 +17882,7 @@ function forEachAttachableTurn(payload, fn) {
 function rewriteEvalAttachmentsToLocalPaths(payload) {
   const urlByHash = new Map((payload.eval_attachment_files ?? []).map((f) => [f.hash, f.download_url]));
   const safeName = (ref) => {
-    const base = path13.basename(ref.file_name);
+    const base = path12.basename(ref.file_name);
     return base === "" || base === "." || base === ".." ? ref.hash.slice(0, 16) : base;
   };
   const hashesByName = /* @__PURE__ */ new Map();
@@ -17967,8 +17907,8 @@ function rewriteEvalAttachmentsToLocalPaths(payload) {
     const key = `${ref.hash} ${name}`;
     const existing = pathByKey.get(key);
     if (existing) return existing;
-    const ext = path13.extname(name);
-    const stem = path13.basename(name, ext);
+    const ext = path12.extname(name);
+    const stem = path12.basename(name, ext);
     const collides = (hashesByName.get(name)?.size ?? 0) > 1;
     let rel = collides ? `${ATTACHMENTS_DIR}/${stem}-${ref.hash.slice(0, 8)}${ext}` : `${ATTACHMENTS_DIR}/${name}`;
     if (usedLower.has(rel.toLowerCase())) {
@@ -17999,22 +17939,22 @@ function rewriteEvalAttachmentsToLocalPaths(payload) {
   return [...downloads.values()];
 }
 async function downloadEvalAttachments(hubFolder, downloads) {
-  const attachDir = path13.resolve(hubFolder, ATTACHMENTS_DIR);
+  const attachDir = path12.resolve(hubFolder, ATTACHMENTS_DIR);
   const result = { written: 0, changed: [], removed: [] };
   if (!ensureRealSubdirNoSymlink(hubFolder, attachDir, downloads.length > 0)) {
     console.warn(`  Warning: ${ATTACHMENTS_DIR}/ is not reachable inside the hub folder without a symlink; skipping attachment sync.`);
     return result;
   }
-  if (!fs12.existsSync(attachDir)) return result;
+  if (!fs11.existsSync(attachDir)) return result;
   for (const dl of downloads) {
-    const abs = path13.resolve(hubFolder, dl.relPath);
-    if (abs !== attachDir && !abs.startsWith(attachDir + path13.sep)) continue;
+    const abs = path12.resolve(hubFolder, dl.relPath);
+    if (abs !== attachDir && !abs.startsWith(attachDir + path12.sep)) continue;
     let existing;
     try {
-      existing = fs12.lstatSync(abs);
+      existing = fs11.lstatSync(abs);
     } catch {
     }
-    if (existing?.isFile() && !existing.isSymbolicLink() && computeHash(fs12.readFileSync(abs)) === dl.hash) {
+    if (existing?.isFile() && !existing.isSymbolicLink() && computeHash(fs11.readFileSync(abs)) === dl.hash) {
       continue;
     }
     try {
@@ -18031,13 +17971,13 @@ async function downloadEvalAttachments(hubFolder, downloads) {
       console.warn(`  Warning: failed to download ${dl.relPath}: ${err instanceof Error ? err.message : String(err)}`);
     }
   }
-  const keep = new Set(downloads.map((d) => path13.resolve(hubFolder, d.relPath)));
-  for (const name of fs12.readdirSync(attachDir)) {
-    const abs = path13.join(attachDir, name);
-    const st = fs12.lstatSync(abs);
+  const keep = new Set(downloads.map((d) => path12.resolve(hubFolder, d.relPath)));
+  for (const name of fs11.readdirSync(attachDir)) {
+    const abs = path12.join(attachDir, name);
+    const st = fs11.lstatSync(abs);
     if ((st.isFile() || st.isSymbolicLink()) && !keep.has(abs)) {
-      fs12.rmSync(abs);
-      result.removed.push(path13.relative(hubFolder, abs));
+      fs11.rmSync(abs);
+      result.removed.push(path12.relative(hubFolder, abs));
     }
   }
   return result;
@@ -18054,15 +17994,15 @@ var init_eval_attachments = __esm({
 });
 
 // src/lib/parser.ts
-import * as fs13 from "fs";
-import * as path14 from "path";
+import * as fs12 from "fs";
+import * as path13 from "path";
 import * as yaml6 from "js-yaml";
 function parseHubFolder(hubFolder, opts) {
   const yamlPath = resolveHubYamlPath(hubFolder);
   if (!yamlPath) {
     throw expected(`hub.yaml not found in ${hubFolder}`);
   }
-  const yamlContent = fs13.readFileSync(yamlPath, "utf-8");
+  const yamlContent = fs12.readFileSync(yamlPath, "utf-8");
   let config;
   try {
     config = yaml6.load(yamlContent);
@@ -18089,18 +18029,18 @@ function parseHubFolder(hubFolder, opts) {
     const resolved = { ...agent };
     if (typeof resolved.instructions === "string" && resolved.instructions.endsWith(".md")) {
       const instrValue = resolved.instructions;
-      const instructionsPath = instrValue.startsWith("agents/") ? path14.join(hubFolder, instrValue) : path14.join(hubFolder, "agents", instrValue);
-      if (fs13.existsSync(instructionsPath)) {
-        resolved.instructions = fs13.readFileSync(instructionsPath, "utf-8");
+      const instructionsPath = instrValue.startsWith("agents/") ? path13.join(hubFolder, instrValue) : path13.join(hubFolder, "agents", instrValue);
+      if (fs12.existsSync(instructionsPath)) {
+        resolved.instructions = fs12.readFileSync(instructionsPath, "utf-8");
       } else {
         throw expected(
           `Agent instructions file not found: ${instructionsPath} (referenced by agent "${agent.name}")`
         );
       }
     } else if (resolved.instructions === void 0 && typeof agent.name === "string") {
-      const conventionPath = path14.join(hubFolder, "agents", `${slugify(agent.name)}.md`);
-      if (fs13.existsSync(conventionPath)) {
-        resolved.instructions = fs13.readFileSync(conventionPath, "utf-8");
+      const conventionPath = path13.join(hubFolder, "agents", `${slugify(agent.name)}.md`);
+      if (fs12.existsSync(conventionPath)) {
+        resolved.instructions = fs12.readFileSync(conventionPath, "utf-8");
       }
     }
     return resolved;
@@ -18154,26 +18094,26 @@ function parseHubFolder(hubFolder, opts) {
   return payload;
 }
 function scanEvalYamlFiles(hubFolder, bytesByHash) {
-  const evalsDir = path14.join(hubFolder, "evals");
-  if (!fs13.existsSync(evalsDir)) return [];
+  const evalsDir = path13.join(hubFolder, "evals");
+  if (!fs12.existsSync(evalsDir)) return [];
   const evals = [];
   const seen = /* @__PURE__ */ new Set();
-  const topEntries = fs13.readdirSync(evalsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+  const topEntries = fs12.readdirSync(evalsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
   for (const entry of topEntries) {
     if (entry.isFile() && entry.name.endsWith(".yaml")) {
-      collectEval(evals, seen, path14.join(evalsDir, entry.name), `evals/${entry.name}`, null, hubFolder, bytesByHash);
+      collectEval(evals, seen, path13.join(evalsDir, entry.name), `evals/${entry.name}`, null, hubFolder, bytesByHash);
     } else if (entry.isDirectory()) {
       const setName = entry.name;
-      const setDir = path14.join(evalsDir, setName);
-      const setEntries = fs13.readdirSync(setDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+      const setDir = path13.join(evalsDir, setName);
+      const setEntries = fs12.readdirSync(setDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
       for (const sub of setEntries) {
         if (sub.isDirectory()) {
           throw expected(
-            `Nested scenario sets are not supported: ${path14.relative(hubFolder, path14.join(setDir, sub.name))}. Move scenarios up to evals/${setName}/.`
+            `Nested scenario sets are not supported: ${path13.relative(hubFolder, path13.join(setDir, sub.name))}. Move scenarios up to evals/${setName}/.`
           );
         }
         if (sub.isFile() && sub.name.endsWith(".yaml")) {
-          collectEval(evals, seen, path14.join(setDir, sub.name), `evals/${setName}/${sub.name}`, setName, hubFolder, bytesByHash);
+          collectEval(evals, seen, path13.join(setDir, sub.name), `evals/${setName}/${sub.name}`, setName, hubFolder, bytesByHash);
         }
       }
     }
@@ -18187,14 +18127,14 @@ function collectEval(evals, seen, filePath, relPath, setName, hubFolder, bytesBy
   if (seen.has(key)) {
     const where = setName ? `scenario set "${setName}"` : "root";
     throw expected(
-      `Duplicate eval at ${where}: "${evalEntry.name}" (in ${path14.basename(filePath)}). Each (name, scenario set) pair must be unique.`
+      `Duplicate eval at ${where}: "${evalEntry.name}" (in ${path13.basename(filePath)}). Each (name, scenario set) pair must be unique.`
     );
   }
   seen.add(key);
   evals.push(evalEntry);
 }
 function parseEvalYaml(filePath, relPath, setName, hubFolder, bytesByHash) {
-  const content = fs13.readFileSync(filePath, "utf-8");
+  const content = fs12.readFileSync(filePath, "utf-8");
   let raw;
   try {
     raw = yaml6.load(content);
@@ -18209,7 +18149,7 @@ function parseEvalYaml(filePath, relPath, setName, hubFolder, bytesByHash) {
     return null;
   }
   const data = raw;
-  const fileSlug = path14.basename(filePath, ".yaml");
+  const fileSlug = path13.basename(filePath, ".yaml");
   const evalName = typeof data.name === "string" && data.name.trim().length > 0 ? data.name : fileSlug;
   if (typeof data.agent !== "string" || data.agent.trim().length === 0) {
     throw expected(`Eval "${evalName}" in ${relPath}: missing required field "agent" (string).`);
@@ -18296,19 +18236,19 @@ function parseFixtureField(raw, label, key) {
   return trimmed.length > 0 ? trimmed : void 0;
 }
 function scanJourneyYamlFiles(hubFolder, bytesByHash) {
-  const journeysDir = path14.join(hubFolder, "journeys");
-  if (!fs13.existsSync(journeysDir)) return [];
+  const journeysDir = path13.join(hubFolder, "journeys");
+  if (!fs12.existsSync(journeysDir)) return [];
   const journeys = [];
   const seen = /* @__PURE__ */ new Set();
-  const entries = fs13.readdirSync(journeysDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+  const entries = fs12.readdirSync(journeysDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
   for (const entry of entries) {
     if (entry.isDirectory()) {
       throw expected(
-        `Subfolders are not supported under journeys/: ${path14.relative(hubFolder, path14.join(journeysDir, entry.name))}. A journey owns its own managed scenario set \u2014 put each journey in a single journeys/<slug>.yaml file.`
+        `Subfolders are not supported under journeys/: ${path13.relative(hubFolder, path13.join(journeysDir, entry.name))}. A journey owns its own managed scenario set \u2014 put each journey in a single journeys/<slug>.yaml file.`
       );
     }
     if (!entry.isFile() || !entry.name.endsWith(".yaml")) continue;
-    const journeyEntry = parseJourneyYaml(path14.join(journeysDir, entry.name), `journeys/${entry.name}`, hubFolder, bytesByHash);
+    const journeyEntry = parseJourneyYaml(path13.join(journeysDir, entry.name), `journeys/${entry.name}`, hubFolder, bytesByHash);
     if (!journeyEntry) continue;
     if (seen.has(journeyEntry.name)) {
       throw expected(
@@ -18321,7 +18261,7 @@ function scanJourneyYamlFiles(hubFolder, bytesByHash) {
   return journeys;
 }
 function parseJourneyYaml(filePath, relPath, hubFolder, bytesByHash) {
-  const content = fs13.readFileSync(filePath, "utf-8");
+  const content = fs12.readFileSync(filePath, "utf-8");
   let raw;
   try {
     raw = yaml6.load(content);
@@ -18336,7 +18276,7 @@ function parseJourneyYaml(filePath, relPath, hubFolder, bytesByHash) {
     return null;
   }
   const data = raw;
-  const fileSlug = path14.basename(filePath, ".yaml");
+  const fileSlug = path13.basename(filePath, ".yaml");
   const journeyName = typeof data.name === "string" && data.name.trim().length > 0 ? data.name : fileSlug;
   if (typeof data.agent !== "string" || data.agent.trim().length === 0) {
     throw expected(`Journey "${journeyName}" in ${relPath}: missing required field "agent" (string).`);
@@ -18376,14 +18316,14 @@ function parseJourneyYaml(filePath, relPath, hubFolder, bytesByHash) {
   return journeyEntry;
 }
 function scanAgentYamlFiles(hubFolder) {
-  const agentsDir = path14.join(hubFolder, "agents");
-  if (!fs13.existsSync(agentsDir)) return [];
-  const yamlFiles = fs13.readdirSync(agentsDir).filter((f) => f.endsWith(".yaml")).sort();
+  const agentsDir = path13.join(hubFolder, "agents");
+  if (!fs12.existsSync(agentsDir)) return [];
+  const yamlFiles = fs12.readdirSync(agentsDir).filter((f) => f.endsWith(".yaml")).sort();
   if (yamlFiles.length === 0) return [];
   const agents = [];
   for (const file of yamlFiles) {
-    const filePath = path14.join(agentsDir, file);
-    const content = fs13.readFileSync(filePath, "utf-8");
+    const filePath = path13.join(agentsDir, file);
+    const content = fs12.readFileSync(filePath, "utf-8");
     let agent;
     try {
       agent = yaml6.load(content);
@@ -18403,7 +18343,7 @@ function scanAgentYamlFiles(hubFolder) {
   return agents;
 }
 function parseResources(hubFolder, configResources) {
-  const resourcesDir = path14.join(hubFolder, "resources");
+  const resourcesDir = path13.join(hubFolder, "resources");
   const results = [];
   for (const res of configResources) {
     const resource = {
@@ -18417,8 +18357,8 @@ function parseResources(hubFolder, configResources) {
     if (res.user_browsable) resource.user_browsable = res.user_browsable;
     if (res.skill_name) resource.skill_name = res.skill_name;
     const resSlug = slugify(resource.name);
-    const resDir = path14.join(resourcesDir, resSlug);
-    if (fs13.existsSync(resDir)) {
+    const resDir = path13.join(resourcesDir, resSlug);
+    if (fs12.existsSync(resDir)) {
       const files = scanResourceFiles(resDir, "");
       if (files.length > 0) {
         resource.files = files;
@@ -18465,6 +18405,36 @@ var init_diff_display = __esm({
   }
 });
 
+// src/lib/workspace-files.ts
+import * as fs13 from "fs";
+import * as path14 from "path";
+function perHubAgentsMd(hubFolderName) {
+  return [
+    `# ${hubFolderName}`,
+    "",
+    "Notes about THIS hub that the config files (hub.yaml, agents/) don't capture:",
+    "why it exists, key decisions and the reasons behind them, business rules that",
+    "only apply here, terminology, integration quirks.",
+    "",
+    "Keep it short and about *why / what is different* \u2014 platform mechanics live in",
+    "the WayAI skill. Fill this in as you learn about the hub; delete this",
+    "placeholder once you do.",
+    ""
+  ].join("\n");
+}
+function writeIfAbsent(filePath, content) {
+  if (fs13.existsSync(filePath)) return null;
+  fs13.writeFileSync(filePath, content, "utf-8");
+  return path14.basename(filePath);
+}
+var CLAUDE_MD_SHIM;
+var init_workspace_files = __esm({
+  "src/lib/workspace-files.ts"() {
+    "use strict";
+    CLAUDE_MD_SHIM = "@AGENTS.md\n";
+  }
+});
+
 // src/lib/yaml-writer.ts
 import * as fs14 from "fs";
 import * as path15 from "path";
@@ -20482,11 +20452,6 @@ async function pushCommand(args2) {
   const client = new ApiClient({ apiUrl: config.api_url, accessToken });
   const workspaceDir = resolveWorkspaceDir();
   const wsLabel = hubsDirLabel(gitRoot);
-  if (gitRoot) {
-    for (const file of ensureWorkspaceFiles(gitRoot)) {
-      console.error(`Created ${file}`);
-    }
-  }
   if (!fs18.existsSync(workspaceDir)) {
     console.error(`No ${wsLabel}/ directory found. Run \`wayai pull\` first or create hub files in ${wsLabel}/<hub>/hub.yaml.`);
     process.exit(1);
@@ -20528,7 +20493,6 @@ var init_push = __esm({
     init_utils();
     init_workspace();
     init_layout();
-    init_workspace_files();
     init_repo_config();
     init_worktree_scope();
     init_subtree_routing();
@@ -20591,11 +20555,6 @@ async function pullCommand(args2) {
   const { config, accessToken } = await requireAuth();
   const client = new ApiClient({ apiUrl: config.api_url, accessToken });
   const workspaceDir = resolveWorkspaceDir();
-  if (gitRoot) {
-    for (const file of ensureWorkspaceFiles(gitRoot)) {
-      console.error(`Created ${file}`);
-    }
-  }
   const { hubId, hubFolder: existingFolder } = resolveHubTarget(workspaceDir, hubSelector);
   console.log("Fetching hub configuration...");
   const payload = await client.pull(hubId, organizationId);
@@ -20723,7 +20682,6 @@ var init_pull = __esm({
     init_push();
     init_workspace();
     init_layout();
-    init_workspace_files();
     init_repo_config();
     init_worktree_scope();
     init_subtree_routing();
@@ -27969,12 +27927,12 @@ var init_providers = __esm({
 // src/data/commands/report.ts
 import { Command as Command6 } from "commander";
 import { readFileSync as readFileSync21 } from "fs";
-import { dirname as dirname12, join as join31 } from "path";
+import { dirname as dirname12, join as join30 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveCliVersion() {
   for (const candidate of [
-    join31(here, "..", "package.json"),
-    join31(here, "..", "..", "..", "package.json")
+    join30(here, "..", "package.json"),
+    join30(here, "..", "..", "..", "package.json")
   ]) {
     try {
       const version = JSON.parse(readFileSync21(candidate, "utf-8")).version;
@@ -30106,7 +30064,7 @@ init_utils();
 init_registry();
 import { readFileSync as readFileSync25 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname13, join as join32 } from "path";
+import { dirname as dirname13, join as join31 } from "path";
 
 // src/lib/version-refresh.ts
 init_version_cache();
@@ -30262,7 +30220,7 @@ Run \`wayai admin skill install\` to update.`);
 
 // src/index.ts
 var __dirname = dirname13(fileURLToPath3(import.meta.url));
-var pkg = JSON.parse(readFileSync25(join32(__dirname, "..", "package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync25(join31(__dirname, "..", "package.json"), "utf-8"));
 var [, , command, ...args] = process.argv;
 var isBackgroundRefresh = command === REFRESH_COMMAND;
 if (!isBackgroundRefresh) initSentry(command, pkg.version);