@ted-galago/wave-cli 0.1.17 → 0.1.18

package/README.md

@@ -129,6 +129,7 @@ wave osmd agent read "projects/Wave Tools" notes.md
 wave osmd agent create "projects/Wave Tools" notes.md --content "Working notes"
 wave osmd wiki read index.md
 wave osmd wiki read log.md
+wave osmd wiki init
 wave osmd wiki create index.md --content "# Agent Wiki"
 wave osmd wiki update "Agent Wiki/index.md" --file ./agent-wiki-index.md
 wave osmd wiki append-log --content "Observed durable event"
@@ -315,6 +316,7 @@ Commands:
 - `wave osmd agent create <parent-ref> notes.md (--content <markdown> | --file <path> | stdin)`
 - `wave osmd agent update <parent-ref> notes.md (--content <markdown> | --file <path> | stdin)`
 - `wave osmd wiki status <path>`
+- `wave osmd wiki init`
 - `wave osmd wiki read <path>`
 - `wave osmd wiki children [path]`
 - `wave osmd wiki create <path> (--content <markdown> | --file <path> | stdin)`
@@ -327,6 +329,7 @@ GraphQL mapping:
 - `osmd read` / `osmd agent read` / `osmd wiki read` -> `agentMarkdownFile`
 - `osmd children` / `osmd wiki children` -> `agentMarkdownChildren`
 - `osmd agent init` -> `initAgentMarkdown`
+- `osmd wiki init` -> `initAgentMarkdown` with backend path `Agent Wiki`
 - `osmd agent create` / `osmd wiki create` -> `createAgentMarkdownFile`
 - `osmd agent update` / `osmd wiki update` -> `updateAgentMarkdownFile`
 - `osmd wiki append-log` -> `recordAgentMarkdownLog`
@@ -341,6 +344,7 @@ Path and permission rules:
 - Agent Wiki index paths may be `index.md` or `Agent Wiki/index.md`; the CLI normalizes these to `Agent Wiki/index.md`.
 - Agent Wiki log paths may be `log.md` or `Agent Wiki/log.md`; the CLI normalizes these to `Agent Wiki/log.md`.
 - Agent Wiki first-slice agents should use `index.md` for broad writable wiki memory and `log.md` for append-only event memory.
+- Agent Wiki `init` initializes backend-owned system files, including append-only `log.md`, through `initAgentMarkdown` at path `Agent Wiki`.
 - Agent Wiki `create` and `update` support only `index.md`; `log.md` cannot be overwritten.
 - Agent Wiki `append-log` supports only `log.md` and calls status first before appending.
 - The CLI uses backend GraphQL metadata directly and does not derive S3 paths, SHA paths, or backend storage conventions.
@@ -350,6 +354,7 @@ Path and permission rules:
 - `create` fails when `exists` is true.
 - `update` fails when `exists` is false.
 - `append-log` fails unless status reports `exists: true`, `access: "append_only"`, and `canAppend: true`.
+- When `Agent Wiki/log.md` is missing and status reports `suggestedAction: "init"`, `append-log` returns a JSON error telling Atlas to run `wave osmd wiki init`.
 - Missing `Agent Wiki/index.md` is create-ready when status returns `exists: false`, `canCreate: true`, `canUpdate: false`, and `suggestedAction: "create"`.
 
 OSMD command envelopes keep the global CLI envelope and put the file metadata directly in `data`:

package/dist/index.cjs

