Viindoo AI - Pulse Cost Gate (WI-F, Phase 3.9 Cognitive, ADR-007 / ADR-009)
A no-LLM cost gate that sits BETWEEN a work routine's target scan and the LLM
agent run. Every scheduled viin.ai.work.routine run today spends LLM cost
even when nothing actionable changed; the Pulse gate evaluates cheap rules
(an ORM domain pre-check + a sandboxed boolean threshold) on the
already-scanned records and SKIPS the run when no real signal is present -
recording every decision in an append-only signal ledger.
Key models
- AI Pulse Rule (viin.ai.pulse.rule) - a cheap PASS/SKIP rule attached
to a work routine. domain is an ORM pre-check evaluated against the
scanned records (never a re-query); threshold_python is a boolean
expression evaluated under a SANDBOXED safe_eval (__import__ /
__builtins__ escape blocked). Cooldown dedupe prevents re-firing within
cooldown_seconds.
- AI Signal (viin.ai.signal) - the append-only ledger of every gate
decision (pass / skip / escalate) with a deduplication fingerprint and a TTL.
What it unblocks (governance)
execution_mode='scheduled' on a viin.ai.agent is hard-blocked until a
Pulse governance trail exists: this module unblocks scheduled IFF the
agent's work routine carries at least one Pulse rule.
Standalone by design
Pulse does NOT inherit base.automation (zero ripple into its downstream
modules); it only reuses the odoo.tools.safe_eval idiom already used by the
work-routine scanner.
Supported Editions
- Community Edition
- Enterprise Edition
This software and associated files (the "Software") may only be
used
(executed, modified, executed after modifications) if you have
purchased a
valid license from the authors, typically via Odoo Apps,
or if you
have
received a written agreement from the authors of the
Software (see the
COPYRIGHT file).
You may develop Odoo modules that use the Software as a library
(typically
by depending on it, importing it and using its
resources), but
without
copying any source code or material from the
Software. You may distribute
those modules under the license of your
choice, provided that this
license
is compatible with the terms of
the Odoo Proprietary License (For
example:
LGPL, MIT, or proprietary
licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell
copies of the
Software or modified copies of the Software.
The above copyright notice and this permission notice must be
included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT
SHALL THE
AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING
FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE
SOFTWARE.
