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.
- traceforge/__init__.py +3 -0
- traceforge/__main__.py +3 -0
- traceforge/acp_server.py +570 -0
- traceforge/agent.py +680 -0
- traceforge/altium/__init__.py +6 -0
- traceforge/altium/cfb.py +70 -0
- traceforge/altium/cli.py +60 -0
- traceforge/altium/model.py +163 -0
- traceforge/altium/outputs.py +24 -0
- traceforge/altium/pcb.py +301 -0
- traceforge/altium/project.py +328 -0
- traceforge/altium/schematic.py +400 -0
- traceforge/altium/tools.py +166 -0
- traceforge/approval.py +219 -0
- traceforge/attachments.py +346 -0
- traceforge/background.py +253 -0
- traceforge/bench/__init__.py +5 -0
- traceforge/bench/adapters.py +337 -0
- traceforge/bench/checks.py +410 -0
- traceforge/bench/cli.py +121 -0
- traceforge/bench/design.py +439 -0
- traceforge/bench/kicad.py +99 -0
- traceforge/bench/partscheck.py +159 -0
- traceforge/bench/review.py +100 -0
- traceforge/bench/runner.py +226 -0
- traceforge/bench/score.py +204 -0
- traceforge/bench/tasks.py +102 -0
- traceforge/chat.py +1185 -0
- traceforge/checks.py +328 -0
- traceforge/checks_sides.py +118 -0
- traceforge/cli.py +2224 -0
- traceforge/clipboard.py +107 -0
- traceforge/config.py +299 -0
- traceforge/context.py +276 -0
- traceforge/design/__init__.py +1 -0
- traceforge/design/constraints.py +397 -0
- traceforge/design/generate.py +1789 -0
- traceforge/design/outline.py +905 -0
- traceforge/design/schematic_layout.py +932 -0
- traceforge/design/schematic_lint.py +329 -0
- traceforge/design/schematic_route.py +207 -0
- traceforge/design/sheets.py +854 -0
- traceforge/design/sides.py +328 -0
- traceforge/design/spec.py +462 -0
- traceforge/design/specsheet.py +2351 -0
- traceforge/design/specsheet_render.py +183 -0
- traceforge/desktop/__init__.py +109 -0
- traceforge/desktop/keys.py +90 -0
- traceforge/desktop/project.py +443 -0
- traceforge/desktop/review.py +20 -0
- traceforge/desktop/server.py +1277 -0
- traceforge/desktop/static/app.css +223 -0
- traceforge/desktop/static/app.js +683 -0
- traceforge/desktop/static/highlight.js +77 -0
- traceforge/desktop/static/index.html +89 -0
- traceforge/desktop/static/md.js +90 -0
- traceforge/desktop/static/viewer.js +213 -0
- traceforge/desktop/symbols.py +212 -0
- traceforge/desktop/update.py +65 -0
- traceforge/diagnostics.py +67 -0
- traceforge/errata.py +219 -0
- traceforge/fab.py +108 -0
- traceforge/fab_layers.py +44 -0
- traceforge/features/__init__.py +6 -0
- traceforge/features/candidates.py +117 -0
- traceforge/features/cli.py +200 -0
- traceforge/features/package.py +433 -0
- traceforge/features/revdiff.py +224 -0
- traceforge/features/sarif.py +145 -0
- traceforge/features/viewer.py +265 -0
- traceforge/firmware/__init__.py +3 -0
- traceforge/firmware/cli.py +174 -0
- traceforge/firmware/drivers.py +372 -0
- traceforge/firmware/drivers_data.py +256 -0
- traceforge/firmware/mcus.py +177 -0
- traceforge/firmware/netlist.py +55 -0
- traceforge/firmware/pinmap.py +296 -0
- traceforge/firmware/scaffold.py +466 -0
- traceforge/firmware/toolchain.py +262 -0
- traceforge/hooks.py +237 -0
- traceforge/kicad/__init__.py +0 -0
- traceforge/kicad/cli.py +519 -0
- traceforge/kicad/diffpair.py +174 -0
- traceforge/kicad/edgegeom.py +191 -0
- traceforge/kicad/edit.py +405 -0
- traceforge/kicad/escape.py +1410 -0
- traceforge/kicad/formats.py +1073 -0
- traceforge/kicad/impedance.py +320 -0
- traceforge/kicad/install.py +75 -0
- traceforge/kicad/libraries.py +490 -0
- traceforge/kicad/models3d.py +942 -0
- traceforge/kicad/outputs.py +81 -0
- traceforge/kicad/pcb.py +787 -0
- traceforge/kicad/planes.py +1242 -0
- traceforge/kicad/project.py +136 -0
- traceforge/kicad/route.py +2698 -0
- traceforge/kicad/routegeom.py +164 -0
- traceforge/kicad/schematic.py +268 -0
- traceforge/kicad/sides.py +34 -0
- traceforge/kicad/stackup.py +424 -0
- traceforge/kicad_plugin/__init__.py +12 -0
- traceforge/kicad_plugin/actions.py +92 -0
- traceforge/kicad_plugin/cli.py +66 -0
- traceforge/kicad_plugin/client.py +86 -0
- traceforge/kicad_plugin/context.py +257 -0
- traceforge/kicad_plugin/discovery.py +81 -0
- traceforge/kicad_plugin/install.py +203 -0
- traceforge/kicad_plugin/overlay.py +60 -0
- traceforge/kicad_plugin/payload/action_plugin.py +65 -0
- traceforge/kicad_plugin/payload/ipc_main.py +42 -0
- traceforge/kicad_plugin/payload/plugin.json +90 -0
- traceforge/kicad_plugin/payload/requirements.txt +1 -0
- traceforge/kicad_plugin/views.py +202 -0
- traceforge/langchain.py +57 -0
- traceforge/local.py +580 -0
- traceforge/mcp_server.py +304 -0
- traceforge/models.py +310 -0
- traceforge/next_steps.py +110 -0
- traceforge/parts/__init__.py +52 -0
- traceforge/parts/alternates.py +488 -0
- traceforge/parts/bom.py +423 -0
- traceforge/parts/brief.py +705 -0
- traceforge/parts/catalog.py +297 -0
- traceforge/parts/cli_sourcing.py +156 -0
- traceforge/parts/data/duty_rates.yaml +37 -0
- traceforge/parts/data/hs_codes.yaml +103 -0
- traceforge/parts/datasheet.py +278 -0
- traceforge/parts/fx.py +100 -0
- traceforge/parts/model.py +185 -0
- traceforge/parts/net.py +187 -0
- traceforge/parts/offers.py +46 -0
- traceforge/parts/packages.py +397 -0
- traceforge/parts/pinout.py +714 -0
- traceforge/parts/providers/__init__.py +17 -0
- traceforge/parts/providers/base.py +100 -0
- traceforge/parts/providers/jlc.py +364 -0
- traceforge/parts/providers/keyed.py +661 -0
- traceforge/parts/report.py +508 -0
- traceforge/parts/supply.py +330 -0
- traceforge/parts/verify.py +455 -0
- traceforge/parts/web.py +575 -0
- traceforge/plans.py +70 -0
- traceforge/preferences.py +127 -0
- traceforge/prices.py +130 -0
- traceforge/prices.yaml +28 -0
- traceforge/prompts/__init__.py +54 -0
- traceforge/prompts/system.md +103 -0
- traceforge/providers.py +764 -0
- traceforge/remote/__init__.py +33 -0
- traceforge/remote/client.py +422 -0
- traceforge/remote/oidc.py +240 -0
- traceforge/remote/orgs.py +510 -0
- traceforge/remote/server.py +690 -0
- traceforge/remote/store.py +100 -0
- traceforge/review_changes.py +187 -0
- traceforge/routing.py +99 -0
- traceforge/runtime.py +435 -0
- traceforge/sessions.py +324 -0
- traceforge/sexpr.py +279 -0
- traceforge/sim/__init__.py +17 -0
- traceforge/sim/acmath.py +234 -0
- traceforge/sim/circuit.py +499 -0
- traceforge/sim/cli.py +162 -0
- traceforge/sim/engine.py +172 -0
- traceforge/sim/ltspice.py +175 -0
- traceforge/sim/measure.py +123 -0
- traceforge/sim/models.py +76 -0
- traceforge/sim/project.py +218 -0
- traceforge/sim/rawfile.py +123 -0
- traceforge/sim/results.py +298 -0
- traceforge/sim/tune.py +172 -0
- traceforge/skill_commands.py +165 -0
- traceforge/skill_library/circuit-simulation/SKILL.md +30 -0
- traceforge/skill_library/compliance-review/SKILL.md +51 -0
- traceforge/skill_library/design-review/SKILL.md +47 -0
- traceforge/skill_library/errata-hunt/SKILL.md +30 -0
- traceforge/skill_library/firmware/SKILL.md +26 -0
- traceforge/skill_library/power-budget/SKILL.md +27 -0
- traceforge/skill_library/release-package/SKILL.md +29 -0
- traceforge/skill_library/sourcing-brief/SKILL.md +24 -0
- traceforge/skill_library/thermal-review/SKILL.md +15 -0
- traceforge/skills.py +131 -0
- traceforge/thermal.py +557 -0
- traceforge/tools/__init__.py +48 -0
- traceforge/tools/agent_tools.py +213 -0
- traceforge/tools/base.py +303 -0
- traceforge/tools/batch.py +155 -0
- traceforge/tools/connections.py +245 -0
- traceforge/tools/files.py +777 -0
- traceforge/tools/firmware_tools.py +218 -0
- traceforge/tools/kicad_tools.py +1072 -0
- traceforge/tools/models3d_tools.py +141 -0
- traceforge/tools/parts_tools.py +473 -0
- traceforge/tools/processes.py +246 -0
- traceforge/tools/review_tools.py +178 -0
- traceforge/tools/sim_tools.py +230 -0
- traceforge/tui.py +620 -0
- traceforge/updates.py +124 -0
- traceforge/validate/__init__.py +77 -0
- traceforge/validate/builtins.py +1091 -0
- traceforge/validate/circuits.py +1240 -0
- traceforge/validate/config.py +410 -0
- traceforge/validate/default.yaml +113 -0
- traceforge/validate/design.py +191 -0
- traceforge/validate/explain.py +112 -0
- traceforge/validate/grounding.py +169 -0
- traceforge/validate/ipc2221.py +350 -0
- traceforge/validate/multilayer.py +805 -0
- traceforge/validate/netmodel.py +261 -0
- traceforge/validate/partcheck.py +472 -0
- traceforge/validate/report.py +280 -0
- traceforge/validate/review.py +322 -0
- traceforge/validate/runner.py +662 -0
- traceforge/workspace.py +171 -0
- traceforge_pcb-1.0.0.dist-info/METADATA +463 -0
- traceforge_pcb-1.0.0.dist-info/RECORD +219 -0
- traceforge_pcb-1.0.0.dist-info/WHEEL +4 -0
- traceforge_pcb-1.0.0.dist-info/entry_points.txt +2 -0
- 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
|