@cairnkeep/cli 2.9.0 → 2.12.0

package/scripts/test-windows-native.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+import assert from "node:assert/strict";
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { gzipSync } from "node:zlib";
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+import {
+  bootstrapWindows,
+  createTar,
+  extractTar,
+  launcherModule,
+  launcherPowerShell,
+  powershellCompletion,
+  runWindowsCommand,
+} from "./windows-platform.mjs";
+import { runNativeContainer } from "./cairn-container-cli.mjs";
+import { HARNESS_IDS } from "./harness-registry.mjs";
+
+const root = resolve(fileURLToPath(new URL("..", import.meta.url)));
+const sandbox = mkdtempSync(join(tmpdir(), "cairn-windows-native-"));
+const originalBase = process.env.CAIRN_AGENTFS_BASE_DIR;
+const originalHome = process.env.HOME;
+const originalProfile = process.env.USERPROFILE;
+try {
+  process.env.HOME = sandbox;
+  process.env.USERPROFILE = sandbox;
+  const project = join(sandbox, "Project with spaces – Unicode");
+  mkdirSync(project, { recursive: true });
+  bootstrapWindows(root, [project]);
+  for (const harness of HARNESS_IDS) {
+    assert.ok(existsSync(join(project, ".ai", `start-${harness}.cmd`)), `${harness} cmd launcher`);
+  }
+  assert.match(readFileSync(join(project, ".ai", "start-claude.cmd"), "utf8"), /start-harness\.ps1/);
+  assert.match(launcherModule(), /spawnSync\(command/);
+  assert.match(launcherPowerShell(), /pre-launch\.ps1/);
+  assert.match(launcherPowerShell(), /post-exit\.ps1/);
+
+  const claudeRoot = join(sandbox, "Claude Config");
+  await runWindowsCommand({ command: "sync", args: ["--apply", "--live-root", claudeRoot], root });
+  assert.ok(existsSync(join(claudeRoot, "commands", "remember.md")));
+  assert.ok(existsSync(join(claudeRoot, "hooks", "memory-wakeup.cmd")));
+  const settings = JSON.parse(readFileSync(join(claudeRoot, "settings.json"), "utf8"));
+  assert.ok(settings.hooks.SessionStart.some((entry) => entry.hooks.some((hook) => /memory-wakeup/.test(hook.command))));
+  await runWindowsCommand({ command: "sync", args: ["--check", "--live-root", claudeRoot], root });
+
+  const payloads = [["project.db", Buffer.from("sqlite-a")], ["team.db", Buffer.from("sqlite-b")]];
+  const tar = createTar(payloads);
+  assert.deepEqual(extractTar(tar), payloads);
+  assert.throws(() => extractTar(Buffer.from(tar).fill(0x2e, 0, 12)), /checksum|unsafe|unsupported/);
+  const archive = join(sandbox, "memory.tgz");
+  writeFileSync(archive, gzipSync(tar));
+  const memory = join(sandbox, "Memory Store");
+  process.env.CAIRN_AGENTFS_BASE_DIR = memory;
+  await runWindowsCommand({ command: "memory", args: ["import", archive], root });
+  assert.equal(readFileSync(join(memory, "project.db"), "utf8"), "sqlite-a");
+  assert.match(powershellCompletion(), /Register-ArgumentCompleter/);
+
+  let containerArgs = [];
+  runNativeContainer(["stdio", "--image", "example/windows:1", "--volume", "windows-data"], root, (_engine, args) => { containerArgs = args; });
+  assert.ok(containerArgs.includes("--read-only"));
+  assert.ok(containerArgs.includes("windows-data:/data:Z,U"));
+  assert.ok(containerArgs.includes("example/windows:1"));
+
+  await runWindowsCommand({ command: "uninstall", args: ["--yes", "--live-root", claudeRoot, project], root });
+  assert.ok(!existsSync(join(project, ".ai", "start-claude.cmd")));
+  assert.ok(!existsSync(join(claudeRoot, "commands", "remember.md")));
+  const cleanedSettings = JSON.parse(readFileSync(join(claudeRoot, "settings.json"), "utf8"));
+  assert.ok(!JSON.stringify(cleanedSettings).includes("memory-wakeup"));
+
+  const setupSurfaceComplete = [
+    join(root, "scripts", "setup.mjs"),
+    join(root, "scripts", "setup-core.mjs"),
+    join(root, "scripts", "setup-reconcile.mjs"),
+    join(root, "schemas", "cairnkeep-setup.schema.json"),
+    join(root, "schemas", "cairnkeep-setup-policy.schema.json"),
+  ].every((candidate) => existsSync(candidate))
+    && /case\s+["']setup["']/.test(readFileSync(join(root, "scripts", "windows-platform.mjs"), "utf8"))
+    && /["']setup["']/.test(powershellCompletion());
+
+  if (!setupSurfaceComplete) {
+    if (process.env.CAIRN_PHASE26_RED === "1") {
+      console.log("PHASE26_RED:WINDOWS_SETUP_MISSING");
+      process.exitCode = 86;
+    } else {
+      console.log("SKIP: simulated Windows guided setup surface is not complete");
+      console.log("PASS: native Windows CLI lifecycle, paths, archive safety, hooks, and PowerShell completion");
+    }
+  } else {
+    const setupProject = join(sandbox, "Guided Project with spaces – Unicode");
+    let output = "";
+    const originalWrite = process.stdout.write.bind(process.stdout);
+    process.stdout.write = ((chunk, ...args) => {
+      output += String(chunk);
+      return true;
+    });
+    try {
+      const handled = await runWindowsCommand({
+        command: "setup",
+        args: [setupProject, "--git", "none", "--harness", "claude,pi", "--memory", "local", "--yes", "--json"],
+        root,
+      });
+      assert.equal(handled, true);
+    } finally {
+      process.stdout.write = originalWrite;
+    }
+    const setupResult = JSON.parse(output);
+    assert.equal(setupResult.schema_version, 1);
+    assert.equal(setupResult.status, "limited");
+    assert.equal(setupResult.git, "none");
+    assert.equal(setupResult.memory, "local");
+    assert.deepEqual(setupResult.harnesses, ["claude", "pi"]);
+    assert.equal(Array.isArray(setupResult.recovery), true);
+    assert.equal(setupResult.recovery.some((line) => /cairn (?:setup|sync)/.test(line)), true);
+
+    const setupStatePath = join(setupProject, ".ai", "cairnkeep.json");
+    assert.ok(existsSync(setupStatePath));
+    const setupState = JSON.parse(readFileSync(setupStatePath, "utf8"));
+    const serializedState = JSON.stringify(setupState);
+    assert.equal(serializedState.includes(setupProject), false);
+    assert.doesNotMatch(serializedState, /(?:token|secret|credential|endpoint|username|environment|https?:)/i);
+    assert.match(powershellCompletion(), /--git/);
+    assert.match(powershellCompletion(), /--harness/);
+    assert.match(powershellCompletion(), /--memory/);
+    assert.match(powershellCompletion(), /--policy/);
+    assert.match(powershellCompletion(), /--yes/);
+    assert.match(powershellCompletion(), /--json/);
+    assert.match(powershellCompletion(), /codex/);
+
+    const codexProject = join(sandbox, "Guided Codex Project");
+    let codexOutput = "";
+    process.stdout.write = ((chunk) => {
+      codexOutput += String(chunk);
+      return true;
+    });
+    try {
+      await runWindowsCommand({
+        command: "setup",
+        args: [codexProject, "--git", "none", "--harness", "codex", "--memory", "local", "--yes", "--json"],
+        root,
+      });
+    } finally {
+      process.stdout.write = originalWrite;
+    }
+    const codexResult = JSON.parse(codexOutput);
+    assert.deepEqual(codexResult.harnesses, ["codex"]);
+    assert.equal(codexResult.machine_sync.command, null);
+    assert.ok(existsSync(join(codexProject, ".ai", "start-codex.cmd")));
+    assert.match(readFileSync(join(codexProject, ".codex", "config.toml"), "utf8"), /mcp_servers\.cairn-memory/);
+    console.log("PASS: simulated Windows setup parity, private state, recovery, and completion contract");
+  }
+} finally {
+  if (originalBase === undefined) delete process.env.CAIRN_AGENTFS_BASE_DIR;
+  else process.env.CAIRN_AGENTFS_BASE_DIR = originalBase;
+  if (originalHome === undefined) delete process.env.HOME; else process.env.HOME = originalHome;
+  if (originalProfile === undefined) delete process.env.USERPROFILE; else process.env.USERPROFILE = originalProfile;
+  rmSync(sandbox, { recursive: true, force: true });
+}

package/scripts/uninstall.sh

@@ -45,6 +45,7 @@ PROJECT_AI_FILES=(
   start-pi.sh
   start-kimi.sh
   start-qwen.sh
+  start-codex.sh
   env.example
   trajectory-redaction.json
   capabilities.json
@@ -125,6 +126,51 @@ remove_path() {
   echo "  removed: $abs"
 }
 
+# Print only package-known relative paths from a valid guided-setup ownership
+# record. The record identifies candidates, but never grants authority to an
+# arbitrary path. Modified candidates are still backed up before removal.
+setup_owned_paths() {
+  node --input-type=module - "$1" "$CAIRN_ROOT/scripts/harness-registry.mjs" <<'NODE'
+import { lstatSync, readFileSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+const path = process.argv[2];
+const registry = await import(pathToFileURL(process.argv[3]).href);
+const info = lstatSync(path);
+if (!info.isFile() || info.isSymbolicLink() || info.size > 1024 * 1024) process.exit(1);
+if (process.platform !== "win32" && (info.mode & 0o777) !== 0o600) process.exit(1);
+const state = JSON.parse(readFileSync(path, "utf8"));
+const exact = (value, keys) => value && typeof value === "object" && !Array.isArray(value)
+  && Object.keys(value).sort().join(",") === [...keys].sort().join(",");
+if (!exact(state, ["schema_version", "cairnkeep_version", "git", "memory", "harnesses", "assets"])
+    || state.schema_version !== 1
+    || !["init", "existing", "none"].includes(state.git)
+    || !["local", "none"].includes(state.memory)
+    || !Array.isArray(state.harnesses)
+    || !state.assets
+    || typeof state.assets !== "object"
+    || Array.isArray(state.assets)) process.exit(1);
+const allowed = new Set([
+  ".ai/env.example", ".ai/trajectory-redaction.json", ".ai/capabilities.json",
+  ".agentfs/.gitignore", ".planning/config.json", ".planning/PROJECT-BRIEF.md",
+  ".planning/wiki/index.md", ".planning/wiki/policy.md", ".planning/wiki/CONTRADICTIONS.md",
+  ".planning/wiki/LOG.md", ".planning/alignment/policy.md", ".planning/alignment/gap-register.yaml",
+  ".planning/graphs/policy.md", ".planning/graphs/.gitignore", ".planning/security/policy.md",
+  ".ai/start-harness.mjs", ".ai/start-harness.ps1",
+  ...registry.HARNESS_IDS.flatMap((name) => [`.ai/start-${name}.sh`, `.ai/start-${name}.cmd`]),
+  ...registry.HARNESS_IDS.flatMap((name) => registry.harnessProjectAssets(name, "local").map(({ path }) => path)),
+]);
+for (const [asset, record] of Object.entries(state.assets)) {
+  if (!allowed.has(asset)
+      || !exact(record, ["digest", "mode", "template"])
+      || !/^[a-f0-9]{64}$/.test(record.digest)
+      || !Number.isInteger(record.mode)
+      || record.mode < 0 || record.mode > 0o777
+      || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(record.template)) process.exit(1);
+}
+process.stdout.write(`${Object.keys(state.assets).sort().join("\n")}\n`);
+NODE
+}
+
 note() { [[ $DRY_RUN -eq 1 ]] || { ensure_bundle; printf '%s\n' "$1" >>"$NOTES"; }; }
 
 # ---- what will be removed ----------------------------------------------------
@@ -164,6 +210,7 @@ while IFS= read -r dst; do remove_path "$dst"; done < <(asset_dests)
 # These are precisely owned adapter paths; do not touch neighboring harness
 # configuration in either user root.
 echo "Pi adapters:"
+remove_path "$PI_LIVE_ROOT/extensions/cairnkeep-memory.ts"
 remove_path "$PI_LIVE_ROOT/extensions/cairnkeep-trajectory.ts"
 remove_path "$PI_LIVE_ROOT/prompts/graphify.md"
 echo "Kimi adapter:"
@@ -268,13 +315,33 @@ for proj in "${PROJECTS[@]:-}"; do
   # hook registrations and OpenCode plugin bytes restore together exactly.
   # Normal and master-off installations never create it, so absence is inert.
   remove_path "$proj/.ai/capability-contract"
-  for rel in "${PROJECT_AI_FILES[@]}"; do
-    remove_path "$proj/.ai/$rel"
-  done
-  if [[ $DRY_RUN -eq 0 && -d "$proj/.ai" ]]; then
-    rmdir "$proj/.ai" 2>/dev/null || true
+  setup_state="$proj/.ai/cairnkeep.json"
+  if [[ -e "$setup_state" ]]; then
+    if owned_paths=$(setup_owned_paths "$setup_state" 2>/dev/null); then
+      while IFS= read -r rel; do
+        [[ -n "$rel" ]] && remove_path "$proj/$rel"
+      done <<< "$owned_paths"
+      remove_path "$setup_state"
+      if [[ $DRY_RUN -eq 0 ]]; then
+        for managed_dir in \
+          "$proj/.planning/wiki" "$proj/.planning/alignment" "$proj/.planning/graphs" \
+          "$proj/.planning/security" "$proj/.planning" "$proj/.codex" "$proj/.ai" "$proj/.agentfs"; do
+          rmdir "$managed_dir" 2>/dev/null || true
+        done
+      fi
+    else
+      echo "  kept guided setup scaffold: ownership state is invalid or unsafe"
+    fi
+  else
+    # Compatibility path for projects created by the legacy bootstrap command.
+    for rel in "${PROJECT_AI_FILES[@]}"; do
+      remove_path "$proj/.ai/$rel"
+    done
+    if [[ $DRY_RUN -eq 0 && -d "$proj/.ai" ]]; then
+      rmdir "$proj/.ai" 2>/dev/null || true
+    fi
+    remove_path "$proj/.planning"
   fi
-  remove_path "$proj/.planning"
   if [[ $PURGE_MEMORY -eq 1 ]]; then
     remove_path "$proj/.agentfs"
   elif [[ -d "$proj/.agentfs" ]]; then