Files
Jon Chery fc94326b0e feat(P00): deprecation sweep + bash tooling gate + render contract + doc banners (v0.9 P00)
P00 — Re-architecture Foundation (deprecation/migration/test-infra/persona/docs).

Deprecation sweep (REQ-068, REQ-072, REQ-089):
- Add // Deprecated: doc comments to internal/daemon (R-001), internal/transport
  (REQ-073), internal/security/ca.go+csr.go (D-101/REQ-076), internal/engine/
  dispatcher.go+peer.go (CLI-side scheduler), internal/cli/daemon.go.
- orca daemon emits slog.Warn deprecation banner on every run (ungated); fires
  R-001 + v0.10-P05 drain-and-stop + v0.10-P14 deletion.
- orca cert and orca node join (mTLS path) emit deprecation warnings; proxmox
  SSH path (the v0.9 replacement) does not warn.
- Add --no-deprecation-warnings global flag on root command (PersistentPreRunE)
  for orca upgrade migrations.
- 12 new daemon/cert/node deprecation tests in internal/cli/daemon_test.go
  (cli coverage 81.9%, warnDeprecated 100%).
- Add DEPRECATED banners to v0.8 sections of ARCHITECTURE.md (verified the
  v0.9 supersession section + Supersession Table from prior turn are present).

Bash tooling gate (grill C-06, C-15, C-16, C-17, C-18):
- scripts/tests/test_helper.bash + example_test.bash — bats framework + helpers.
- scripts/lib/orca-log.sh — slog-compatible JSON logging to syslog (C-17).
- scripts/orca-verify-render.sh — render-contract validator skeleton (C-16).
- scripts/tests/orca-log_test.bash + orca-verify-render_test.bash — 20 bats
  tests total (happy + failure paths per C-15).
- .shellcheckrc — project shellcheck config.
- Makefile: test-bash + lint-bash targets (graceful skip if tools missing);
  wired into test + lint targets.
- internal/emit/contract.go + contract_test.go — versioned JSON render
  contract (orca.emit/v1) between Go emitters and bash appliers (C-16).
- .ciagent/BASH_CAPABILITY_MAP_v0.9.md — maps shipped internal/transport
  capabilities to bash-side equivalents or accepted drops (C-18).
- D-186 recorded in PROJECT.md: bash exempt from Go coverage gate; compensating
  control is bats + shellcheck + shfmt (C-06).

verify-reqs: 90 requirements consistent. Build/test/lint/fmt all green.
20 bats tests pass. Go tests pass. No v0.8 code deleted — only marked deprecated
(deletion deferred to v0.10-P14 per REQ-090 dual-write window).

---ci---
project: orca
phase: P00
milestone: v0.9
status: execute
---/ci---
2026-08-05 16:26:26 +00:00

42 lines
1.3 KiB
Bash

#!/usr/bin/env bash
# Common helpers for orca bats tests (C-15). Sourced by every test file.
# See scripts/tests/README.md for the bash testing policy.
# Resolve the scripts/ dir relative to this test file.
# BASH_SOURCE[0] is this helper file (scripts/tests/test_helper.bash).
SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
export SCRIPTS_DIR
# assert_status <expected> <actual> — assert a command's exit status.
assert_status() {
local expected="$1" actual="$2"
[ "$expected" = "$actual" ] || {
echo "expected status $expected, got $actual" >&2
return 1
}
}
# assert_contains <haystack> <needle> — substring assertion.
assert_contains() {
local haystack="$1" needle="$2"
case "$haystack" in
*"$needle"*) return 0 ;;
*) echo "expected [$haystack] to contain [$needle]" >&2; return 1 ;;
esac
}
# assert_not_contains <haystack> <needle> — negative substring assertion.
assert_not_contains() {
local haystack="$1" needle="$2"
case "$haystack" in
*"$needle"*) echo "expected [$haystack] to NOT contain [$needle]" >&2; return 1 ;;
esac
:
}
# assert_json_field <json> <field> — crude JSON field presence check (no jq dep).
# Matches "<field>": present anywhere in the JSON string.
assert_json_field() {
local json="$1" field="$2"
assert_contains "$json" "\"$field\""
}