traceforge-pcb 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. traceforge/__init__.py +3 -0
  2. traceforge/__main__.py +3 -0
  3. traceforge/acp_server.py +570 -0
  4. traceforge/agent.py +680 -0
  5. traceforge/altium/__init__.py +6 -0
  6. traceforge/altium/cfb.py +70 -0
  7. traceforge/altium/cli.py +60 -0
  8. traceforge/altium/model.py +163 -0
  9. traceforge/altium/outputs.py +24 -0
  10. traceforge/altium/pcb.py +301 -0
  11. traceforge/altium/project.py +328 -0
  12. traceforge/altium/schematic.py +400 -0
  13. traceforge/altium/tools.py +166 -0
  14. traceforge/approval.py +219 -0
  15. traceforge/attachments.py +346 -0
  16. traceforge/background.py +253 -0
  17. traceforge/bench/__init__.py +5 -0
  18. traceforge/bench/adapters.py +337 -0
  19. traceforge/bench/checks.py +410 -0
  20. traceforge/bench/cli.py +121 -0
  21. traceforge/bench/design.py +439 -0
  22. traceforge/bench/kicad.py +99 -0
  23. traceforge/bench/partscheck.py +159 -0
  24. traceforge/bench/review.py +100 -0
  25. traceforge/bench/runner.py +226 -0
  26. traceforge/bench/score.py +204 -0
  27. traceforge/bench/tasks.py +102 -0
  28. traceforge/chat.py +1185 -0
  29. traceforge/checks.py +328 -0
  30. traceforge/checks_sides.py +118 -0
  31. traceforge/cli.py +2224 -0
  32. traceforge/clipboard.py +107 -0
  33. traceforge/config.py +299 -0
  34. traceforge/context.py +276 -0
  35. traceforge/design/__init__.py +1 -0
  36. traceforge/design/constraints.py +397 -0
  37. traceforge/design/generate.py +1789 -0
  38. traceforge/design/outline.py +905 -0
  39. traceforge/design/schematic_layout.py +932 -0
  40. traceforge/design/schematic_lint.py +329 -0
  41. traceforge/design/schematic_route.py +207 -0
  42. traceforge/design/sheets.py +854 -0
  43. traceforge/design/sides.py +328 -0
  44. traceforge/design/spec.py +462 -0
  45. traceforge/design/specsheet.py +2351 -0
  46. traceforge/design/specsheet_render.py +183 -0
  47. traceforge/desktop/__init__.py +109 -0
  48. traceforge/desktop/keys.py +90 -0
  49. traceforge/desktop/project.py +443 -0
  50. traceforge/desktop/review.py +20 -0
  51. traceforge/desktop/server.py +1277 -0
  52. traceforge/desktop/static/app.css +223 -0
  53. traceforge/desktop/static/app.js +683 -0
  54. traceforge/desktop/static/highlight.js +77 -0
  55. traceforge/desktop/static/index.html +89 -0
  56. traceforge/desktop/static/md.js +90 -0
  57. traceforge/desktop/static/viewer.js +213 -0
  58. traceforge/desktop/symbols.py +212 -0
  59. traceforge/desktop/update.py +65 -0
  60. traceforge/diagnostics.py +67 -0
  61. traceforge/errata.py +219 -0
  62. traceforge/fab.py +108 -0
  63. traceforge/fab_layers.py +44 -0
  64. traceforge/features/__init__.py +6 -0
  65. traceforge/features/candidates.py +117 -0
  66. traceforge/features/cli.py +200 -0
  67. traceforge/features/package.py +433 -0
  68. traceforge/features/revdiff.py +224 -0
  69. traceforge/features/sarif.py +145 -0
  70. traceforge/features/viewer.py +265 -0
  71. traceforge/firmware/__init__.py +3 -0
  72. traceforge/firmware/cli.py +174 -0
  73. traceforge/firmware/drivers.py +372 -0
  74. traceforge/firmware/drivers_data.py +256 -0
  75. traceforge/firmware/mcus.py +177 -0
  76. traceforge/firmware/netlist.py +55 -0
  77. traceforge/firmware/pinmap.py +296 -0
  78. traceforge/firmware/scaffold.py +466 -0
  79. traceforge/firmware/toolchain.py +262 -0
  80. traceforge/hooks.py +237 -0
  81. traceforge/kicad/__init__.py +0 -0
  82. traceforge/kicad/cli.py +519 -0
  83. traceforge/kicad/diffpair.py +174 -0
  84. traceforge/kicad/edgegeom.py +191 -0
  85. traceforge/kicad/edit.py +405 -0
  86. traceforge/kicad/escape.py +1410 -0
  87. traceforge/kicad/formats.py +1073 -0
  88. traceforge/kicad/impedance.py +320 -0
  89. traceforge/kicad/install.py +75 -0
  90. traceforge/kicad/libraries.py +490 -0
  91. traceforge/kicad/models3d.py +942 -0
  92. traceforge/kicad/outputs.py +81 -0
  93. traceforge/kicad/pcb.py +787 -0
  94. traceforge/kicad/planes.py +1242 -0
  95. traceforge/kicad/project.py +136 -0
  96. traceforge/kicad/route.py +2698 -0
  97. traceforge/kicad/routegeom.py +164 -0
  98. traceforge/kicad/schematic.py +268 -0
  99. traceforge/kicad/sides.py +34 -0
  100. traceforge/kicad/stackup.py +424 -0
  101. traceforge/kicad_plugin/__init__.py +12 -0
  102. traceforge/kicad_plugin/actions.py +92 -0
  103. traceforge/kicad_plugin/cli.py +66 -0
  104. traceforge/kicad_plugin/client.py +86 -0
  105. traceforge/kicad_plugin/context.py +257 -0
  106. traceforge/kicad_plugin/discovery.py +81 -0
  107. traceforge/kicad_plugin/install.py +203 -0
  108. traceforge/kicad_plugin/overlay.py +60 -0
  109. traceforge/kicad_plugin/payload/action_plugin.py +65 -0
  110. traceforge/kicad_plugin/payload/ipc_main.py +42 -0
  111. traceforge/kicad_plugin/payload/plugin.json +90 -0
  112. traceforge/kicad_plugin/payload/requirements.txt +1 -0
  113. traceforge/kicad_plugin/views.py +202 -0
  114. traceforge/langchain.py +57 -0
  115. traceforge/local.py +580 -0
  116. traceforge/mcp_server.py +304 -0
  117. traceforge/models.py +310 -0
  118. traceforge/next_steps.py +110 -0
  119. traceforge/parts/__init__.py +52 -0
  120. traceforge/parts/alternates.py +488 -0
  121. traceforge/parts/bom.py +423 -0
  122. traceforge/parts/brief.py +705 -0
  123. traceforge/parts/catalog.py +297 -0
  124. traceforge/parts/cli_sourcing.py +156 -0
  125. traceforge/parts/data/duty_rates.yaml +37 -0
  126. traceforge/parts/data/hs_codes.yaml +103 -0
  127. traceforge/parts/datasheet.py +278 -0
  128. traceforge/parts/fx.py +100 -0
  129. traceforge/parts/model.py +185 -0
  130. traceforge/parts/net.py +187 -0
  131. traceforge/parts/offers.py +46 -0
  132. traceforge/parts/packages.py +397 -0
  133. traceforge/parts/pinout.py +714 -0
  134. traceforge/parts/providers/__init__.py +17 -0
  135. traceforge/parts/providers/base.py +100 -0
  136. traceforge/parts/providers/jlc.py +364 -0
  137. traceforge/parts/providers/keyed.py +661 -0
  138. traceforge/parts/report.py +508 -0
  139. traceforge/parts/supply.py +330 -0
  140. traceforge/parts/verify.py +455 -0
  141. traceforge/parts/web.py +575 -0
  142. traceforge/plans.py +70 -0
  143. traceforge/preferences.py +127 -0
  144. traceforge/prices.py +130 -0
  145. traceforge/prices.yaml +28 -0
  146. traceforge/prompts/__init__.py +54 -0
  147. traceforge/prompts/system.md +103 -0
  148. traceforge/providers.py +764 -0
  149. traceforge/remote/__init__.py +33 -0
  150. traceforge/remote/client.py +422 -0
  151. traceforge/remote/oidc.py +240 -0
  152. traceforge/remote/orgs.py +510 -0
  153. traceforge/remote/server.py +690 -0
  154. traceforge/remote/store.py +100 -0
  155. traceforge/review_changes.py +187 -0
  156. traceforge/routing.py +99 -0
  157. traceforge/runtime.py +435 -0
  158. traceforge/sessions.py +324 -0
  159. traceforge/sexpr.py +279 -0
  160. traceforge/sim/__init__.py +17 -0
  161. traceforge/sim/acmath.py +234 -0
  162. traceforge/sim/circuit.py +499 -0
  163. traceforge/sim/cli.py +162 -0
  164. traceforge/sim/engine.py +172 -0
  165. traceforge/sim/ltspice.py +175 -0
  166. traceforge/sim/measure.py +123 -0
  167. traceforge/sim/models.py +76 -0
  168. traceforge/sim/project.py +218 -0
  169. traceforge/sim/rawfile.py +123 -0
  170. traceforge/sim/results.py +298 -0
  171. traceforge/sim/tune.py +172 -0
  172. traceforge/skill_commands.py +165 -0
  173. traceforge/skill_library/circuit-simulation/SKILL.md +30 -0
  174. traceforge/skill_library/compliance-review/SKILL.md +51 -0
  175. traceforge/skill_library/design-review/SKILL.md +47 -0
  176. traceforge/skill_library/errata-hunt/SKILL.md +30 -0
  177. traceforge/skill_library/firmware/SKILL.md +26 -0
  178. traceforge/skill_library/power-budget/SKILL.md +27 -0
  179. traceforge/skill_library/release-package/SKILL.md +29 -0
  180. traceforge/skill_library/sourcing-brief/SKILL.md +24 -0
  181. traceforge/skill_library/thermal-review/SKILL.md +15 -0
  182. traceforge/skills.py +131 -0
  183. traceforge/thermal.py +557 -0
  184. traceforge/tools/__init__.py +48 -0
  185. traceforge/tools/agent_tools.py +213 -0
  186. traceforge/tools/base.py +303 -0
  187. traceforge/tools/batch.py +155 -0
  188. traceforge/tools/connections.py +245 -0
  189. traceforge/tools/files.py +777 -0
  190. traceforge/tools/firmware_tools.py +218 -0
  191. traceforge/tools/kicad_tools.py +1072 -0
  192. traceforge/tools/models3d_tools.py +141 -0
  193. traceforge/tools/parts_tools.py +473 -0
  194. traceforge/tools/processes.py +246 -0
  195. traceforge/tools/review_tools.py +178 -0
  196. traceforge/tools/sim_tools.py +230 -0
  197. traceforge/tui.py +620 -0
  198. traceforge/updates.py +124 -0
  199. traceforge/validate/__init__.py +77 -0
  200. traceforge/validate/builtins.py +1091 -0
  201. traceforge/validate/circuits.py +1240 -0
  202. traceforge/validate/config.py +410 -0
  203. traceforge/validate/default.yaml +113 -0
  204. traceforge/validate/design.py +191 -0
  205. traceforge/validate/explain.py +112 -0
  206. traceforge/validate/grounding.py +169 -0
  207. traceforge/validate/ipc2221.py +350 -0
  208. traceforge/validate/multilayer.py +805 -0
  209. traceforge/validate/netmodel.py +261 -0
  210. traceforge/validate/partcheck.py +472 -0
  211. traceforge/validate/report.py +280 -0
  212. traceforge/validate/review.py +322 -0
  213. traceforge/validate/runner.py +662 -0
  214. traceforge/workspace.py +171 -0
  215. traceforge_pcb-1.0.0.dist-info/METADATA +463 -0
  216. traceforge_pcb-1.0.0.dist-info/RECORD +219 -0
  217. traceforge_pcb-1.0.0.dist-info/WHEEL +4 -0
  218. traceforge_pcb-1.0.0.dist-info/entry_points.txt +2 -0
  219. traceforge_pcb-1.0.0.dist-info/licenses/LICENSE +21 -0
