designaround 0.1.3__py3-none-any.whl

designaround-0.1.3.dist-info/METADATA

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: designaround
+Version: 0.1.3
+Summary: DesignAround CLI + local engine: design-patent screening, design-around, patent views and filing packages. Works with Claude Code, Codex, Cursor, Gemini CLI, OpenCode, OpenClaw and Kiro via the bundled Skill.
+License: Apache-2.0
+Requires-Python: <3.13,>=3.11
+Requires-Dist: designaround-core
+Requires-Dist: designaround-engine
+Requires-Dist: httpx==0.28.1
+Requires-Dist: keyring==25.7.0
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: rich==15.0.0
+Requires-Dist: typer==0.27.3
+Description-Content-Type: text/markdown
+
+# designaround (CLI + local engine)
+
+```bash
+uv tool install designaround        # or: pipx install designaround
+designaround onboard                # trial key, stored in the OS keychain
+designaround skill install claude-code   # or: cursor, codex, gemini-cli, opencode, openclaw, kiro, all
+designaround config mode host       # inside an agent host; or platform / byok
+```
+
+Commands print one JSON envelope with `--json` (default when stdout is not a terminal). Exit codes: 0 ok, 2 needs a person, 3 budget or plan, 4 auth, 5 invalid input, 6 error.
+
+See the repository README for the full workflow.

designaround-0.1.3.dist-info/RECORD

