netconverter-cli 0.4.3__tar.gz → 0.5.0__tar.gz
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.
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/CHANGELOG.md +110 -0
- netconverter_cli-0.5.0/LICENSE +61 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/PKG-INFO +30 -6
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/README.md +27 -4
- netconverter_cli-0.5.0/docs/COMMANDS.md +317 -0
- netconverter_cli-0.5.0/docs/PRIVACY.md +256 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/RELEASING.md +1 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/README.md +4 -2
- netconverter_cli-0.5.0/docs/connect/compatibility.md +42 -0
- netconverter_cli-0.5.0/docs/connect/openclaw.md +51 -0
- netconverter_cli-0.5.0/docs/connect/other-assistants.md +47 -0
- netconverter_cli-0.5.0/docs/guided-workflows.md +287 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/pyproject.toml +9 -4
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/__init__.py +1 -1
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/api.py +11 -1
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/backend.py +10 -4
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/branding.py +1 -1
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/clerk.py +49 -21
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/cli.py +350 -80
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/commands.py +4 -3
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/connect.py +150 -36
- netconverter_cli-0.5.0/src/netconverter_cli/connect_openclaw.py +136 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/controller.py +22 -2
- netconverter_cli-0.5.0/src/netconverter_cli/credential_file.py +311 -0
- netconverter_cli-0.5.0/src/netconverter_cli/credentials.py +373 -0
- netconverter_cli-0.5.0/src/netconverter_cli/design_catalog.py +10 -0
- netconverter_cli-0.5.0/src/netconverter_cli/draft_cli.py +102 -0
- netconverter_cli-0.5.0/src/netconverter_cli/draft_io.py +215 -0
- netconverter_cli-0.5.0/src/netconverter_cli/drafts.py +697 -0
- netconverter_cli-0.5.0/src/netconverter_cli/errors.py +95 -0
- netconverter_cli-0.5.0/src/netconverter_cli/exposure.py +392 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/guided.py +84 -12
- netconverter_cli-0.5.0/src/netconverter_cli/guided_operations.json +319 -0
- netconverter_cli-0.5.0/src/netconverter_cli/guided_projects.json +605 -0
- netconverter_cli-0.5.0/src/netconverter_cli/job_options.py +230 -0
- netconverter_cli-0.5.0/src/netconverter_cli/license.py +211 -0
- netconverter_cli-0.5.0/src/netconverter_cli/mcp_client_features.py +212 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/mcp_server.py +502 -43
- netconverter_cli-0.5.0/src/netconverter_cli/mcp_workflows.py +246 -0
- netconverter_cli-0.5.0/src/netconverter_cli/one_shot.py +45 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/presentation.py +23 -3
- netconverter_cli-0.5.0/src/netconverter_cli/privacy_apply.py +248 -0
- netconverter_cli-0.5.0/src/netconverter_cli/privacy_cli.py +104 -0
- netconverter_cli-0.5.0/src/netconverter_cli/project_cli.py +46 -0
- netconverter_cli-0.5.0/src/netconverter_cli/projects.py +81 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/remote_mcp.py +41 -2
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/setup.py +2 -1
- netconverter_cli-0.5.0/src/netconverter_cli/summary.py +417 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/tui.py +32 -15
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/update.py +7 -2
- netconverter_cli-0.5.0/src/netconverter_cli/walkthrough.py +100 -0
- netconverter_cli-0.5.0/src/netconverter_cli/windows_draft_io.py +378 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/conftest.py +14 -0
- netconverter_cli-0.5.0/tests/fixtures/jobs/opt_4056e02e5b66.json +73 -0
- netconverter_cli-0.5.0/tests/fixtures/jobs/tra_4058ef406cd6.json +29 -0
- netconverter_cli-0.5.0/tests/fixtures/jobs/tra_running.json +17 -0
- netconverter_cli-0.5.0/tests/fixtures/jobs/val_9f9acb9b5a59.json +146 -0
- netconverter_cli-0.5.0/tests/fixtures/jobs/val_9f9acb9b5a59.sarif +92 -0
- netconverter_cli-0.5.0/tests/test_autodetect_v5.py +127 -0
- netconverter_cli-0.5.0/tests/test_bridge_polish_021.py +69 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_clerk.py +21 -2
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_cli_020.py +3 -0
- netconverter_cli-0.5.0/tests/test_connect_compat_014.py +97 -0
- netconverter_cli-0.5.0/tests/test_connect_direct_entry.py +79 -0
- netconverter_cli-0.5.0/tests/test_connect_openclaw_014.py +128 -0
- netconverter_cli-0.5.0/tests/test_credential_file_010.py +274 -0
- netconverter_cli-0.5.0/tests/test_draft_cli.py +224 -0
- netconverter_cli-0.5.0/tests/test_draft_io.py +198 -0
- netconverter_cli-0.5.0/tests/test_draft_jobs.py +392 -0
- netconverter_cli-0.5.0/tests/test_drafts.py +496 -0
- netconverter_cli-0.5.0/tests/test_errors_009.py +304 -0
- netconverter_cli-0.5.0/tests/test_exposure_levels_013.py +301 -0
- netconverter_cli-0.5.0/tests/test_guided_full_api_019.py +194 -0
- netconverter_cli-0.5.0/tests/test_guided_mapping_012.py +128 -0
- netconverter_cli-0.5.0/tests/test_help_008.py +177 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_keyring_bus_017.py +2 -1
- netconverter_cli-0.5.0/tests/test_keyring_timeout_010.py +115 -0
- netconverter_cli-0.5.0/tests/test_license.py +105 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_mcp.py +38 -11
- netconverter_cli-0.5.0/tests/test_mcp_features_020.py +243 -0
- netconverter_cli-0.5.0/tests/test_mcp_jobs.py +286 -0
- netconverter_cli-0.5.0/tests/test_mcp_workflows.py +396 -0
- netconverter_cli-0.5.0/tests/test_options_011_019.py +186 -0
- netconverter_cli-0.5.0/tests/test_polish_028.py +60 -0
- netconverter_cli-0.5.0/tests/test_privacy_apply_013.py +145 -0
- netconverter_cli-0.5.0/tests/test_privacy_cli_013.py +152 -0
- netconverter_cli-0.5.0/tests/test_projects.py +212 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_signin_default.py +2 -2
- netconverter_cli-0.5.0/tests/test_stage_029.py +80 -0
- netconverter_cli-0.5.0/tests/test_strict_default_011.py +92 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_strict_view_015.py +16 -6
- netconverter_cli-0.5.0/tests/test_summary_007.py +254 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_update.py +3 -3
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_vendor_error_022.py +3 -3
- netconverter_cli-0.5.0/tests/test_walkthrough.py +77 -0
- netconverter_cli-0.5.0/tests/test_windows_draft_io.py +305 -0
- netconverter_cli-0.4.3/LICENSE +0 -21
- netconverter_cli-0.4.3/docs/COMMANDS.md +0 -175
- netconverter_cli-0.4.3/docs/PRIVACY.md +0 -136
- netconverter_cli-0.4.3/docs/connect/other-assistants.md +0 -32
- netconverter_cli-0.4.3/src/netconverter_cli/credentials.py +0 -147
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/.gitignore +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/QUICK_START.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/SECURITY.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/VERIFICATION.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/chatgpt.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-ai.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-code.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-desktop.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/getting-access.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/examples/README.md +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/activity.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/catalog.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/palette.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/privacy.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/providers.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/workspace.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_boundaries.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_clerk_host_binding.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_connect_030.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_connect_031.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_download_analysis.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_folders_cd_ls.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_inline.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_mcp_auth_016.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_presentation.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_protocols.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_readonly_workspace.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_sessions.py +0 -0
- {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_setup.py +0 -0
|
@@ -1,5 +1,115 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.5.0 — 2026-10-29
|
|
4
|
+
|
|
5
|
+
**Upgrade note.** Each folder now has an exposure level for AI assistants, default
|
|
6
|
+
`masked`, and it is the ceiling: `--full` / `NETCONVERTER_MCP_VIEW=full` widen the view
|
|
7
|
+
only after `netconverter privacy level full` (confirmed in a terminal); `--strict` means
|
|
8
|
+
masked. `connect` no longer writes `--strict`; run `netconverter connect <client>` again
|
|
9
|
+
to drop it.
|
|
10
|
+
|
|
11
|
+
- New: guided mapping from your AI assistant. The bridge offers the server's
|
|
12
|
+
`get_mapping_questions`, `validate_mapping` and `apply_mapping_answers`: decision-only
|
|
13
|
+
questions (zones, interfaces, conversion options) where every configuration name is a
|
|
14
|
+
token, answers checked before anything changes, and a new conversion queued only after
|
|
15
|
+
you confirm it in the assistant's own dialog. Not available at level `none`.
|
|
16
|
+
- New: `netconverter privacy level none|masked|selected|full` and `privacy status`.
|
|
17
|
+
Raising a level needs a confirmation typed in a terminal; every change is audited in
|
|
18
|
+
`.netconverter/privacy-audit.jsonl`; no MCP tool can change it. The bridge sends the
|
|
19
|
+
level on every request and filters every result to it; secrets (PSKs, SNMP communities,
|
|
20
|
+
hashes, passwords) are removed at every level.
|
|
21
|
+
- New: `netconverter privacy apply --client claude-code|cursor|gemini|codex|openclaw`
|
|
22
|
+
keeps an assistant's own file tools out of the folder (diff, yes, `.bak`, idempotent;
|
|
23
|
+
codex and openclaw print the settings).
|
|
24
|
+
- New: headless sign-in survives a reboot. Where no OS keyring is reachable (SSH,
|
|
25
|
+
containers), the sign-in and stored keys go to a passphrase-encrypted file (AES-256-GCM,
|
|
26
|
+
scrypt, mode 0600). Choose it with `login --store file` or
|
|
27
|
+
`NETCONVERTER_CREDENTIAL_STORE`; the passphrase comes from
|
|
28
|
+
`NETCONVERTER_CREDENTIAL_PASSPHRASE` or `…_PASSPHRASE_FILE`. `login` and `whoami` name
|
|
29
|
+
the store; the threat model is in docs/PRIVACY.md. Adds the `cryptography` dependency.
|
|
30
|
+
- App: on the full API, `/convert` offers the Advanced and Zone mapping screens after the
|
|
31
|
+
target, sent as a YAML v2 document.
|
|
32
|
+
- Bridge: `outputSchema` for every local tool; MCP prompts `guided-migration` and
|
|
33
|
+
`mapping-review`; `submit_file` asks for upload confirmation in the assistant's own
|
|
34
|
+
dialog when it supports elicitation (a decline sends nothing).
|
|
35
|
+
- `connect gemini` writes an `env` block so Gemini no longer strips the NetConverter
|
|
36
|
+
variables, and says to trust the folder; `connect codex` forwards them with `env_vars`.
|
|
37
|
+
New `connect devin` (Devin Desktop, formerly Windsurf; `windsurf` is kept for the legacy
|
|
38
|
+
Cascade agent). Claude Desktop on Linux gets the manual Edit Config step.
|
|
39
|
+
- docs/connect/compatibility.md: each client's config path and format, checked against
|
|
40
|
+
vendor docs on 2026-10-29.
|
|
41
|
+
|
|
42
|
+
## 0.4.4 — 2026-10-29
|
|
43
|
+
|
|
44
|
+
**License change.** From 0.4.4 the client is licensed by ValeronLabs LLC for use with
|
|
45
|
+
your NetConverter account only; it may not be redistributed or modified (see LICENSE).
|
|
46
|
+
Versions up to 0.4.3 were MIT licensed. On first run the client shows the license and
|
|
47
|
+
asks you to type `accept`; scripts and containers use `netconverter license accept --yes`
|
|
48
|
+
or `NETCONVERTER_ACCEPT_LICENSE=1`. Until it is accepted, `netconverter mcp` answers every
|
|
49
|
+
tool call with how to accept it.
|
|
50
|
+
|
|
51
|
+
**Upgrade note.** `netconverter mcp` now serves the strict view by default; add `--full`
|
|
52
|
+
(or set `NETCONVERTER_MCP_VIEW=full`) if you relied on the wider view. `connect` writes
|
|
53
|
+
`--strict` for every assistant. Errors now go to stderr with distinct exit codes.
|
|
54
|
+
|
|
55
|
+
- New: `netconverter walkthrough` and `/walkthrough`, a short guided tour of jobs, privacy
|
|
56
|
+
and AI integrations.
|
|
57
|
+
- New: `netconverter license` (`show`, `accept`, `status`).
|
|
58
|
+
- `connect` leaves one NetConverter server per assistant: it removes older bridge entries
|
|
59
|
+
and direct `api.netconverter.ai` entries (which NetConverter now refuses) from Cursor,
|
|
60
|
+
Claude Desktop, Gemini CLI, Windsurf and LM Studio, keeping every other server.
|
|
61
|
+
- New: `netconverter connect openclaw` (with `--remove`).
|
|
62
|
+
- convert / validate / optimize / resume print a short plain summary (verdict ready /
|
|
63
|
+
needs review / blocked, counts, first findings, next command); `--json` gives the raw
|
|
64
|
+
response and `--all` lists every finding. The app's job card shows a scorecard.
|
|
65
|
+
- `netconverter query unparsed_lines` (app: `/unparsed_lines`) lists unparsed lines.
|
|
66
|
+
- Job options are checked against a typed allowlist before upload; unknown keys and
|
|
67
|
+
request fields are refused by name. Guided conversion settings reach the full API as a
|
|
68
|
+
YAML v2 document instead of being silently ignored.
|
|
69
|
+
- `job_status` and `wait_for_job` report the job stage.
|
|
70
|
+
- Ctrl-C prints "Cancelled. Nothing was saved." and exits 130. Errors give the specific
|
|
71
|
+
reason (file, `--options`, the server's reason); exit codes 2 usage, 3 sign-in, 4 input,
|
|
72
|
+
5 server (docs/COMMANDS.md). A 403 says what your credential is missing.
|
|
73
|
+
- A locked system keyring is reported after 5 s instead of hanging
|
|
74
|
+
(`NETCONVERTER_KEYRING_TIMEOUT_S`); one signed-out message everywhere.
|
|
75
|
+
- Help text for every command and option, "Did you mean …?" for typos, valid vendor
|
|
76
|
+
codes when `--vendor` is missing, `--to` only on `convert`.
|
|
77
|
+
- App: `/refresh` (`/allowance` still works), the /help footer, `/ls` titles use `~/`.
|
|
78
|
+
- `update --check` prints a plain line (`--json` for JSON); one-shot JSON keeps "→".
|
|
79
|
+
- Auto-detect: Cisco switches no longer read as ArubaOS; IOS-XE switch vs router from the
|
|
80
|
+
content; NX-OS and SRX reported as unsupported.
|
|
81
|
+
- Bridge: clearer options-size refusal, `account` reports a signed-out status, and
|
|
82
|
+
signing in works without restarting the bridge.
|
|
83
|
+
|
|
84
|
+
- **Candidate multi-device project adapters (development preview).** New `project`
|
|
85
|
+
commands and capability-gated guided MCP tools use generated server schemas,
|
|
86
|
+
explicit frozen device revisions and complete link proposals. Bounded evidence
|
|
87
|
+
preserves missing decisions and staleness, verifies snapshot/evidence hashes,
|
|
88
|
+
and never grants project approval or execution. Server opt-in and deployment,
|
|
89
|
+
target/runtime qualification and real desktop acceptance remain required.
|
|
90
|
+
|
|
91
|
+
- **Typed migration proposals (development preview).** A generated server catalog
|
|
92
|
+
describes interface/zone mappings, source scope and explicit policy options.
|
|
93
|
+
CLI and guided MCP validate complete batches and require a matching server
|
|
94
|
+
catalog before submission. Bounded, paginated interface context separates observed
|
|
95
|
+
source fields from desired mappings and reports incomplete decision requirements.
|
|
96
|
+
Routing redesign remains planned; these additions
|
|
97
|
+
do not establish production, Windows or desktop-client qualification.
|
|
98
|
+
|
|
99
|
+
- **Guided draft client foundation (development preview).** `draft` commands and
|
|
100
|
+
`mcp --guided` use explicit revisions, direct local YAML transfer and independent
|
|
101
|
+
human approval references. Every operation requires a fresh versioned server
|
|
102
|
+
capability; unsupported servers refuse before upload. Guided mode refuses legacy
|
|
103
|
+
submission. This is not production/server qualification; Windows secure file IO
|
|
104
|
+
remains pending. Guided job status/wait and generated-artifact downloads bind the
|
|
105
|
+
job, draft revision and manifest; bounded streams verify length and SHA-256 before
|
|
106
|
+
saving without overwriting. See [contract](docs/guided-workflows.md).
|
|
107
|
+
|
|
108
|
+
- **`whoami` never shows an organization's raw id (#685).** An organization with no name
|
|
109
|
+
and no slug is listed as `(unnamed organization)` instead of its `org_…` id. The active
|
|
110
|
+
organization and its membership entry are the same organization and show once, with the
|
|
111
|
+
name if either entry carries one.
|
|
112
|
+
|
|
3
113
|
## 0.4.3 — 2026-10-23
|
|
4
114
|
|
|
5
115
|
- **Move between folders in the terminal app.** `/ls [FOLDER]` (or `/dir`) lists files and
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
NetConverter Terminal Client License
|
|
2
|
+
Version 1.0, effective 2026-10-29
|
|
3
|
+
|
|
4
|
+
Copyright (c) 2026 ValeronLabs LLC. All rights reserved.
|
|
5
|
+
|
|
6
|
+
This license applies to the NetConverter terminal client ("the Software"),
|
|
7
|
+
version 0.4.4 and later, including its source code, documentation and
|
|
8
|
+
installers. Versions 0.4.3 and earlier were released under the MIT License;
|
|
9
|
+
copies of those versions obtained before this license took effect keep the
|
|
10
|
+
MIT terms.
|
|
11
|
+
|
|
12
|
+
1. Grant
|
|
13
|
+
ValeronLabs LLC ("ValeronLabs") grants you a limited, non-exclusive,
|
|
14
|
+
non-transferable, revocable license to install and run the Software on
|
|
15
|
+
devices you control, solely to use NetConverter services under a valid
|
|
16
|
+
NetConverter account, for your own internal business purposes.
|
|
17
|
+
|
|
18
|
+
2. Restrictions
|
|
19
|
+
You may not, and may not permit anyone else to:
|
|
20
|
+
a. copy, distribute, publish, sublicense, sell, rent, lease, lend or
|
|
21
|
+
otherwise make the Software available to any third party, including by
|
|
22
|
+
hosting it for others or bundling it with another product;
|
|
23
|
+
b. modify, adapt, translate or create derivative works of the Software;
|
|
24
|
+
c. remove or alter any copyright, license or proprietary notice;
|
|
25
|
+
d. circumvent or disable any security, authentication, usage limit or
|
|
26
|
+
license-acceptance mechanism of the Software or NetConverter services;
|
|
27
|
+
e. use the Software to build or train a competing product or service.
|
|
28
|
+
|
|
29
|
+
3. Source availability
|
|
30
|
+
The source code may be made available for transparency and security
|
|
31
|
+
review. Being able to read the source grants no right beyond Section 1.
|
|
32
|
+
|
|
33
|
+
4. Ownership
|
|
34
|
+
ValeronLabs and its licensors own the Software and all intellectual
|
|
35
|
+
property rights in it. No rights are granted except those stated here.
|
|
36
|
+
If you send feedback, ValeronLabs may use it without obligation to you.
|
|
37
|
+
|
|
38
|
+
5. Third-party components
|
|
39
|
+
Third-party components included with or required by the Software are
|
|
40
|
+
licensed under their own terms, which govern those components.
|
|
41
|
+
|
|
42
|
+
6. Termination
|
|
43
|
+
This license ends automatically if you breach it or when your NetConverter
|
|
44
|
+
account ends. On termination you must stop using the Software and delete
|
|
45
|
+
all copies in your possession or control.
|
|
46
|
+
|
|
47
|
+
7. No warranty
|
|
48
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
49
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
50
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
51
|
+
|
|
52
|
+
8. Limitation of liability
|
|
53
|
+
IN NO EVENT SHALL VALERONLABS OR ITS LICENSORS BE LIABLE FOR ANY CLAIM,
|
|
54
|
+
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
55
|
+
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
|
|
56
|
+
USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
57
|
+
|
|
58
|
+
Your use of NetConverter services is also subject to the NetConverter Terms
|
|
59
|
+
of Service and Privacy Policy at https://netconverter.ai.
|
|
60
|
+
|
|
61
|
+
Questions: contact@netconverter.ai
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: netconverter-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.5.0
|
|
4
4
|
Summary: NetConverter CLI — any-vendor network configuration migration, validation and optimization, and a local MCP bridge for your AI assistant
|
|
5
5
|
Project-URL: Homepage, https://netconverter.ai
|
|
6
6
|
Project-URL: Repository, https://github.com/valeronlabs/netconverter_terminals
|
|
@@ -8,7 +8,7 @@ Project-URL: Documentation, https://github.com/valeronlabs/netconverter_terminal
|
|
|
8
8
|
Project-URL: Issues, https://github.com/valeronlabs/netconverter_terminals/issues
|
|
9
9
|
Project-URL: Changelog, https://github.com/valeronlabs/netconverter_terminals/blob/main/CHANGELOG.md
|
|
10
10
|
Author-email: ValeronLabs LLC <contact@netconverter.ai>
|
|
11
|
-
License-Expression:
|
|
11
|
+
License-Expression: LicenseRef-NetConverter-Proprietary
|
|
12
12
|
License-File: LICENSE
|
|
13
13
|
Keywords: check-point,cisco,firewall,fortinet,mcp,migration,model-context-protocol,netconverter,network-automation,palo-alto
|
|
14
14
|
Classifier: Development Status :: 4 - Beta
|
|
@@ -26,6 +26,7 @@ Classifier: Topic :: System :: Networking
|
|
|
26
26
|
Classifier: Topic :: System :: Networking :: Firewalls
|
|
27
27
|
Classifier: Topic :: Utilities
|
|
28
28
|
Requires-Python: >=3.12
|
|
29
|
+
Requires-Dist: cryptography==50.0.2
|
|
29
30
|
Requires-Dist: httpx==0.28.1
|
|
30
31
|
Requires-Dist: keyring==25.7.0
|
|
31
32
|
Requires-Dist: pydantic==2.13.5
|
|
@@ -41,7 +42,7 @@ Description-Content-Type: text/markdown
|
|
|
41
42
|
NetConverter — by ValeronLabs LLC.
|
|
42
43
|
|
|
43
44
|
```text
|
|
44
|
-
◆ NetConverter v0.
|
|
45
|
+
◆ NetConverter v0.5.0 ● Server ◆ Bridge claude-code · 2m ago
|
|
45
46
|
▍ Start
|
|
46
47
|
▍ /convert Migrate a configuration to another vendor
|
|
47
48
|
▍ /validate Check a configuration before migrating
|
|
@@ -78,6 +79,11 @@ Run `netconverter capabilities` to see exactly what your credential can do.
|
|
|
78
79
|
A 0.1.x **Terminal Quick pilot key** still works and keeps its ASA → Palo Alto
|
|
79
80
|
scope; the app labels it as such.
|
|
80
81
|
|
|
82
|
+
Development preview: [revisioned drafts and guided MCP](docs/guided-workflows.md)
|
|
83
|
+
adds an opt-in client contract for manual YAML, reviewed migration preparation,
|
|
84
|
+
job status and verified result downloads.
|
|
85
|
+
It requires explicit server support and is not enabled by an ordinary MCP connection.
|
|
86
|
+
|
|
81
87
|
## Start here
|
|
82
88
|
|
|
83
89
|
One line installs everything (uv, the CLI from PyPI), signs you in and connects
|
|
@@ -114,13 +120,17 @@ first. Saved keys and sign-ins carry over (Keychain service **NetConverter Termi
|
|
|
114
120
|
|
|
115
121
|
Full walkthrough: [Quick start](QUICK_START.md).
|
|
116
122
|
|
|
123
|
+
A YAML v2 decisions file (zone and interface mappings) rides along with a conversion:
|
|
124
|
+
`netconverter convert edge.cfg --vendor fortinet --to palo_alto_xml --options "$(jq -Rs '{yaml_v2: .}' decisions.yaml)"`,
|
|
125
|
+
or inline as `--options '{"yaml_v2": {...}}'`; see [docs/COMMANDS.md](docs/COMMANDS.md#yaml-v2-decisions-yaml_v2).
|
|
126
|
+
|
|
117
127
|
## Use it from your AI
|
|
118
128
|
|
|
119
129
|
Step-by-step guides for every assistant (Claude, ChatGPT, Cursor, Gemini CLI, Codex …):
|
|
120
130
|
[docs/connect](docs/connect/README.md).
|
|
121
131
|
|
|
122
132
|
```sh
|
|
123
|
-
netconverter connect claude-code # or claude-desktop, cursor, vscode, codex, gemini, windsurf, lmstudio
|
|
133
|
+
netconverter connect claude-code # or claude-desktop, cursor, vscode, codex, gemini, devin, windsurf, lmstudio
|
|
124
134
|
netconverter connect --all # every assistant found on this computer
|
|
125
135
|
netconverter connect chatgpt # ChatGPT / claude.ai: remote-connector setup steps
|
|
126
136
|
```
|
|
@@ -134,7 +144,19 @@ Then ask your assistant, for example: *"Validate edge-fw.conf and tell me what i
|
|
|
134
144
|
|
|
135
145
|
Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
|
|
136
146
|
plus an allowlist of NetConverter's read-only tools (reports, evidence, NAT, flows,
|
|
137
|
-
knowledge base).
|
|
147
|
+
knowledge base). What the assistant sees is this folder's **exposure level**
|
|
148
|
+
(`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
|
|
149
|
+
names as tokens, addresses masked, no configuration content); secrets are removed at every
|
|
150
|
+
level, and raising the level needs a confirmation typed in a terminal (docs/PRIVACY.md).
|
|
151
|
+
`netconverter privacy apply --client claude-code` (also cursor, gemini; codex and openclaw
|
|
152
|
+
print the settings) keeps the assistant's own file tools out of the folder. Job `options` from an assistant pass an
|
|
153
|
+
allowlist with type checks: an unknown or reserved key (the file, vendors, job type, a
|
|
154
|
+
decisions document) is refused naming it, never silently sent.
|
|
155
|
+
|
|
156
|
+
**Upgrading from 0.4.x:** `--full` (or `NETCONVERTER_MCP_VIEW=full`) no longer widens the
|
|
157
|
+
view on its own; run `netconverter privacy level full` in a terminal for the folder. Run
|
|
158
|
+
`netconverter connect <assistant>` again to drop the `--strict` that 0.4.4 wrote, which would
|
|
159
|
+
hold the assistant at masked.
|
|
138
160
|
|
|
139
161
|
Inside the app, `/activity` and the header's **Bridge** pill show what your AI did
|
|
140
162
|
through the bridge — paths, sizes, SHA-256 and job IDs only.
|
|
@@ -162,6 +184,8 @@ a day; set `NETCONVERTER_NO_UPDATE_CHECK=1` to turn that off.
|
|
|
162
184
|
- [Privacy and data flow](docs/PRIVACY.md) · [Verification status](docs/VERIFICATION.md)
|
|
163
185
|
- [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
|
|
164
186
|
|
|
165
|
-
The client is
|
|
187
|
+
The client is licensed for use with your NetConverter account only and may not be
|
|
188
|
+
redistributed ([license](LICENSE)); you accept it on first run (`netconverter license`).
|
|
189
|
+
Versions up to 0.4.3 were MIT licensed. The license does not grant access to the
|
|
166
190
|
hosted service or license the server code. macOS is the exercised platform;
|
|
167
191
|
Windows acceptance remains pending.
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
NetConverter — by ValeronLabs LLC.
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
◆ NetConverter v0.
|
|
10
|
+
◆ NetConverter v0.5.0 ● Server ◆ Bridge claude-code · 2m ago
|
|
11
11
|
▍ Start
|
|
12
12
|
▍ /convert Migrate a configuration to another vendor
|
|
13
13
|
▍ /validate Check a configuration before migrating
|
|
@@ -44,6 +44,11 @@ Run `netconverter capabilities` to see exactly what your credential can do.
|
|
|
44
44
|
A 0.1.x **Terminal Quick pilot key** still works and keeps its ASA → Palo Alto
|
|
45
45
|
scope; the app labels it as such.
|
|
46
46
|
|
|
47
|
+
Development preview: [revisioned drafts and guided MCP](docs/guided-workflows.md)
|
|
48
|
+
adds an opt-in client contract for manual YAML, reviewed migration preparation,
|
|
49
|
+
job status and verified result downloads.
|
|
50
|
+
It requires explicit server support and is not enabled by an ordinary MCP connection.
|
|
51
|
+
|
|
47
52
|
## Start here
|
|
48
53
|
|
|
49
54
|
One line installs everything (uv, the CLI from PyPI), signs you in and connects
|
|
@@ -80,13 +85,17 @@ first. Saved keys and sign-ins carry over (Keychain service **NetConverter Termi
|
|
|
80
85
|
|
|
81
86
|
Full walkthrough: [Quick start](QUICK_START.md).
|
|
82
87
|
|
|
88
|
+
A YAML v2 decisions file (zone and interface mappings) rides along with a conversion:
|
|
89
|
+
`netconverter convert edge.cfg --vendor fortinet --to palo_alto_xml --options "$(jq -Rs '{yaml_v2: .}' decisions.yaml)"`,
|
|
90
|
+
or inline as `--options '{"yaml_v2": {...}}'`; see [docs/COMMANDS.md](docs/COMMANDS.md#yaml-v2-decisions-yaml_v2).
|
|
91
|
+
|
|
83
92
|
## Use it from your AI
|
|
84
93
|
|
|
85
94
|
Step-by-step guides for every assistant (Claude, ChatGPT, Cursor, Gemini CLI, Codex …):
|
|
86
95
|
[docs/connect](docs/connect/README.md).
|
|
87
96
|
|
|
88
97
|
```sh
|
|
89
|
-
netconverter connect claude-code # or claude-desktop, cursor, vscode, codex, gemini, windsurf, lmstudio
|
|
98
|
+
netconverter connect claude-code # or claude-desktop, cursor, vscode, codex, gemini, devin, windsurf, lmstudio
|
|
90
99
|
netconverter connect --all # every assistant found on this computer
|
|
91
100
|
netconverter connect chatgpt # ChatGPT / claude.ai: remote-connector setup steps
|
|
92
101
|
```
|
|
@@ -100,7 +109,19 @@ Then ask your assistant, for example: *"Validate edge-fw.conf and tell me what i
|
|
|
100
109
|
|
|
101
110
|
Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
|
|
102
111
|
plus an allowlist of NetConverter's read-only tools (reports, evidence, NAT, flows,
|
|
103
|
-
knowledge base).
|
|
112
|
+
knowledge base). What the assistant sees is this folder's **exposure level**
|
|
113
|
+
(`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
|
|
114
|
+
names as tokens, addresses masked, no configuration content); secrets are removed at every
|
|
115
|
+
level, and raising the level needs a confirmation typed in a terminal (docs/PRIVACY.md).
|
|
116
|
+
`netconverter privacy apply --client claude-code` (also cursor, gemini; codex and openclaw
|
|
117
|
+
print the settings) keeps the assistant's own file tools out of the folder. Job `options` from an assistant pass an
|
|
118
|
+
allowlist with type checks: an unknown or reserved key (the file, vendors, job type, a
|
|
119
|
+
decisions document) is refused naming it, never silently sent.
|
|
120
|
+
|
|
121
|
+
**Upgrading from 0.4.x:** `--full` (or `NETCONVERTER_MCP_VIEW=full`) no longer widens the
|
|
122
|
+
view on its own; run `netconverter privacy level full` in a terminal for the folder. Run
|
|
123
|
+
`netconverter connect <assistant>` again to drop the `--strict` that 0.4.4 wrote, which would
|
|
124
|
+
hold the assistant at masked.
|
|
104
125
|
|
|
105
126
|
Inside the app, `/activity` and the header's **Bridge** pill show what your AI did
|
|
106
127
|
through the bridge — paths, sizes, SHA-256 and job IDs only.
|
|
@@ -128,6 +149,8 @@ a day; set `NETCONVERTER_NO_UPDATE_CHECK=1` to turn that off.
|
|
|
128
149
|
- [Privacy and data flow](docs/PRIVACY.md) · [Verification status](docs/VERIFICATION.md)
|
|
129
150
|
- [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
|
|
130
151
|
|
|
131
|
-
The client is
|
|
152
|
+
The client is licensed for use with your NetConverter account only and may not be
|
|
153
|
+
redistributed ([license](LICENSE)); you accept it on first run (`netconverter license`).
|
|
154
|
+
Versions up to 0.4.3 were MIT licensed. The license does not grant access to the
|
|
132
155
|
hosted service or license the server code. macOS is the exercised platform;
|
|
133
156
|
Windows acceptance remains pending.
|