@waron97/prbot 2.8.0 → 3.0.1

package/README.md

@@ -190,3 +190,82 @@ Reinstalls the latest published version from npm.
 prbot update
 ```
 
+---
+
+## agrippa
+
+Syncs Odoo workflow phase Python code and MFA records between the local filesystem and the RIP API. Tracks changes via checksums and detects conflicts before overwriting.
+
+Credentials are inherited from the global prbot config (`~/.config/prbot/config`). Override per-workspace in `agrippa.yaml`.
+
+### `agrippa init`
+
+Creates `agrippa.yaml` in the current directory. Always writes `pyproject.toml` with the standard ruff builtins. Optionally writes `pyrightconfig.json` and copies type stubs into `typings/`.
+
+```bash
+agrippa init
+```
+
+### `agrippa clone`
+
+Clones all `from_code` phases for a selected workflow, or a single MFA, into the workspace. Writes files to disk and registers them in `agrippa.yaml`.
+
+```bash
+agrippa clone
+agrippa clone --phase
+agrippa clone --mfa
+agrippa clone --phase --id 123 --path my-workflow/
+```
+
+Options:
+
+| Flag            | Description                                              |
+| --------------- | -------------------------------------------------------- |
+| `--phase`       | Clone a phase (select a workflow)                        |
+| `--mfa`         | Clone an MFA record                                      |
+| `--id <id>`     | Skip selection, clone by ID                              |
+| `--path <path>` | Destination path (base dir for phases, file path for MFA)|
+
+### `agrippa pull`
+
+Fetches remote code for all tracked entries and shows what changed. Classifies each as `fast-forward` (safe overwrite) or `conflict` (local edits would be lost). Lets you select which to pull.
+
+After pulling, also checks tracked workflows for newly added `from_code` phases and auto-clones any not yet present locally.
+
+```bash
+agrippa pull
+```
+
+### `agrippa push`
+
+Pushes local file changes back to RIP. Backs up current remote code to `.backup/<timestamp>/` before overwriting. Same conflict detection as pull, with the concern inverted.
+
+```bash
+agrippa push
+```
+
+### `agrippa diff [path]`
+
+Shows a diff between local files and remote code. Optionally filter to a specific file path.
+
+```bash
+agrippa diff
+agrippa diff my-workflow/some-phase.py
+```
+
+### `agrippa init-phase`
+
+Selects a workflow and any phase, then pushes a default code scaffold to that phase on RIP. Sets `set_result_automatically` to `from_code`, generates result variable constants from the phase's allowed results, and creates the corresponding `result.code.configurator` records.
+
+```bash
+agrippa init-phase
+```
+
+### `agrippa repair`
+
+Removes entries from `agrippa.yaml` whose local files no longer exist on disk.
+
+```bash
+agrippa repair
+```
+

package/agrippa_typings/__builtins__.pyi

@@ -0,0 +1,99 @@
+from typing import (
+    Any,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+import logging
+import datetime as _dt
+
+from recordset import Recordset
+from odoo_environment import OdooEnvironment
+from odoo_records import _HelpdeskTicket
+from b2w_entities import Asset, Contract, Order, OrderItem, Task
+
+class Cursor:
+    def execute(self, query: str, params: Any = None) -> None: ...
+    def fetchone(self) -> Optional[Tuple[Any, ...]]: ...
+    def fetchall(self) -> List[Tuple[Any, ...]]: ...
+    def rollback(self) -> None: ...
+    def commit(self) -> None: ...
+
+class Response:
+    status_code: int
+    text: str
+    content: bytes
+    headers: Dict[str, str]
+    ok: bool
+    def json(self) -> Any: ...
+    def raise_for_status(self) -> None: ...
+
+# --- Globals ---
+
+case_id: _HelpdeskTicket
+env: OdooEnvironment
+body: Dict[str, Any]
+args: List[Any]
+model: Recordset
+logger: logging.Logger
+
+# --- Functions ---
+
+def log(
+    message: Any, level: Literal["debug", "info", "warning", "error"] = ...
+) -> None: ...
+def json_dumps(
+    obj: Any,
+    *,
+    indent: Optional[int] = None,
+    sort_keys: bool = False,
+    default: Any = None,
+    ensure_ascii: bool = True,
+) -> str: ...
+def json_loads(s: str) -> Any: ...
+def make_response(
+    status: Tuple[int, int],
+    message: Union[str, Dict[str, Any]],
+) -> Any: ...
+def request(
+    method: str,
+    url: str,
+    *,
+    headers: Optional[Dict[str, str]] = None,
+    data: Optional[Union[str, bytes]] = None,
+    json: Optional[Any] = None,
+    params: Optional[Dict[str, Any]] = None,
+    timeout: Optional[float] = None,
+) -> Response: ...
+
+FirstArg = TypeVar("FirstArg")
+
+def first(recordset: FirstArg) -> FirstArg: ...
+def format_exc() -> str: ...
+
+# --- Exceptions ---
+
+class ValidationError(Exception): ...
+
+# --- Datetime types (injected as the datetime module, not bare classes) ---
+
+class _DatetimeModule:
+    datetime: Type[_dt.datetime]
+    date: Type[_dt.date]
+    time: Type[_dt.time]
+    timezone: Type[_dt.timezone]
+    timedelta: Type[_dt.timedelta]
+    MINYEAR: int
+    MAXYEAR: int
+
+datetime: _DatetimeModule
+date: Type[_dt.date]
+time: Type[_dt.time]
+timezone: Type[_dt.timezone]
+pytz: Any
+dateutil: Any

package/agrippa_typings/b2w_entities.pyi

@@ -0,0 +1,68 @@
+from typing import Any, Dict, List, Optional
+from odoo_environment import OdooEnvironment
+
+
+class Bit2winEntity:
+    env: OdooEnvironment
+    _id: str
+    data: Dict[str, Any]
+
+    def __init__(self, env: OdooEnvironment, _id: str, data: Optional[Dict[str, Any]] = None) -> None: ...
+    def patch(self, new_data: Any, method: str = "PATCH") -> Any: ...
+    def download(self) -> Dict[str, Any]: ...
+
+
+class Asset(Bit2winEntity):
+    def children(self) -> "List[Asset]": ...
+    def order(self) -> "Order": ...
+    def order_item(self) -> "OrderItem": ...
+    def contract(self) -> "Contract": ...
+    def offer_codes(self) -> List[Dict[str, Any]]: ...
+    def offer_code(self, at: Any = None) -> Optional[str]: ...
+    def update_b2w_statemodel(
+        self,
+        destination_state: str,
+        sm_reason: str = "",
+        expected_date: Any = False,
+    ) -> Any: ...
+
+
+class Order(Bit2winEntity):
+    def order_items(self) -> "List[OrderItem]": ...
+    def update_b2w_statemodel(
+        self,
+        destination_state: str,
+        sm_reason: str = "",
+        expected_date: Any = False,
+    ) -> Any: ...
+
+
+class OrderItem(Bit2winEntity):
+    order_id: Optional[str]
+
+    def __init__(
+        self,
+        env: OdooEnvironment,
+        _id: str,
+        order_id: Optional[str] = None,
+        data: Optional[Dict[str, Any]] = None,
+    ) -> None: ...
+    def task_mdp(self) -> "Optional[Task]": ...
+    def update_b2w_statemodel(
+        self,
+        destination_state: str,
+        sm_reason: str = "",
+        expected_date: Any = False,
+    ) -> Any: ...
+
+
+class Contract(Bit2winEntity):
+    def update_b2w_statemodel(
+        self,
+        destination_state: str,
+        sm_reason: str = "",
+        expected_date: Any = False,
+    ) -> Any: ...
+
+
+class Task(Bit2winEntity): ...