@@ -0,0 +1,56 @@
+designaround_cli/__init__.py,sha256=XEqb2aiIn8fzGE68Mph4ck1FtQqsR_am0wRWvrYPffQ,22
+designaround_cli/__main__.py,sha256=CnXNTEvTGzcH7oL7CozD_C3vDVuBfMWH6V93GuaEaDQ,29
+designaround_cli/batch.py,sha256=qjTx7PVRxeSgj-4VpJ9pd3lm6HOIH0CWzeRs07dLe0s,7895
+designaround_cli/bundles.py,sha256=TPEgdwiWbakc0C8MpLQEOFiIrktWfvI9ZB7SUie5c9M,4488
+designaround_cli/client.py,sha256=KnDdcnV3Hy9yiC9kLqefJWJb4KqSg7DA-alBpaquq-E,4609
+designaround_cli/config.py,sha256=WqEl4engoARK3kD0OF8aToud5aQYKduX7tZ3fKYVYNI,4821
+designaround_cli/detached.py,sha256=7OU3A6m-8hrEdl32NoLpvvcJ-isHO3tvN6kzyvaSBmI,3166
+designaround_cli/figures.py,sha256=_G7CDRbiRT2KVtEdK78ZmybNOKdxslMZDk0u_4ceZRI,7251
+designaround_cli/guarantee.py,sha256=6onpoOhzbxcgv4XnONODmGUZ5Ii5mXaqINboo_fnQN8,9191
+designaround_cli/main.py,sha256=DvrLxPlngjPJdJIi9PuGz1BU5Yc9-rumBFQd2vtTkNY,122474
+designaround_cli/mcp.py,sha256=5IUtvUf5J8xtxtJ48oZAWoQOm7bmNNpe24IIys6aKcQ,18242
+designaround_cli/monitor.py,sha256=2VImG_a_08cFBb_U71Red62VCr_VCYqYWJEWmUR3ZB8,12112
+designaround_cli/notify.py,sha256=gEpJHSwv6f057Pc017xEc-iFlDqZTXVuR7jQaMsF964,5147
+designaround_cli/output.py,sha256=IOnymgWO7BsRmSYML31EVPk5G_ixalJFYN_DSuumPlU,2884
+designaround_cli/runner.py,sha256=HbqsartVOmLNWKLpde_tVhsXsIjO6zPeIXQliouLJ9Q,21008
+designaround_cli/screening.py,sha256=TiF8SByj7J6N4O9oKlyY2GaERgOhesnGqum4qzWA3BQ,11080
+designaround_cli/share.py,sha256=SXZFB5dQJKS4MGy6d9eB9FubKmlbmSPcS2NOX3u3OEI,9301
+designaround_cli/bundle/skill/SKILL.md,sha256=cH4Hcb5szpuLmmfjlOeqNG3GkIs9nkLVPNSj1Fn0WNY,12140
+designaround_cli/bundle/skill/assets/constraints.template.yaml,sha256=sk7k4wlblCxdW7qUffsOi16fz5rOlv2Na1IO9JKNicU,651
+designaround_cli/bundle/skill/references/cadquery.md,sha256=zEmTuaZdjCQxxCKqXDztgv9EMQ0MOm8mDQcEc_XQmYM,3317
+designaround_cli/bundle/skill/references/constraints.md,sha256=zCerA69YwEy9LSdW97jDVvuCz_NkDW5M33DTN_E61XY,1271
+designaround_cli/bundle/skill/references/jurisdictions.md,sha256=itRue27QtBlkb2BvMV1E8PQd7twYiM3QzNYpJvxRzJA,3778
+designaround_cli/bundle/skill/references/output-format.md,sha256=_zVUKaBzTZH2HKA9ndNE_jlc2Eskf2SLuxnVVcxwCvY,1635
+designaround_cli/bundle/skill/references/safety.md,sha256=he0HB68Jd-vRGvxH88tI2RgiOrmPlcl5qoP45hc8iIM,2046
+designaround_cli/bundle/skill/references/workflow.md,sha256=V9oHD1txVK3hMq-UH1S1eP8szI641I62R38LSdvIU6c,6850
+designaround_cli/bundle/skill/scripts/da.py,sha256=K6AseZlZxAHuNIpjVx0Sh2K843960x3vxJaMyXFr_n0,1919
+designaround_cli/bundle/agents/package-lock.json,sha256=fzXugjLfSgZZT7ldzYORRHOFdHrAL66PO4u-el4hVBc,58236
+designaround_cli/bundle/agents/package.json,sha256=mY8knQ7ZRmnlodxfGnSoSzb7GGopnN25oKqYeH4kq9E,607
+designaround_cli/bundle/agents/src/assistant.ts,sha256=GDoxZjXhcdpnp9VT6D1k35gczimND-oZM_qOk3FibeQ,52476
+designaround_cli/bundle/agents/src/chat-cli.ts,sha256=l3arbRnG79_1EaHfrftqH2FFlGy6yZITKVSYRWmpwZI,5043
+designaround_cli/bundle/agents/src/design.ts,sha256=4cIQXpU-iRGX7dfti3UcXVxgF6mq1FpdsO61oj77rNE,54443
+designaround_cli/bundle/agents/src/engine.ts,sha256=5KSUIRf5icpJ4bJJQ7065Uh0JlFVQjgcE6b7XNRF5a8,2713
+designaround_cli/bundle/agents/src/env.ts,sha256=vIxtmcl2_YdWuevPz4qCIa4MZlEUXSb39_NjlzNU-Ag,933
+designaround_cli/bundle/agents/src/main.ts,sha256=gcrYt-NwezbA-qmt4YtCiYo9Y7wb8o5mDFZLSLw8fa8,5855
+designaround_cli/bundle/agents/src/prompts.ts,sha256=CapanU9UP6mOAfRlGj60jsaaYAHUA8w1qA1ORTYob0k,4382
+designaround_cli/bundle/agents/src/runtime.ts,sha256=10qs15UAcYNt_9g4x5JZI6jo8LUK62SvkDdw-SQU9o8,9362
+designaround_cli/bundle/agents/src/team.ts,sha256=X2AMRng93qeBkCUjdxOCMXPSbdrfHgp-8JpiBU19rSA,16258
+designaround_cli/bundle/agents/src/tools.ts,sha256=oiY5l92bcpzO8FU39lug0tSOpEyM52SBLNGS9CQEBb4,6750
+designaround_cli/bundle/agents/src/ui-server.ts,sha256=8CDCOEy-mTsF-rACZzTX8k-zEUaTbGP0kMSP66sTfjE,34668
+designaround_cli/bundle/agents/ui/app.css,sha256=V4Ctl1l5QcFppMQbBQB6TGb7rhORirhTI2X0SUNnQbw,28388
+designaround_cli/bundle/agents/ui/app.js,sha256=g6GXCoJapg9gW07JyM2NC-lTgY7XobYKLcE_CTXl1kw,56387
+designaround_cli/bundle/agents/ui/favicon.png,sha256=ngnx3M6_QnvqvhZsVA9D6bdhxM0xy-kzrZINVBKrka4,980
+designaround_cli/bundle/agents/ui/i18n.js,sha256=zSCUem3VzMIu5fFS9j_0K8RyDD0gOLREbv40FarUREg,21796
+designaround_cli/bundle/agents/ui/icons.js,sha256=JWei5nsv0Gz8UMBC8CkSIfN2UTYbXSEryLw61FFtKqE,24550
+designaround_cli/bundle/agents/ui/index.html,sha256=VnbfzQiFmhtLO-7HsoQIcwvmD4-du1q4WmL03K1gyJg,10832
+designaround_cli/bundle/agents/ui/mark.svg,sha256=M7m4GPEpRTU7Yu4bC-ni1gxww3XOqQqpa8t0XmX43lI,447
+designaround_cli/bundle/agents/ui/markdown.js,sha256=Fgj9_bXBIGSWpjvJ8F6sGI5nC6zUc8ZnEkJR2kitSKM,2764
+designaround_cli/bundle/agents/ui/art/welcome.jpg,sha256=i0VUvgDcL0Ydy2CUvCtgxMlyTJs04gWWL7ti-nt1njQ,174534
+designaround_cli/bundle/agents/ui/fonts/JETBRAINS-MONO-LICENSE.txt,sha256=QDWBtp2sXP9AeSBeAca0Z-Vq9EnsvXJHaT3bG6r6AFs,4524
+designaround_cli/bundle/agents/ui/fonts/JetBrainsMono.woff2,sha256=GL5FJyS_3CNsB0ypSiSaf0GoZ1LH0EqyWM6e1WUfan4,40404
+designaround_cli/bundle/agents/ui/fonts/MONA-SANS-LICENSE.txt,sha256=QemRFJPeWJmiAza68Ttupkg7Xuo04jfy_-0iw5vcSo0,4564
+designaround_cli/bundle/agents/ui/fonts/MonaSans.woff2,sha256=XqN0BjPlrHr1bBPX6OwyvK4S53I-U9NChEaaiUfMsvM,98124
+designaround-0.1.3.dist-info/METADATA,sha256=1B0uO7_urXrzo7kVBHXaOKSMNDNpwlaJcK-5_AS_2Tg,1181
+designaround-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+designaround-0.1.3.dist-info/entry_points.txt,sha256=roVKAb5qM4RTr-F-D5iH04fY2Q_4rDRkkVnnsK_FIeo,90
+designaround-0.1.3.dist-info/RECORD,,