traceforge/updates.py ADDED
@@ -0,0 +1,124 @@
1
+ """Checks whether a newer traceforge release exists.
2
+
3
+ Interactive sessions check at most once a day, in the background, and only print a
4
+ one-line notice. ``traceforge update`` checks now and prints the upgrade command.
5
+ The check reads the public GitHub releases API (or ``TRACEFORGE_UPDATE_URL``, which
6
+ may point at PyPI's JSON API or any URL returning ``{"tag_name": ...}`` or
7
+ ``{"info": {"version": ...}}``). Turn it off with ``check_updates: false`` in the
8
+ config or ``TRACEFORGE_NO_UPDATE_CHECK=1``.
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ import json
14
+ import os
15
+ import re
16
+ import sys
17
+ import time
18
+ import urllib.request
19
+ from dataclasses import dataclass
20
+ from typing import Any
21
+
22
+ from traceforge import __version__
23
+
24
+ RELEASES_URL = "https://api.github.com/repos/ashutosh-rath02/traceforge/releases/latest"
25
+ INSTALL_SOURCE = "git+https://github.com/ashutosh-rath02/traceforge"
26
+ CHECK_INTERVAL = 24 * 3600
27
+
28
+
29
+ @dataclass(frozen=True)
30
+ class UpdateInfo:
31
+ current: str
32
+ latest: str
33
+ available: bool
34
+ command: str
35
+ notes_url: str = ""
36
+
37
+
38
+ def parse_version(value: str) -> tuple[int, ...]:
39
+ """'v1.2.3', '1.2.3rc1' -> (1, 2, 3). Non-numeric parts are ignored."""
40
+ numbers = re.findall(r"\d+", value.split("+")[0])[:4]
41
+ return tuple(int(n) for n in numbers) or (0,)
42
+
43
+
44
+ def install_command(version: str | None = None) -> str:
45
+ ref = f"@v{version}" if version else ""
46
+ return f'{sys.executable} -m pip install --upgrade "traceforge @ {INSTALL_SOURCE}{ref}"'
47
+
48
+
49
+ def _latest_from_payload(payload: Any) -> tuple[str, str]:
50
+ if isinstance(payload, dict):
51
+ if isinstance(payload.get("tag_name"), str):
52
+ return payload["tag_name"].lstrip("v"), str(payload.get("html_url") or "")
53
+ info = payload.get("info")
54
+ if isinstance(info, dict) and isinstance(info.get("version"), str):
55
+ return info["version"], str(info.get("release_url") or "")
56
+ raise ValueError("the update endpoint returned no version")
57
+
58
+
59
+ def fetch_latest(url: str | None = None, timeout: float = 5.0) -> tuple[str, str]:
60
+ request = urllib.request.Request(
61
+ url or os.environ.get("TRACEFORGE_UPDATE_URL") or RELEASES_URL,
62
+ headers={
63
+ "User-Agent": f"traceforge/{__version__} update-check",
64
+ "Accept": "application/json",
65
+ },
66
+ )
67
+ with urllib.request.urlopen(request, timeout=timeout) as response: # noqa: S310 - fixed https URL
68
+ return _latest_from_payload(json.loads(response.read().decode("utf-8")))
69
+
70
+
71
+ class NoReleaseError(RuntimeError):
72
+ """The update endpoint answered 404: no release has been published there yet."""
73
+
74
+
75
+ def check(fetch=fetch_latest, current: str = __version__) -> UpdateInfo:
76
+ import urllib.error
77
+
78
+ try:
79
+ latest, notes = fetch()
80
+ except urllib.error.HTTPError as exc:
81
+ if exc.code == 404:
82
+ raise NoReleaseError("no release has been published yet") from exc
83
+ raise
84
+ from traceforge.preferences import update_preferences
85
+
86
+ update_preferences(update_check={"at": time.time(), "latest": latest})
87
+ return UpdateInfo(
88
+ current,
89
+ latest,
90
+ parse_version(latest) > parse_version(current),
91
+ install_command(latest),
92
+ notes,
93
+ )
94
+
95
+
96
+ def cached_notice(current: str = __version__) -> str | None:
97
+ """A notice from the last check, without touching the network."""
98
+ from traceforge.preferences import get
99
+
100
+ last = get("update_check") or {}
101
+ latest = last.get("latest") if isinstance(last, dict) else None
102
+ if isinstance(latest, str) and parse_version(latest) > parse_version(current):
103
+ return f"traceforge {latest} is available (you have {current}): run `traceforge update`"
104
+ return None
105
+
106
+
107
+ def due(now: float | None = None) -> bool:
108
+ from traceforge.preferences import get
109
+
110
+ last = get("update_check") or {}
111
+ at = last.get("at") if isinstance(last, dict) else None
112
+ return not isinstance(at, (int, float)) or (now or time.time()) - at > CHECK_INTERVAL
113
+
114
+
115
+ def background_notice(enabled: bool = True, fetch=fetch_latest) -> str | None:
116
+ """Check if a check is due (swallowing every error) and return a notice, if any."""
117
+ if not enabled or os.environ.get("TRACEFORGE_NO_UPDATE_CHECK"):
118
+ return None
119
+ if due():
120
+ try:
121
+ check(fetch)
122
+ except Exception: # noqa: BLE001 - offline, rate limited: stay quiet
123
+ return None
124
+ return cached_notice()
@@ -0,0 +1,77 @@
1
+ """`traceforge validate`: staged pre-fabrication review.
2
+
3
+ The graph (``default.yaml``, layered with ``.traceforge/validate.yaml`` and
4
+ ``--config``) has nine stages. Deterministic checks (KiCad ERC/DRC, fab limits,
5
+ parity, circuit and part rules, portability, BOM/CPL) run first in each stage;
6
+ review checks run a read-only agent per concern, optionally fanned out per part,
7
+ sheet or net class and repeated for consensus, and must return evidence-backed
8
+ findings as JSON. Results are cached by the hash of the files each check reads.
9
+ Outputs: Markdown, JSON, JUnit XML, next actions and a fix prompt for the agent.
10
+ """
11
+
12
+ from __future__ import annotations
13
+
14
+ from pathlib import Path
15
+ from typing import Any
16
+
17
+ from traceforge.config import Settings
18
+ from traceforge.validate.config import (
19
+ CheckSpec,
20
+ ConfigError,
21
+ ValidationConfig,
22
+ load_config,
23
+ )
24
+ from traceforge.validate.report import fix_prompt, junit, next_actions, write_report
25
+ from traceforge.validate.review import REVIEW_FORMAT, parse_review
26
+ from traceforge.validate.runner import (
27
+ CheckResult,
28
+ Runner,
29
+ RunOptions,
30
+ ValidationReport,
31
+ )
32
+
33
+ __all__ = [
34
+ "REVIEW_FORMAT",
35
+ "CheckResult",
36
+ "CheckSpec",
37
+ "ConfigError",
38
+ "RunOptions",
39
+ "Runner",
40
+ "ValidationConfig",
41
+ "ValidationReport",
42
+ "fix_prompt",
43
+ "junit",
44
+ "load_config",
45
+ "next_actions",
46
+ "parse_review",
47
+ "validate",
48
+ "write_report",
49
+ ]
50
+
51
+
52
+ async def validate(
53
+ workspace: Path,
54
+ settings: Settings,
55
+ *,
56
+ profile: str | None = None,
57
+ only: list[str] | None = None,
58
+ skip_reviews: bool = False,
59
+ concurrency: int = 4,
60
+ client: Any = None,
61
+ progress: Any = None,
62
+ **options: Any,
63
+ ) -> tuple[ValidationReport, ValidationConfig]:
64
+ """Run the graph over ``workspace``; extra keyword arguments are :class:`RunOptions` fields
65
+ (``gate``, ``until``, ``skip``, ``no_cache``, ``repeat``, ``effort``, ``context_files``,
66
+ ``config_path``, ``part_lookup``, ``on_event``)."""
67
+ run_options = RunOptions(
68
+ profile=profile,
69
+ only=list(only or []),
70
+ skip_reviews=skip_reviews,
71
+ concurrency=concurrency,
72
+ progress=progress,
73
+ **options,
74
+ )
75
+ runner = Runner(Path(workspace), settings, run_options, client=client)
76
+ report = await runner.run()
77
+ return report, runner.config