@kal-elsam/kairo-runtime 0.1.0

package/scripts/smoke-test.sh

@@ -0,0 +1,197 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+WORKDIR="$(mktemp -d)"
+FAKE_HOME="$(mktemp -d)"
+TARBALL=""
+
+cleanup() {
+  rm -rf "$WORKDIR" "$FAKE_HOME"
+  if [ -n "$TARBALL" ] && [ -f "$ROOT/$TARBALL" ]; then
+    rm -f "$ROOT/$TARBALL"
+  fi
+}
+trap cleanup EXIT
+
+assert_file_equals() {
+  local file="$1"
+  local expected="$2"
+  local label="${3:-$file}"
+
+  if [ "$(cat "$file")" != "$expected" ]; then
+    echo "Assertion failed: $label content mismatch" >&2
+    exit 1
+  fi
+}
+
+assert_harness_home_isolated() {
+  if [ -z "${HARNESS_HOME:-}" ]; then
+    echo "HARNESS_HOME must be set for smoke tests" >&2
+    exit 1
+  fi
+
+  if [ "$HARNESS_HOME" = "$HOME" ] || [ "$HARNESS_HOME" = "${HOME}/.harness" ]; then
+    echo "Smoke must not use the real home directory" >&2
+    exit 1
+  fi
+
+  if [ -d "$HOME/.harness" ] && [ "$HARNESS_HOME" = "$HOME/.harness" ]; then
+    echo "Smoke must not touch real ~/.harness" >&2
+    exit 1
+  fi
+}
+
+echo "Packing $(node -p "require('$ROOT/package.json').name") from $ROOT"
+TARBALL="$(cd "$ROOT" && npm pack --silent)"
+
+echo "Installing tarball in $WORKDIR"
+cd "$WORKDIR"
+npm init -y >/dev/null
+npm install "$ROOT/$TARBALL" >/dev/null
+
+mkdir -p "$FAKE_HOME/.cursor" "$FAKE_HOME/.codex"
+printf '%s\n' "SMOKE_USER_MARKER=before-install" >"$FAKE_HOME/.cursor/AGENTS.md"
+export HARNESS_HOME="$FAKE_HOME"
+assert_harness_home_isolated
+
+echo
+echo "== kairo setup --dry-run =="
+npx --no-install kairo setup --dry-run
+
+echo
+echo "== kairo status (before install) =="
+if npx --no-install kairo status; then
+  echo "Expected status to fail before install" >&2
+  exit 1
+fi
+
+echo
+echo "== kairo install --dry-run (agent-global) =="
+npx --no-install kairo install --dry-run
+
+echo
+echo "== kairo install (agent-global) =="
+npx --no-install kairo install
+
+echo
+echo "== kairo status (after install) =="
+npx --no-install kairo status
+
+SNAPSHOT="$(ls -A "$FAKE_HOME/.harness/backups" | head -1)"
+BACKUP_FILE="$(ls -A "$FAKE_HOME/.harness/backups/$SNAPSHOT" | head -1)"
+
+if [ -z "$SNAPSHOT" ] || [ -z "$BACKUP_FILE" ]; then
+  echo "Expected install to create a backup snapshot with files" >&2
+  exit 1
+fi
+
+EXPECTED_BACKUP_CONTENT="$(cat "$FAKE_HOME/.harness/backups/$SNAPSHOT/$BACKUP_FILE")"
+
+echo
+echo "== kairo doctor (agent-global) =="
+npx --no-install kairo doctor
+
+echo
+echo "== simulate drift + doctor detects it =="
+rm -f "$FAKE_HOME/.harness/components/sdd-core/workflow.md"
+node -e "
+const fs = require('node:fs');
+const path = require('node:path');
+const config = path.join(process.env.HARNESS_HOME, '.cursor', 'AGENTS.md');
+const content = fs.readFileSync(config, 'utf8');
+fs.writeFileSync(config, content.replace('### SDD Core', '### Broken'));
+"
+if npx --no-install kairo doctor; then
+  echo "Expected doctor to fail after drift simulation" >&2
+  exit 1
+fi
+
+echo
+echo "== kairo sync repairs drift =="
+npx --no-install kairo sync --yes
+
+echo
+echo "== kairo status after sync =="
+npx --no-install kairo status
+
+echo
+echo "== kairo doctor after repair =="
+npx --no-install kairo doctor
+
+echo
+echo "== kairo history after sync =="
+npx --no-install kairo history --json | node -e "
+const fs = require('node:fs');
+let input = '';
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
+  const parsed = JSON.parse(input.trim());
+  if (!Array.isArray(parsed.events) || parsed.events.length < 1) {
+    console.error('Expected history events after managed operations');
+    process.exit(1);
+  }
+  const commands = new Set(parsed.events.map((event) => event.command));
+  if (!commands.has('sync')) {
+    console.error('Expected sync event in history');
+    process.exit(1);
+  }
+});
+"
+
+echo
+echo "== kairo backups =="
+npx --no-install kairo backups
+
+printf '%s\n' "SMOKE_USER_MARKER=corrupted" >"$FAKE_HOME/.cursor/AGENTS.md"
+BEFORE_PREVIEW="$(cat "$FAKE_HOME/.cursor/AGENTS.md")"
+
+echo
+echo "== kairo rollback preview (dry-run) =="
+npx --no-install kairo rollback --to "$SNAPSHOT"
+AFTER_PREVIEW="$(cat "$FAKE_HOME/.cursor/AGENTS.md")"
+
+if [ "$BEFORE_PREVIEW" != "$AFTER_PREVIEW" ]; then
+  echo "Rollback preview mutated files" >&2
+  exit 1
+fi
+
+if [ "$AFTER_PREVIEW" = "$EXPECTED_BACKUP_CONTENT" ]; then
+  echo "Rollback preview unexpectedly restored content" >&2
+  exit 1
+fi
+
+SNAPSHOT_COUNT_BEFORE="$(ls -A "$FAKE_HOME/.harness/backups" | wc -l | tr -d ' ')"
+
+echo
+echo "== kairo rollback apply =="
+npx --no-install kairo rollback --to "$SNAPSHOT" --apply
+
+assert_file_equals "$FAKE_HOME/.cursor/AGENTS.md" "$EXPECTED_BACKUP_CONTENT" "rollback target"
+
+SNAPSHOT_COUNT_AFTER="$(ls -A "$FAKE_HOME/.harness/backups" | wc -l | tr -d ' ')"
+if [ "$SNAPSHOT_COUNT_AFTER" -le "$SNAPSHOT_COUNT_BEFORE" ]; then
+  echo "Expected rollback apply to create a safety backup snapshot" >&2
+  exit 1
+fi
+
+echo
+echo "== kairo uninstall (agent-global) =="
+npx --no-install kairo uninstall
+
+unset HARNESS_HOME
+
+echo
+echo "== kairo install --scope=workspace --mode enterprise =="
+npx --no-install kairo install --scope=workspace --mode enterprise
+
+echo
+echo "== kairo doctor --scope=workspace =="
+npx --no-install kairo doctor --scope=workspace
+
+echo
+echo "== kairo update --scope=workspace --dry-run =="
+npx --no-install kairo update --scope=workspace --dry-run
+
+echo
+echo "Smoke test passed."