designaround-0.1.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

designaround-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+da = designaround_cli.main:run
+designaround = designaround_cli.main:run

designaround_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.3"

designaround_cli/__main__.py

@@ -0,0 +1,3 @@
+from .main import run
+
+run()

designaround_cli/batch.py

@@ -0,0 +1,146 @@
+"""Batch screening from a CSV (FR-RISK-06, FR-CASE-08, FR-CLI-07).
+
+Columns (header row, UTF-8; only ``name`` and ``article`` are required):
+
+    name, article, article_zh, jurisdictions ("US;CN"), image (path), cad (STEP/IGES path), case
+
+Each row becomes a case (or reuses ``case``), is screened on the server, and, when a
+3D version exists (``cad`` column or an existing case), ranked locally. Progress is
+kept in ``<csv>.state.json`` next to the CSV, so a second run continues where the
+first stopped and retries only failed rows. The whole run has one credit cap,
+checked against the estimate before anything is charged.
+"""
+
+from __future__ import annotations
+
+import csv
+import hashlib
+import json
+import threading
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from pathlib import Path
+
+from designaround_core import catalog
+from designaround_engine import api
+from designaround_engine.errors import EngineError
+
+from .output import EXIT_BUDGET, EXIT_INVALID, CliExit
+
+MAX_ROWS = 1000
+OFFICES = {"US", "CN", "EU"}
+
+
+def _key(row: dict) -> str:
+    raw = json.dumps({k: (row.get(k) or "").strip() for k in ("name", "article", "image", "cad", "case")}, sort_keys=True, ensure_ascii=False)
+    return hashlib.sha256(raw.encode("utf-8")).hexdigest()[:16]
+
+
+def read_rows(path: Path) -> list[dict]:
+    if not path.exists():
+        raise CliExit(EXIT_INVALID, "not_found", f"CSV not found: {path}")
+    with path.open(encoding="utf-8-sig", newline="") as fh:
+        rows = [{(k or "").strip().lower(): (v or "").strip() for k, v in r.items()} for r in csv.DictReader(fh)]
+    rows = [r for r in rows if any(r.values())]
+    if not rows:
+        raise CliExit(EXIT_INVALID, "empty_csv", "The CSV has no rows.", next_actions=["Header: name,article,article_zh,jurisdictions,image,cad"])
+    if len(rows) > MAX_ROWS:
+        raise CliExit(EXIT_INVALID, "too_many_rows", f"{len(rows)} rows; one batch handles at most {MAX_ROWS}.")
+    bad = [i + 2 for i, r in enumerate(rows) if not (r.get("name") and (r.get("article") or r.get("case")))]
+    if bad:
+        raise CliExit(EXIT_INVALID, "missing_columns", f"Rows {bad[:10]} need name and article (or an existing case id).")
+    for r in rows:
+        r["_key"] = _key(r)
+        r["_offices"] = [o.strip().upper() for o in (r.get("jurisdictions") or "US").replace(",", ";").split(";") if o.strip().upper() in OFFICES] or ["US"]
+        for col in ("image", "cad"):
+            if r.get(col) and not Path(r[col]).expanduser().is_absolute():
+                r[col] = str((path.parent / r[col]).resolve())
+    return rows
+
+
+def estimate(rows: list[dict], deep: bool, done: set[str]) -> int:
+    per = catalog.ACTION_CREDITS["screen.deep.batch" if deep and len(rows) >= 100 else ("screen.deep" if deep else "screen.quick")]
+    return per * sum(1 for r in rows if r["_key"] not in done)
+
+
+def run_batch(csv_path: Path, *, deep: bool, max_credits: int, concurrency: int = 2, fetch: int = 8, figures_per: int = 3, out: Path | None = None) -> dict:
+    from .screening import STATE as SCREEN_STATE
+    from .screening import run_screen
+
+    rows = read_rows(csv_path)
+    state_path = csv_path.with_suffix(csv_path.suffix + ".state.json")
+    state = json.loads(state_path.read_text(encoding="utf-8")) if state_path.exists() else {"rows": {}}
+    done = {k for k, v in state["rows"].items() if v.get("status") == "done"}
+    est = estimate(rows, deep, done)
+    if est > max_credits:
+        raise CliExit(EXIT_BUDGET, "budget_exceeded", f"Estimated {est} credits for {len(rows) - len(done)} rows exceeds --max-credits {max_credits}.", data={"estimate": est, "rows": len(rows), "done": len(done)}, next_actions=[f"Re-run with --max-credits {est}", "Use quick screening (drop --deep) for a first pass"])
+    lock = threading.Lock()
+    SCREEN_STATE["quiet"] = True
+
+    def save() -> None:
+        tmp = state_path.with_suffix(".tmp")
+        tmp.write_text(json.dumps(state, indent=2, ensure_ascii=False), encoding="utf-8")
+        tmp.replace(state_path)
+
+    def one(row: dict) -> dict:
+        record = {"name": row["name"], "status": "running", "started": time.time(), "error": None}
+        try:
+            case_id = row.get("case") or (state["rows"].get(row["_key"]) or {}).get("case")
+            if not case_id:
+                case_id = api.case_create(row["name"], article=row.get("article") or None, article_zh=row.get("article_zh") or None, jurisdictions=row["_offices"])["id"]
+                api.case_update(case_id, status="batch")
+            record["case"] = case_id
+            with lock:
+                state["rows"][row["_key"]] = {**(state["rows"].get(row["_key"]) or {}), **record}
+                save()
+            if row.get("cad") and not api.case_show(case_id).get("original"):
+                api.import_model_file(case_id, row["cad"])
+            image = Path(row["image"]).expanduser() if row.get("image") else None
+            if image is not None and not image.exists():
+                raise CliExit(EXIT_INVALID, "not_found", f"Image not found: {image}")
+            data = run_screen(case_id, image=image, query=None, deep=deep, jurisdictions=row["_offices"], fetch=fetch, figures_per=figures_per, version=None, hires=2 if deep else 0)
+            ranked = data.get("ranked") or []
+            record.update({
+                "status": "done",
+                "candidates": data.get("candidates", 0),
+                "prior_art_added": len(data.get("added") or []),
+                "top": [{"number": r.get("number"), "shape": round((r.get("shape") or {}).get("score", r.get("shape_score", 0)) or 0, 3)} for r in ranked[:3]],
+                "version": data.get("version"),
+                "charged": data.get("charged", 0),
+                "source_failures": len(data.get("source_failures") or []),
+            })
+        except CliExit as exc:
+            record.update({"status": "failed", "error": f"{exc.kind}: {exc.message}"[:300]})
+            if exc.code == EXIT_BUDGET:
+                record["budget"] = True
+        except EngineError as exc:
+            record.update({"status": "failed", "error": f"{exc.code}: {exc}"[:300]})
+        except Exception as exc:  # noqa: BLE001 - one bad row must not stop the batch
+            record.update({"status": "failed", "error": f"{type(exc).__name__}: {exc}"[:300]})
+        record["finished"] = time.time()
+        with lock:
+            state["rows"][row["_key"]] = {**(state["rows"].get(row["_key"]) or {}), **record}
+            save()
+        return record
+
+    todo = [r for r in rows if r["_key"] not in done]
+    spent = 0
+    stopped = False
+    with ThreadPoolExecutor(max_workers=max(1, min(concurrency, 6))) as pool:
+        futures = {pool.submit(one, r): r for r in todo}
+        for future in as_completed(futures):
+            rec = future.result()
+            spent += int(rec.get("charged") or 0)
+            if rec.get("budget"):
+                stopped = True
+    results = []
+    for r in rows:
+        rec = state["rows"].get(r["_key"]) or {"status": "pending"}
+        results.append({"name": r["name"], "case": rec.get("case"), "status": rec.get("status"), "candidates": rec.get("candidates"), "top": "; ".join(f"{t['number']} ({t['shape']})" for t in rec.get("top") or []), "error": rec.get("error")})
+    target = out or csv_path.with_name(csv_path.stem + "-results.csv")
+    with target.open("w", encoding="utf-8-sig", newline="") as fh:
+        writer = csv.DictWriter(fh, fieldnames=["name", "case", "status", "candidates", "top", "error"])
+        writer.writeheader()
+        writer.writerows(results)
+    counts = {s: sum(1 for x in results if x["status"] == s) for s in ("done", "failed", "pending")}
+    return {"rows": len(rows), "counts": counts, "estimate": est, "charged_this_run": spent, "stopped_on_budget": stopped, "results_csv": str(target), "state": str(state_path), "results": results}