@ted-galago/wave-cli 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ted-galago/wave-cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "bin": {
     "wave": "dist/index.js"

package/scripts/verify-dev-api.mjs

@@ -312,6 +312,27 @@ function summarizeStatus(result) {
   return `status=${status},err=${err}`;
 }
 
+function firstArrayValue(input, paths) {
+  for (const path of paths) {
+    const value = readPath(input, path);
+    if (Array.isArray(value)) {
+      return value;
+    }
+  }
+  return [];
+}
+
+function recordExactCheck({ lines, label, result, ok, reason }) {
+  const status = result?.parsed?.status ?? "n/a";
+  const errCode = result?.parsed?.error?.code ?? "none";
+  lines.push(
+    `${ok ? "PASS" : "FAIL"} | status=${status} | err=${errCode} | reason=${
+      reason || (ok ? "ok" : "assertion_failed")
+    } | ${label} (${result?.args?.join(" ") ?? "n/a"})`
+  );
+  return ok ? 0 : 1;
+}
+
 function resolveAnnualStrategicObjectiveId(result) {
   return firstDefinedValue(result?.parsed, [
     ["data", "annual_objective", "attributes", "strategicObjectiveId"],
@@ -962,6 +983,8 @@ if (issueId) {
 
 const postUpdateVerificationLines = [];
 let postUpdateVerificationFailures = 0;
+const osmdVerificationLines = [];
+let osmdVerificationFailures = 0;
 
 function hasSuccessfulCommand(commandPrefix) {
   return results.some((res) => {
@@ -1106,6 +1129,193 @@ verifyFieldWrite({
   candidatePaths: [["data", "responsibility", "attributes", "name"]]
 });
 
+function resolveOsmdAgentParentRef() {
+  const queries = ["Wave Tools", "Ted Martinez", "Ted"];
+  for (const query of queries) {
+    const findRes = runWave(["find", query, "--limit", "10"], env);
+    results.push(findRes);
+    const candidates = firstArrayValue(findRes.parsed, [["data", "candidates"]]);
+    for (const candidate of candidates) {
+      const canonicalPath =
+        candidate && typeof candidate === "object" && typeof candidate.canonicalPath === "string"
+          ? candidate.canonicalPath
+          : "";
+      if (!canonicalPath) continue;
+
+      const statusRes = runWave(["osmd", "status", canonicalPath], env);
+      results.push(statusRes);
+      if (
+        statusRes.parsed?.ok === true &&
+        statusRes.parsed?.data?.source === "canonical_osmd" &&
+        statusRes.parsed?.data?.exists === true &&
+        statusRes.parsed?.data?.agentChildrenAllowed === true
+      ) {
+        return String(statusRes.parsed.data.path || canonicalPath);
+      }
+    }
+  }
+  return null;
+}
+
+function runOsmdLiveVerification() {
+  const treeDepthZero = runWave(["osmd", "tree", "--depth", "0"], env);
+  results.push(treeDepthZero);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: "osmd.tree depth 0 returns metadata and normalized empty children",
+    result: treeDepthZero,
+    ok:
+      treeDepthZero.parsed?.ok === true &&
+      treeDepthZero.parsed?.data?.source === "canonical_osmd" &&
+      Array.isArray(treeDepthZero.parsed?.data?.children) &&
+      treeDepthZero.parsed.data.children.length === 0,
+    reason: "depth_zero_contract"
+  });
+
+  const wikiRootRead = runWave(["osmd", "wiki", "read", "Agent Wiki"], env);
+  results.push(wikiRootRead);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: "osmd.wiki read root",
+    result: wikiRootRead,
+    ok:
+      wikiRootRead.parsed?.ok === true &&
+      wikiRootRead.parsed?.data?.path === "Agent Wiki" &&
+      wikiRootRead.parsed?.data?.source === "agent_wiki",
+    reason: "agent_wiki_root_read"
+  });
+
+  const wikiChildren = runWave(["osmd", "wiki", "children"], env);
+  results.push(wikiChildren);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: "osmd.wiki children returns an array",
+    result: wikiChildren,
+    ok: wikiChildren.parsed?.ok === true && Array.isArray(wikiChildren.parsed?.data),
+    reason: "agent_wiki_children"
+  });
+
+  const missingWikiPath = `missing-${verifyStamp}.md`;
+  const missingWikiUpdate = runWave(
+    ["osmd", "wiki", "update", missingWikiPath, "--content", "verify missing update"],
+    env
+  );
+  results.push(missingWikiUpdate);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: "osmd.wiki update missing file returns 404 metadata",
+    result: missingWikiUpdate,
+    ok:
+      missingWikiUpdate.code === 5 &&
+      missingWikiUpdate.parsed?.ok === false &&
+      missingWikiUpdate.parsed?.status === 404 &&
+      missingWikiUpdate.parsed?.error?.code === "agent_file_not_found" &&
+      missingWikiUpdate.parsed?.error?.suggestedAction === "create" &&
+      missingWikiUpdate.parsed?.data?.exists === false &&
+      missingWikiUpdate.parsed?.data?.canCreate === true,
+    reason: "missing_file_404"
+  });
+
+  const parentRef = resolveOsmdAgentParentRef();
+  if (!parentRef) {
+    osmdVerificationLines.push(
+      "FAIL | status=n/a | err=osmd_parent_not_found | reason=no_agent_children_allowed_parent | osmd agent parent resolution"
+    );
+    osmdVerificationFailures += 1;
+    return;
+  }
+
+  const agentStatus = runWave(["osmd", "agent", "status", parentRef, "notes.md"], env);
+  results.push(agentStatus);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: `osmd.agent status notes parent=${parentRef}`,
+    result: agentStatus,
+    ok:
+      agentStatus.parsed?.ok === true &&
+      agentStatus.parsed?.data?.source === "agent_overlay" &&
+      agentStatus.parsed?.data?.parentRef === parentRef,
+    reason: "agent_overlay_status"
+  });
+
+  const agentInit = runWave(["osmd", "agent", "init", parentRef], env);
+  results.push(agentInit);
+  const initFiles = firstArrayValue(agentInit.parsed, [["data", "files"]]);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: `osmd.agent init parent=${parentRef}`,
+    result: agentInit,
+    ok:
+      agentInit.parsed?.ok === true &&
+      initFiles.some((file) => file?.path?.endsWith("/.agent/notes.md")) &&
+      initFiles.some((file) => file?.path?.endsWith("/.agent/log.md")),
+    reason: "agent_overlay_init"
+  });
+
+  const notesContent = `CLI live verify notes ${verifyStamp}`;
+  const agentUpdate = runWave(
+    ["osmd", "agent", "update", parentRef, "notes.md", "--content", notesContent],
+    env
+  );
+  results.push(agentUpdate);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: `osmd.agent update notes parent=${parentRef}`,
+    result: agentUpdate,
+    ok:
+      agentUpdate.parsed?.ok === true &&
+      agentUpdate.parsed?.data?.access === "read_write" &&
+      agentUpdate.parsed?.data?.content === notesContent,
+    reason: "agent_overlay_update"
+  });
+
+  const logEntry = `CLI live verify log append ${verifyStamp}`;
+  const agentAppend = runWave(
+    ["osmd", "agent", "append", parentRef, "log.md", "--content", logEntry],
+    env
+  );
+  results.push(agentAppend);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: `osmd.agent append log parent=${parentRef}`,
+    result: agentAppend,
+    ok:
+      agentAppend.parsed?.ok === true &&
+      agentAppend.parsed?.data?.access === "append_only" &&
+      String(agentAppend.parsed?.data?.content ?? "").includes(logEntry),
+    reason: "agent_overlay_append"
+  });
+
+  const appendRefusal = runWave(
+    [
+      "osmd",
+      "agent",
+      "append",
+      parentRef,
+      "notes.md",
+      "--content",
+      "verify append refusal"
+    ],
+    env
+  );
+  results.push(appendRefusal);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: `osmd.agent append refuses read_write notes parent=${parentRef}`,
+    result: appendRefusal,
+    ok:
+      appendRefusal.code === 4 &&
+      appendRefusal.parsed?.ok === false &&
+      appendRefusal.parsed?.status === 403 &&
+      appendRefusal.parsed?.error?.code === "append_only_violation" &&
+      appendRefusal.parsed?.error?.suggestedAction === "update" &&
+      appendRefusal.parsed?.data?.canAppend === false,
+    reason: "agent_overlay_append_refusal"
+  });
+}
+
+runOsmdLiveVerification();
+
 const lines = [];
 let failures = 0;
 for (const res of results) {
@@ -1128,6 +1338,10 @@ if (postUpdateVerificationLines.length > 0) {
   lines.push(...postUpdateVerificationLines);
 }
 failures += postUpdateVerificationFailures;
+if (osmdVerificationLines.length > 0) {
+  lines.push(...osmdVerificationLines);
+}
+failures += osmdVerificationFailures;
 failures += validationRemediationFailures;
 
 if (validationRemediationEntries.length > 0) {