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.
Files changed (130) hide show
  1. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/CHANGELOG.md +110 -0
  2. netconverter_cli-0.5.0/LICENSE +61 -0
  3. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/PKG-INFO +30 -6
  4. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/README.md +27 -4
  5. netconverter_cli-0.5.0/docs/COMMANDS.md +317 -0
  6. netconverter_cli-0.5.0/docs/PRIVACY.md +256 -0
  7. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/RELEASING.md +1 -0
  8. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/README.md +4 -2
  9. netconverter_cli-0.5.0/docs/connect/compatibility.md +42 -0
  10. netconverter_cli-0.5.0/docs/connect/openclaw.md +51 -0
  11. netconverter_cli-0.5.0/docs/connect/other-assistants.md +47 -0
  12. netconverter_cli-0.5.0/docs/guided-workflows.md +287 -0
  13. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/pyproject.toml +9 -4
  14. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/__init__.py +1 -1
  15. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/api.py +11 -1
  16. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/backend.py +10 -4
  17. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/branding.py +1 -1
  18. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/clerk.py +49 -21
  19. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/cli.py +350 -80
  20. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/commands.py +4 -3
  21. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/connect.py +150 -36
  22. netconverter_cli-0.5.0/src/netconverter_cli/connect_openclaw.py +136 -0
  23. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/controller.py +22 -2
  24. netconverter_cli-0.5.0/src/netconverter_cli/credential_file.py +311 -0
  25. netconverter_cli-0.5.0/src/netconverter_cli/credentials.py +373 -0
  26. netconverter_cli-0.5.0/src/netconverter_cli/design_catalog.py +10 -0
  27. netconverter_cli-0.5.0/src/netconverter_cli/draft_cli.py +102 -0
  28. netconverter_cli-0.5.0/src/netconverter_cli/draft_io.py +215 -0
  29. netconverter_cli-0.5.0/src/netconverter_cli/drafts.py +697 -0
  30. netconverter_cli-0.5.0/src/netconverter_cli/errors.py +95 -0
  31. netconverter_cli-0.5.0/src/netconverter_cli/exposure.py +392 -0
  32. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/guided.py +84 -12
  33. netconverter_cli-0.5.0/src/netconverter_cli/guided_operations.json +319 -0
  34. netconverter_cli-0.5.0/src/netconverter_cli/guided_projects.json +605 -0
  35. netconverter_cli-0.5.0/src/netconverter_cli/job_options.py +230 -0
  36. netconverter_cli-0.5.0/src/netconverter_cli/license.py +211 -0
  37. netconverter_cli-0.5.0/src/netconverter_cli/mcp_client_features.py +212 -0
  38. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/mcp_server.py +502 -43
  39. netconverter_cli-0.5.0/src/netconverter_cli/mcp_workflows.py +246 -0
  40. netconverter_cli-0.5.0/src/netconverter_cli/one_shot.py +45 -0
  41. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/presentation.py +23 -3
  42. netconverter_cli-0.5.0/src/netconverter_cli/privacy_apply.py +248 -0
  43. netconverter_cli-0.5.0/src/netconverter_cli/privacy_cli.py +104 -0
  44. netconverter_cli-0.5.0/src/netconverter_cli/project_cli.py +46 -0
  45. netconverter_cli-0.5.0/src/netconverter_cli/projects.py +81 -0
  46. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/remote_mcp.py +41 -2
  47. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/setup.py +2 -1
  48. netconverter_cli-0.5.0/src/netconverter_cli/summary.py +417 -0
  49. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/tui.py +32 -15
  50. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/update.py +7 -2
  51. netconverter_cli-0.5.0/src/netconverter_cli/walkthrough.py +100 -0
  52. netconverter_cli-0.5.0/src/netconverter_cli/windows_draft_io.py +378 -0
  53. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/conftest.py +14 -0
  54. netconverter_cli-0.5.0/tests/fixtures/jobs/opt_4056e02e5b66.json +73 -0
  55. netconverter_cli-0.5.0/tests/fixtures/jobs/tra_4058ef406cd6.json +29 -0
  56. netconverter_cli-0.5.0/tests/fixtures/jobs/tra_running.json +17 -0
  57. netconverter_cli-0.5.0/tests/fixtures/jobs/val_9f9acb9b5a59.json +146 -0
  58. netconverter_cli-0.5.0/tests/fixtures/jobs/val_9f9acb9b5a59.sarif +92 -0
  59. netconverter_cli-0.5.0/tests/test_autodetect_v5.py +127 -0
  60. netconverter_cli-0.5.0/tests/test_bridge_polish_021.py +69 -0
  61. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_clerk.py +21 -2
  62. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_cli_020.py +3 -0
  63. netconverter_cli-0.5.0/tests/test_connect_compat_014.py +97 -0
  64. netconverter_cli-0.5.0/tests/test_connect_direct_entry.py +79 -0
  65. netconverter_cli-0.5.0/tests/test_connect_openclaw_014.py +128 -0
  66. netconverter_cli-0.5.0/tests/test_credential_file_010.py +274 -0
  67. netconverter_cli-0.5.0/tests/test_draft_cli.py +224 -0
  68. netconverter_cli-0.5.0/tests/test_draft_io.py +198 -0
  69. netconverter_cli-0.5.0/tests/test_draft_jobs.py +392 -0
  70. netconverter_cli-0.5.0/tests/test_drafts.py +496 -0
  71. netconverter_cli-0.5.0/tests/test_errors_009.py +304 -0
  72. netconverter_cli-0.5.0/tests/test_exposure_levels_013.py +301 -0
  73. netconverter_cli-0.5.0/tests/test_guided_full_api_019.py +194 -0
  74. netconverter_cli-0.5.0/tests/test_guided_mapping_012.py +128 -0
  75. netconverter_cli-0.5.0/tests/test_help_008.py +177 -0
  76. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_keyring_bus_017.py +2 -1
  77. netconverter_cli-0.5.0/tests/test_keyring_timeout_010.py +115 -0
  78. netconverter_cli-0.5.0/tests/test_license.py +105 -0
  79. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_mcp.py +38 -11
  80. netconverter_cli-0.5.0/tests/test_mcp_features_020.py +243 -0
  81. netconverter_cli-0.5.0/tests/test_mcp_jobs.py +286 -0
  82. netconverter_cli-0.5.0/tests/test_mcp_workflows.py +396 -0
  83. netconverter_cli-0.5.0/tests/test_options_011_019.py +186 -0
  84. netconverter_cli-0.5.0/tests/test_polish_028.py +60 -0
  85. netconverter_cli-0.5.0/tests/test_privacy_apply_013.py +145 -0
  86. netconverter_cli-0.5.0/tests/test_privacy_cli_013.py +152 -0
  87. netconverter_cli-0.5.0/tests/test_projects.py +212 -0
  88. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_signin_default.py +2 -2
  89. netconverter_cli-0.5.0/tests/test_stage_029.py +80 -0
  90. netconverter_cli-0.5.0/tests/test_strict_default_011.py +92 -0
  91. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_strict_view_015.py +16 -6
  92. netconverter_cli-0.5.0/tests/test_summary_007.py +254 -0
  93. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_update.py +3 -3
  94. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_vendor_error_022.py +3 -3
  95. netconverter_cli-0.5.0/tests/test_walkthrough.py +77 -0
  96. netconverter_cli-0.5.0/tests/test_windows_draft_io.py +305 -0
  97. netconverter_cli-0.4.3/LICENSE +0 -21
  98. netconverter_cli-0.4.3/docs/COMMANDS.md +0 -175
  99. netconverter_cli-0.4.3/docs/PRIVACY.md +0 -136
  100. netconverter_cli-0.4.3/docs/connect/other-assistants.md +0 -32
  101. netconverter_cli-0.4.3/src/netconverter_cli/credentials.py +0 -147
  102. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/.gitignore +0 -0
  103. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/QUICK_START.md +0 -0
  104. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/SECURITY.md +0 -0
  105. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/VERIFICATION.md +0 -0
  106. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/chatgpt.md +0 -0
  107. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-ai.md +0 -0
  108. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-code.md +0 -0
  109. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/claude-desktop.md +0 -0
  110. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/docs/connect/getting-access.md +0 -0
  111. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/examples/README.md +0 -0
  112. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/activity.py +0 -0
  113. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/catalog.py +0 -0
  114. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/palette.py +0 -0
  115. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/privacy.py +0 -0
  116. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/providers.py +0 -0
  117. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/src/netconverter_cli/workspace.py +0 -0
  118. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_boundaries.py +0 -0
  119. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_clerk_host_binding.py +0 -0
  120. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_connect_030.py +0 -0
  121. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_connect_031.py +0 -0
  122. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_download_analysis.py +0 -0
  123. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_folders_cd_ls.py +0 -0
  124. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_inline.py +0 -0
  125. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_mcp_auth_016.py +0 -0
  126. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_presentation.py +0 -0
  127. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_protocols.py +0 -0
  128. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_readonly_workspace.py +0 -0
  129. {netconverter_cli-0.4.3 → netconverter_cli-0.5.0}/tests/test_sessions.py +0 -0
  130. {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.4.3
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: MIT
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.3.0 ● Server ◆ Bridge claude-code · 2m ago
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). `netconverter mcp --strict` narrows those to the strict-view set.
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 [MIT licensed](LICENSE). The license does not grant access to the
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.3.0 ● Server ◆ Bridge claude-code · 2m ago
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). `netconverter mcp --strict` narrows those to the strict-view set.
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 [MIT licensed](LICENSE). The license does not grant access to the
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.