Primeiro Commit v0.beta1

tests/README.md

@@ -0,0 +1,30 @@
+# Knowledge One View CLI Tests
+
+This folder keeps the skill tests intentionally small and executable.
+
+The suite covers only two themes:
+
+1. `functions.test.mjs` checks local functions and output contracts.
+2. `sales-prompts.test.mjs` checks whether common sales prompts map to quick, documented CLI commands for Oracle DV.
+
+The tests read `SKILL.md` and `references/*.md` as the source of truth. They should not keep a parallel copy of long parameter lists, aliases, defaults, or week mappings.
+
+Run offline tests:
+
+```sh
+node tests/run.mjs
+```
+
+Run live backend checks:
+
+```sh
+KNOWLEDGE_ONE_VIEW_LIVE=1 \
+ORACLE_SI_RUNTIME_HOME=/path/to/workspace/knowledge-one-view-cli/runtime \
+node tests/run.mjs
+```
+
+Offline mode does not call Oracle DV. Live mode starts with a no-cache session-context read, then runs prompt-sized backend checks. Prompts that should be org-wide commercial reads assert the primary source from `references/api-map.md`, reject fallback to `DV - SE Team`, and use larger live limits when row volume is part of the expected behavior.
+
+Every test invocation of `fetch-sales-intelligence.mjs` is forced through `--no-cache`.
+
+When `ORACLE_SI_RUNTIME_HOME` is set, the tests copy `auth-state.json` and `session-meta.json` into a temporary runtime first, so live checks do not rewrite the source runtime. Set `ORACLE_SI_TEST_RUNTIME_HOME` when you intentionally want to provide a writable test runtime.