package/scripts/ux-smoke-test.sh

@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+# UX smoke — read-only terminal output checks for clarity and copy consistency.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+HARNESS_BIN="$ROOT/bin/harness.js"
+FAKE_HOME="$(mktemp -d)"
+CAPTURE_DIR="$(mktemp -d)"
+
+cleanup() {
+  rm -rf "$FAKE_HOME" "$CAPTURE_DIR"
+}
+trap cleanup EXIT
+
+export HARNESS_HOME="$FAKE_HOME"
+
+run_capture() {
+  local label="$1"
+  shift
+  local outfile="$CAPTURE_DIR/${label}.txt"
+  local errfile="$CAPTURE_DIR/${label}.stderr.txt"
+  local status=0
+
+  set +e
+  node "$HARNESS_BIN" "$@" >"$outfile" 2>"$errfile"
+  status=$?
+  set -e
+
+  echo "$status" >"$CAPTURE_DIR/${label}.exit"
+  echo "== $label =="
+  cat "$outfile"
+  if [ -s "$errfile" ]; then
+    cat "$errfile" >&2
+  fi
+  return 0
+}
+
+assert_contains() {
+  local file="$1"
+  local needle="$2"
+  local label="${3:-$file}"
+
+  if ! grep -Fq "$needle" "$file"; then
+    echo "UX smoke failed: expected '$needle' in $label" >&2
+    exit 1
+  fi
+}
+
+assert_not_contains() {
+  local file="$1"
+  local needle="$2"
+  local label="${3:-$file}"
+
+  if grep -Fq "$needle" "$file"; then
+    echo "UX smoke failed: did not expect '$needle' in $label" >&2
+    exit 1
+  fi
+}
+
+assert_exit() {
+  local label="$1"
+  local expected="$2"
+  local actual
+
+  actual="$(cat "$CAPTURE_DIR/${label}.exit")"
+  if [ "$actual" != "$expected" ]; then
+    echo "UX smoke failed: $label exit $actual, expected $expected" >&2
+    exit 1
+  fi
+}
+
+mkdir -p "$FAKE_HOME/.cursor" "$FAKE_HOME/.codex"
+printf '%s\n' "# user content" >"$FAKE_HOME/.cursor/AGENTS.md"
+
+echo "Kairo Runtime UX smoke — capturing terminal output to $CAPTURE_DIR"
+echo
+
+run_capture help help
+assert_contains "$CAPTURE_DIR/help.txt" "JSON output (--json on supported commands):"
+assert_contains "$CAPTURE_DIR/help.txt" "report"
+assert_contains "$CAPTURE_DIR/help.txt" "More examples: README.md"
+assert_not_contains "$CAPTURE_DIR/help.txt" "Stable fields: ok, overall"
+assert_exit help 0
+
+run_capture setup-dry-run setup --dry-run
+assert_contains "$CAPTURE_DIR/setup-dry-run.txt" "Dry run: nothing was written."
+assert_contains "$CAPTURE_DIR/setup-dry-run.txt" "Backups planned:"
+assert_not_contains "$CAPTURE_DIR/setup-dry-run.txt" "Local Agent Operating System"
+assert_exit setup-dry-run 0
+
+run_capture status-missing status
+assert_contains "$CAPTURE_DIR/status-missing.txt" "Overall: MISSING"
+assert_exit status-missing 1
+
+run_capture setup-yes setup --yes --agents cursor
+assert_exit setup-yes 0
+
+run_capture status-ok status
+assert_contains "$CAPTURE_DIR/status-ok.txt" "Overall: OK"
+assert_exit status-ok 0
+
+rm -f "$FAKE_HOME/.harness/components/sdd-core/workflow.md"
+
+run_capture status-drift status
+assert_contains "$CAPTURE_DIR/status-drift.txt" "Overall: DRIFT"
+assert_exit status-drift 1
+
+run_capture sync-dry-run sync --dry-run --yes
+assert_contains "$CAPTURE_DIR/sync-dry-run.txt" "Planned repairs:"
+assert_contains "$CAPTURE_DIR/sync-dry-run.txt" "Backups planned:"
+assert_exit sync-dry-run 1
+
+run_capture history history
+assert_contains "$CAPTURE_DIR/history.txt" "Kairo Runtime history"
+assert_exit history 0
+
+run_capture history-last history last
+assert_contains "$CAPTURE_DIR/history-last.txt" "Kairo Runtime history last"
+assert_exit history-last 0
+
+run_capture report report
+assert_contains "$CAPTURE_DIR/report.txt" "Kairo Runtime report"
+assert_contains "$CAPTURE_DIR/report.txt" "Diff:"
+assert_exit report 1
+
+run_capture invalid-command not-a-command
+assert_contains "$CAPTURE_DIR/invalid-command.stderr.txt" 'Unknown command "not-a-command"'
+assert_exit invalid-command 1
+
+run_capture invalid-limit history --limit 0
+assert_contains "$CAPTURE_DIR/invalid-limit.stderr.txt" "Invalid --limit"
+assert_exit invalid-limit 1
+
+run_capture consent-missing setup --agents cursor
+assert_contains "$CAPTURE_DIR/consent-missing.stderr.txt" "Non-interactive setup requires"
+assert_not_contains "$CAPTURE_DIR/consent-missing.txt" "Local Agent Operating System"
+assert_exit consent-missing 1
+
+echo
+echo "UX smoke passed. Captures kept in $CAPTURE_DIR until exit."