@@ -6632,7 +6632,7 @@ function writePreflightError(status, action) {
     if (!status.exists) {
       return {
         code: "agent_file_not_found",
-        message: `Agent markdown file does not exist: ${status.path}`,
+        message: status.suggestedAction === "init" ? `Agent Wiki log is not initialized. Run wave osmd wiki init before append-log.` : `Agent markdown file does not exist: ${status.path}`,
         suggestedAction: status.suggestedAction,
         status: 404
       };
@@ -6891,6 +6891,19 @@ function registerOsmdCommands(program) {
     }
   );
   const wiki = osmd.command("wiki").description("Agent Wiki files writable by agents; supports index.md and append-only log.md");
+  wiki.command("init").description("Idempotently initialize Agent Wiki system files").action(async function() {
+    const { organizationId, runtimeOptions } = await resolveOsmdContext(this);
+    return runAgentMarkdownMutation({
+      command: "osmd.wiki.init",
+      operationName: "InitAgentMarkdown",
+      runtimeOptions,
+      field: "init_agent_markdown",
+      variables: {
+        organization_id: organizationId,
+        path: "Agent Wiki"
+      }
+    });
+  });
   wiki.command("status <path>").description("Show Agent Wiki index.md or log.md metadata without creating files").action(async (path, _opts, cmd) => {
     const { organizationId, runtimeOptions } = await resolveOsmdContext(cmd);
     const result = await requestAgentMarkdownStatus({

package/dist/index.js

@@ -6631,7 +6631,7 @@ function writePreflightError(status, action) {
     if (!status.exists) {
       return {
         code: "agent_file_not_found",
-        message: `Agent markdown file does not exist: ${status.path}`,
+        message: status.suggestedAction === "init" ? `Agent Wiki log is not initialized. Run wave osmd wiki init before append-log.` : `Agent markdown file does not exist: ${status.path}`,
         suggestedAction: status.suggestedAction,
         status: 404
       };
@@ -6890,6 +6890,19 @@ function registerOsmdCommands(program) {
     }
   );
   const wiki = osmd.command("wiki").description("Agent Wiki files writable by agents; supports index.md and append-only log.md");
+  wiki.command("init").description("Idempotently initialize Agent Wiki system files").action(async function() {
+    const { organizationId, runtimeOptions } = await resolveOsmdContext(this);
+    return runAgentMarkdownMutation({
+      command: "osmd.wiki.init",
+      operationName: "InitAgentMarkdown",
+      runtimeOptions,
+      field: "init_agent_markdown",
+      variables: {
+        organization_id: organizationId,
+        path: "Agent Wiki"
+      }
+    });
+  });
   wiki.command("status <path>").description("Show Agent Wiki index.md or log.md metadata without creating files").action(async (path, _opts, cmd) => {
     const { organizationId, runtimeOptions } = await resolveOsmdContext(cmd);
     const result = await requestAgentMarkdownStatus({

package/package.json

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

package/scripts/verify-dev-api.mjs

@@ -1228,27 +1228,66 @@ function runOsmdLiveVerification() {
     reason: "agent_wiki_log_read"
   });
 
+  if (wikiLogStatus.parsed?.data?.exists === false) {
+    const missingWikiLogAppend = runWave(
+      ["osmd", "wiki", "append-log", "--content", `CLI live verify log ${verifyStamp}`],
+      env
+    );
+    results.push(missingWikiLogAppend);
+    osmdVerificationFailures += recordExactCheck({
+      lines: osmdVerificationLines,
+      label: "osmd.wiki append-log missing log returns init guidance",
+      result: missingWikiLogAppend,
+      ok:
+        missingWikiLogAppend.parsed?.ok === false &&
+        missingWikiLogAppend.parsed?.status === 404 &&
+        missingWikiLogAppend.parsed?.error?.code === "agent_file_not_found" &&
+        missingWikiLogAppend.parsed?.error?.suggestedAction === "init" &&
+        String(missingWikiLogAppend.parsed?.error?.message ?? "").includes("wave osmd wiki init") &&
+        missingWikiLogAppend.parsed?.data?.path === "Agent Wiki/log.md" &&
+        missingWikiLogAppend.parsed?.data?.canAppend === false,
+      reason: "agent_wiki_log_missing_init_guidance"
+    });
+  } else {
+    osmdVerificationLines.push(
+      "PASS | status=n/a | err=skipped_existing_log | reason=missing_log_init_guidance_skipped | osmd.wiki append-log missing log returns init guidance"
+    );
+  }
+
+  const wikiInit = runWave(["osmd", "wiki", "init"], env);
+  results.push(wikiInit);
+  const wikiInitFiles = firstArrayValue(wikiInit.parsed, [["data", "files"]]);
+  osmdVerificationFailures += recordExactCheck({
+    lines: osmdVerificationLines,
+    label: "osmd.wiki init creates Agent Wiki system files",
+    result: wikiInit,
+    ok:
+      wikiInit.parsed?.ok === true &&
+      wikiInitFiles.some(
+        (file) =>
+          file?.path === "Agent Wiki/log.md" &&
+          file?.access === "append_only" &&
+          file?.exists === true &&
+          file?.canAppend === true
+      ),
+    reason: "agent_wiki_init"
+  });
+
   const wikiLogAppend = runWave(
     ["osmd", "wiki", "append-log", "--content", `CLI live verify log ${verifyStamp}`],
     env
   );
   results.push(wikiLogAppend);
-  const logAppendAllowed =
-    wikiLogStatus.parsed?.data?.exists === true &&
-    wikiLogStatus.parsed?.data?.access === "append_only" &&
-    wikiLogStatus.parsed?.data?.canAppend === true;
   osmdVerificationFailures += recordExactCheck({
     lines: osmdVerificationLines,
-    label: "osmd.wiki append-log follows backend canAppend",
+    label: "osmd.wiki append-log succeeds after init",
     result: wikiLogAppend,
-    ok: logAppendAllowed
-      ? wikiLogAppend.parsed?.ok === true &&
-        wikiLogAppend.parsed?.data?.path === "Agent Wiki/log.md" &&
-        wikiLogAppend.parsed?.data?.access === "append_only"
-      : wikiLogAppend.parsed?.ok === false &&
-        wikiLogAppend.parsed?.data?.path === "Agent Wiki/log.md" &&
-        wikiLogAppend.parsed?.data?.canAppend === false,
-    reason: "agent_wiki_log_append"
+    ok:
+      wikiLogAppend.parsed?.ok === true &&
+      wikiLogAppend.parsed?.data?.path === "Agent Wiki/log.md" &&
+      wikiLogAppend.parsed?.data?.access === "append_only" &&
+      wikiLogAppend.parsed?.data?.canAppend === true,
+    reason: "agent_wiki_log_append_after_init"
   });
 
   if (wikiStatus.parsed?.data?.exists === false) {