ordel-cli 0.1.0__py3-none-any.whl

ordel_cli/__init__.py

@@ -0,0 +1,8 @@
+"""Ordel free CLI — local QA-automation shell over the deterministic engine."""
+
+from __future__ import annotations
+
+from ordel_cli.heal_service import CircuitOpenError, HealService
+from ordel_cli.store import OrdelStore
+
+__all__ = ["OrdelStore", "HealService", "CircuitOpenError"]

ordel_cli/branding.py

@@ -0,0 +1,26 @@
+"""Ordel attribution — the ◉◯ two-circle mark on key MCP responses.
+
+When a coding agent relays Ordel's output, Ordel's work can get shadowed by the agent's
+own voice. A small, consistent signature on the KEY tool responses (coverage, scenarios,
+risk/plan/regression, explore, record, pom) keeps the attribution visible without being
+noisy — one line appended to the ascii, and a `signature` field on the payload.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+SIGNATURE = "◉◯ ordel"
+_FOOTER = "\n              " + SIGNATURE
+
+
+def sign(result: dict[str, Any]) -> dict[str, Any]:
+    """Attach Ordel's signature to a tool result (idempotent): a `signature` field, and a
+    footer line on the `ascii` output when present. Mutates and returns the same dict."""
+    if not isinstance(result, dict):
+        return result
+    result.setdefault("signature", SIGNATURE)
+    ascii_out = result.get("ascii")
+    if isinstance(ascii_out, str) and SIGNATURE not in ascii_out:
+        result["ascii"] = ascii_out + _FOOTER
+    return result

ordel_cli/capture.cjs

@@ -0,0 +1,46 @@
+/**
+ * Ordel free-CLI page capture (one-shot).
+ *
+ * Navigates to a URL with the PROJECT's own Playwright (path passed via
+ * ORDEL_PW_PATH so require() resolves against the dev's node_modules, exactly
+ * like run_test uses the project's `npx playwright`) and extracts signals for
+ * the page's meaningful elements via the shared extractor. Emits a JSON document:
+ *   { "url", "title", "elements": [ { "key", signals... }, ... ] }
+ * The Python side turns each element's signals into an ElementFingerprint. No LLM.
+ *
+ * This is the single-shot path (open→goto→capture→close). The persistent
+ * agent-driven path lives in session_driver.cjs and shares the same extractor.
+ *
+ * Usage: ORDEL_PW_PATH=/abs/@playwright/test node capture.cjs <url>
+ */
+'use strict';
+
+const path = require('path');
+const { extract } = require('./capture_extract.cjs');
+
+const url = process.argv[2];
+const pwPath = process.env.ORDEL_PW_PATH;
+if (!url || !pwPath) {
+  console.error('usage: ORDEL_PW_PATH=<@playwright/test> node capture.cjs <url>');
+  process.exit(2);
+}
+
+(async () => {
+  // absolute so Node treats it as a path, not a node_modules package lookup
+  // eslint-disable-next-line
+  const { chromium } = require(path.resolve(pwPath));
+  const browser = await chromium.launch({ headless: process.env.ORDEL_HEADED !== '1' });
+  try {
+    const page = await browser.newPage();
+    const resp = await page.goto(url, { waitUntil: 'networkidle', timeout: 30000 });
+    const httpStatus = resp ? resp.status() : 0;
+    const title = await page.title();
+    const elements = await page.evaluate(extract);
+    process.stdout.write(JSON.stringify({ url: page.url(), title, elements, httpStatus }));
+  } finally {
+    await browser.close();
+  }
+})().catch((e) => {
+  console.error(String((e && e.stack) || e));
+  process.exit(1);
+});

ordel_cli/capture_extract.cjs

@@ -0,0 +1,119 @@
+/**
+ * Shared in-browser DOM extractor for Ordel capture.
+ *
+ * Used by BOTH the one-shot `capture.cjs` and the persistent `session_driver.cjs`, so
+ * the fingerprint signals are identical whichever path captured them. `extract` is
+ * self-contained: it runs inside the page via `page.evaluate(extract)` and references
+ * only browser globals (document, getComputedStyle, CSS), never Node scope.
+ */
+'use strict';
+
+function extract() {
+  const canon = (s) => (s || '').replace(/\s+/g, ' ').trim().toLowerCase();
+  const IMPLICIT_ROLE = {
+    A: 'link', BUTTON: 'button', INPUT: 'textbox', SELECT: 'combobox',
+    TEXTAREA: 'textbox', H1: 'heading', H2: 'heading', H3: 'heading',
+    H4: 'heading', H5: 'heading', H6: 'heading', IMG: 'img', LABEL: 'label',
+  };
+  const roleOf = (el) => {
+    const explicit = el.getAttribute('role');
+    if (explicit) return explicit;
+    if (el.tagName === 'INPUT') {
+      const t = (el.getAttribute('type') || 'text').toLowerCase();
+      if (t === 'checkbox') return 'checkbox';
+      if (t === 'radio') return 'radio';
+      if (t === 'button' || t === 'submit') return 'button';
+      return 'textbox';
+    }
+    return IMPLICIT_ROLE[el.tagName] || '';
+  };
+  const directText = (el) => {
+    let t = '';
+    for (const n of el.childNodes) if (n.nodeType === 3) t += n.textContent;
+    return t;
+  };
+  const accessibleName = (el) => {
+    const aria = el.getAttribute('aria-label');
+    if (aria) return aria;
+    const lb = el.getAttribute('aria-labelledby');
+    if (lb) {
+      const parts = lb.split(/\s+/).map((id) => {
+        const r = document.getElementById(id);
+        return r ? r.textContent : '';
+      });
+      const j = parts.join(' ').trim();
+      if (j) return j;
+    }
+    if (el.id) {
+      const lab = document.querySelector(`label[for="${CSS.escape(el.id)}"]`);
+      if (lab && lab.textContent.trim()) return lab.textContent;
+    }
+    const wrap = el.closest('label');
+    if (wrap && wrap.textContent.trim()) return wrap.textContent;
+    const txt = (el.textContent || '').trim();
+    if (txt) return txt;
+    return el.getAttribute('placeholder') || el.getAttribute('alt')
+      || el.getAttribute('title') || '';
+  };
+  const visible = (el) => {
+    const r = el.getBoundingClientRect();
+    if (r.width === 0 && r.height === 0) return false;
+    const s = getComputedStyle(el);
+    return s.visibility !== 'hidden' && s.display !== 'none';
+  };
+
+  const INTERACTIVE = 'a,button,input,select,textarea,[role],[data-testid],label,iframe,h1,h2,h3,h4,h5,h6';
+  const FORM_CONTROL = { INPUT: 1, SELECT: 1, TEXTAREA: 1 };
+  const seen = new Set();
+  const picked = [];
+  // 1) interactive + landmark elements. Form controls are captured even when hidden —
+  //    hidden inputs carry FORM STATE (continuation/csrf/state tokens, ids).
+  for (const el of document.querySelectorAll(INTERACTIVE)) {
+    if (!FORM_CONTROL[el.tagName] && !visible(el)) continue;
+    seen.add(el);
+    picked.push(el);
+  }
+  // 2) value-like leaves: short direct text, no element children carrying text.
+  for (const el of document.querySelectorAll('span,div,dd,td,p,strong,b,em,small')) {
+    if (seen.has(el)) continue;
+    const dt = directText(el).trim();
+    if (!dt || dt.length > 60) continue;
+    if (!visible(el)) continue;
+    picked.push(el);
+  }
+
+  const usedKeys = Object.create(null);
+  const out = [];
+  picked.forEach((el, idx) => {
+    const role = roleOf(el);
+    const name = accessibleName(el).trim();
+    const testid = el.getAttribute('data-testid') || '';
+    const r = el.getBoundingClientRect();
+    const classTokens = (el.getAttribute('class') || '').split(/\s+/).filter(Boolean);
+    const slug = (s) => s.replace(/[^a-z0-9]+/gi, '-').replace(/^-+|-+$/g, '').slice(0, 40);
+    let key = testid || (name ? `${role || el.tagName.toLowerCase()}:${slug(name)}`
+      : `${el.tagName.toLowerCase()}:${idx}`);
+    if (usedKeys[key]) key = `${key}#${usedKeys[key]++}`; else usedKeys[key] = 1;
+    out.push({
+      key,
+      tag_canon: canon(el.tagName),
+      role_canon: canon(role),
+      accessibleName_canon: canon(name),
+      testid_canon: canon(testid),
+      nameAttr_canon: canon(el.getAttribute('name') || ''),
+      id_canon: canon(el.id || ''),
+      id: el.id || '',
+      text: (el.textContent || '').trim().slice(0, 200),
+      classTokens,
+      href: el.getAttribute('href') || '',
+      type: el.getAttribute('type') || '',
+      placeholder: el.getAttribute('placeholder') || '',
+      title: el.getAttribute('title') || '',
+      alt: el.getAttribute('alt') || '',
+      boundingBox: [Math.round(r.x), Math.round(r.y), Math.round(r.width), Math.round(r.height)],
+    });
+  });
+  return out;
+}
+
+module.exports = { extract };