netconverter-cli 0.7.3__tar.gz → 0.8.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.7.3 → netconverter_cli-0.8.0}/CHANGELOG.md +28 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/PKG-INFO +32 -9
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/QUICK_START.md +47 -5
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/README.md +27 -4
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/COMMANDS.md +16 -5
- netconverter_cli-0.8.0/docs/DOCUMENT_EXPORTS.md +36 -0
- netconverter_cli-0.8.0/docs/DOWNLOAD_SECURITY.md +38 -0
- netconverter_cli-0.8.0/docs/FILE_TRANSPORT.md +122 -0
- netconverter_cli-0.8.0/docs/PRESCAN_APPROVAL.md +28 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/PRIVACY.md +51 -7
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/RELEASING.md +24 -7
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/README.md +1 -1
- netconverter_cli-0.8.0/docs/connect/chatgpt.md +96 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/getting-access.md +1 -1
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/pyproject.toml +5 -5
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/__init__.py +1 -1
- netconverter_cli-0.8.0/src/netconverter_cli/_journal_directory.py +131 -0
- netconverter_cli-0.8.0/src/netconverter_cli/api.py +550 -0
- netconverter_cli-0.8.0/src/netconverter_cli/backend.py +257 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/catalog.py +50 -4
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/clerk.py +153 -49
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/cli.py +16 -9
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/connect.py +9 -7
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/controller.py +41 -10
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/credential_file.py +17 -18
- netconverter_cli-0.8.0/src/netconverter_cli/credential_lock.py +87 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/credentials.py +86 -4
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/draft_io.py +60 -27
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/exposure.py +28 -9
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_client_features.py +71 -4
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_server.py +343 -57
- netconverter_cli-0.8.0/src/netconverter_cli/submission_journal.py +178 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/update.py +1 -1
- netconverter_cli-0.8.0/src/netconverter_cli/upload_policy.py +47 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/windows_draft_io.py +15 -12
- netconverter_cli-0.8.0/src/netconverter_cli/windows_submission_io.py +184 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/workspace.py +24 -49
- netconverter_cli-0.8.0/src/netconverter_cli/workspace_listing.py +170 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/conftest.py +3 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk_recovery_issue_11.py +30 -7
- netconverter_cli-0.8.0/tests/test_credential_transactions_issue_58.py +476 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_io.py +4 -1
- netconverter_cli-0.8.0/tests/test_issue_066_storage_quota.py +116 -0
- netconverter_cli-0.8.0/tests/test_issue_2174_artifact_publication.py +198 -0
- netconverter_cli-0.8.0/tests/test_issue_2174_document_exports.py +343 -0
- netconverter_cli-0.8.0/tests/test_issue_2194_prescan_receipts.py +169 -0
- netconverter_cli-0.8.0/tests/test_issue_2195_file_transport.py +440 -0
- netconverter_cli-0.8.0/tests/test_issue_2195_security_boundaries.py +192 -0
- netconverter_cli-0.8.0/tests/test_issue_2292_resumable_download.py +269 -0
- netconverter_cli-0.8.0/tests/test_issue_51_response_secrets.py +108 -0
- netconverter_cli-0.8.0/tests/test_issue_61_api_key_submission.py +111 -0
- netconverter_cli-0.8.0/tests/test_issue_63_64_submission_boundary.py +195 -0
- netconverter_cli-0.8.0/tests/test_issue_65_legacy_receipts.py +210 -0
- netconverter_cli-0.8.0/tests/test_issue_73_guided_disclosure.py +19 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_keyring_bus_017.py +10 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp.py +16 -7
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_features_020.py +1 -1
- netconverter_cli-0.8.0/tests/test_mcp_workspace_discovery.py +205 -0
- netconverter_cli-0.8.0/tests/test_source_snapshot_cli.py +74 -0
- netconverter_cli-0.8.0/tests/test_source_snapshot_transport.py +238 -0
- netconverter_cli-0.8.0/tests/test_status_metadata_disclosure_issue_2295.py +91 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_vendor_error_022.py +9 -3
- netconverter_cli-0.8.0/tests/test_why_needs_review_1494.py +109 -0
- netconverter_cli-0.8.0/tests/test_windows_artifact_publication.py +132 -0
- netconverter_cli-0.8.0/tests/test_windows_source_snapshot.py +69 -0
- netconverter_cli-0.8.0/tests/test_windows_submission_journal.py +212 -0
- netconverter_cli-0.7.3/docs/connect/chatgpt.md +0 -63
- netconverter_cli-0.7.3/src/netconverter_cli/api.py +0 -320
- netconverter_cli-0.7.3/src/netconverter_cli/backend.py +0 -124
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/.gitignore +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/LICENSE +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/SECURITY.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/VERIFICATION.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-ai.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-code.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-desktop.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/compatibility.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/openclaw.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/other-assistants.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/guided-workflows.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/examples/README.md +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/activity.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/branding.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/commands.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/connect_openclaw.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/design_catalog.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/diagrams.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/draft_cli.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/drafts.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/errors.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided_operations.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided_projects.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/job_options.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/license.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_workflows.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/one_shot.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/palette.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/presentation.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy_apply.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy_cli.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/project_cli.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/projects.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/providers.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/remote_mcp.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/setup.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/summary.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/tui.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/walkthrough.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/opt_4056e02e5b66.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/tra_4058ef406cd6.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/tra_running.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/val_9f9acb9b5a59.json +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/val_9f9acb9b5a59.sarif +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_autodetect_v5.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_boundaries.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_bridge_polish_021.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk_host_binding.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_cli_020.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_030.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_031.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_compat_014.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_direct_entry.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_openclaw_014.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_credential_file_010.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_diagrams.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_download_analysis.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_cli.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_jobs.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_drafts.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_errors_009.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_exposure_levels_013.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_folders_cd_ls.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_full_api_019.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_mapping_012.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_prescan_037.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_help_008.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_inline.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_keyring_timeout_010.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_license.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_auth_016.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_jobs.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_workflows.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_options_011_019.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_polish_028.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_presentation.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_privacy_apply_013.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_privacy_cli_013.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_projects.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_protocols.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_readonly_workspace.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_sessions.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_setup.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_signin_default.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_stage_029.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_strict_default_011.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_strict_view_015.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_summary_007.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_update.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_walkthrough.py +0 -0
- {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_windows_draft_io.py +0 -0
|
@@ -1,5 +1,33 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.8.0 — 2026-11-20
|
|
4
|
+
|
|
5
|
+
- Report the guided mapping tools actually advertised in masked sessions instead of claiming that none exist. Preserve strict filtering and tenant write permissions (#73).
|
|
6
|
+
- Explain credential-store recovery for the running operating system; macOS guidance no longer prescribes Linux D-Bus settings. No credential access or privacy policy changes.
|
|
7
|
+
- Document arbitrary customer folders and the distinct interactive Terminal, local stdio bridge and hosted MCP workflows.
|
|
8
|
+
|
|
9
|
+
- Prepare evidence workbooks through bounded resumable exports. Full API conversion downloads preserve verified primary-file receipts when a workbook is pending or fails, and resume only the named workbook. Verify its server hash, type and size (maximum 50 MiB); never fall back to an expensive synchronous export or replace existing files. Requires matching server support. Installed macOS stdio qualification verified configuration/report downloads and resumable workbook completion.
|
|
10
|
+
|
|
11
|
+
- Discover local configuration paths with the metadata-only `list_workspace_files` MCP tool on POSIX at the human-selected full exposure level. Pages stay within the selected workspace, exclude hidden state and unsafe links, and refuse stale or changing listings. Windows enumeration remains unavailable; known-path submission is unchanged. Clarify hosted versus local ChatGPT/Codex connections.
|
|
12
|
+
- Explain typed account-storage quota refusals with safe byte counts and storage-management guidance. Unknown server errors remain scrubbed; no automatic retry or file removal occurs. Requires the matching server error contract; live qualification remains pending.
|
|
13
|
+
- Negotiate configurable direct-file upload limits and upload file references without sending source content through the assistant. Scoped manager ZIP bundles remain standard conversion-only; guided bundles are not supported yet.
|
|
14
|
+
- Preserve ambiguous submissions in a confined journal; retry only the identical request through the server idempotency contract.
|
|
15
|
+
- Forward an exact server-approved guided submission receipt without a second bridge queue prompt. Initial upload authorization and human server review remain separate.
|
|
16
|
+
- Download explicitly requested YAML/NCIR as verified files; keep bodies out of model responses and preserve existing output files during races and failures.
|
|
17
|
+
- Confine source snapshots and artifact writes on POSIX and Windows; reject private state, unsafe links and changing source paths.
|
|
18
|
+
- Extend secret filtering to nested credential values and mapping keys while retaining opaque workflow identifiers.
|
|
19
|
+
- Serialize login/refresh/logout updates across processes and preserve newer login generations. Restart older terminal/MCP processes after upgrading; they do not participate in the new credential transaction protocol.
|
|
20
|
+
- Use the canonical public download repository `valeronlabs/netconverter-terminal`.
|
|
21
|
+
- Qualified with installed macOS stdio transport, saved live artifact receipts, Linux client CI and Windows boundary CI. Native Windows end-to-end and every hosted assistant workflow remain separate acceptance scopes; this release does not claim device or traffic validation.
|
|
22
|
+
|
|
23
|
+
## Unreleased
|
|
24
|
+
|
|
25
|
+
- Proxy the hosted `why_needs_review` tool (devnexthop/aws-netconverter.ai#1494): the ranked
|
|
26
|
+
readiness checks that hold a job, each with a count, up to five scrubbed items, the remediation
|
|
27
|
+
and the evidence section. Listed at every exposure level (strict view, like `get_evidence`) when
|
|
28
|
+
the server offers it; on an older server a call says it needs a newer NetConverter server
|
|
29
|
+
(`server_upgrade_required`) instead of `unknown_tool`.
|
|
30
|
+
|
|
3
31
|
## 0.7.3 — 2026-11-03
|
|
4
32
|
|
|
5
33
|
- Recover an expired Clerk sign-in in the running MCP bridge after a separate `netconverter login --clerk`, without restarting the assistant.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: netconverter-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.8.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
|
-
Project-URL: Repository, https://github.com/valeronlabs/
|
|
7
|
-
Project-URL: Documentation, https://github.com/valeronlabs/
|
|
8
|
-
Project-URL: Issues, https://github.com/valeronlabs/
|
|
9
|
-
Project-URL: Changelog, https://github.com/valeronlabs/
|
|
6
|
+
Project-URL: Repository, https://github.com/valeronlabs/netconverter-terminal
|
|
7
|
+
Project-URL: Documentation, https://github.com/valeronlabs/netconverter-terminal/blob/main/QUICK_START.md
|
|
8
|
+
Project-URL: Issues, https://github.com/valeronlabs/netconverter-terminal/issues
|
|
9
|
+
Project-URL: Changelog, https://github.com/valeronlabs/netconverter-terminal/blob/main/CHANGELOG.md
|
|
10
10
|
Author-email: ValeronLabs LLC <contact@netconverter.ai>
|
|
11
11
|
License-Expression: LicenseRef-NetConverter-Proprietary
|
|
12
12
|
License-File: LICENSE
|
|
@@ -37,12 +37,14 @@ Description-Content-Type: text/markdown
|
|
|
37
37
|
|
|
38
38
|
<!-- mcp-name: ai.netconverter/netconverter -->
|
|
39
39
|
|
|
40
|
-
**Migrate, validate and optimize network configurations from the folder that holds them
|
|
40
|
+
**Migrate, validate and optimize network configurations from the folder that holds them, with direct file transport for your AI assistant.**
|
|
41
|
+
|
|
42
|
+
Version 0.8.0. Installed macOS stdio workflows and Linux/Windows CI are verified; native Windows end-to-end and individual hosted assistant workflows retain separate acceptance scopes.
|
|
41
43
|
|
|
42
44
|
NetConverter — by ValeronLabs LLC.
|
|
43
45
|
|
|
44
46
|
```text
|
|
45
|
-
◆ NetConverter v0.
|
|
47
|
+
◆ NetConverter v0.8.0 ● Server ◆ Bridge claude-code · 2m ago
|
|
46
48
|
▍ Start
|
|
47
49
|
▍ /convert Migrate a configuration to another vendor
|
|
48
50
|
▍ /validate Check a configuration before migrating
|
|
@@ -59,7 +61,7 @@ One small client, three ways in:
|
|
|
59
61
|
| | What it is |
|
|
60
62
|
| --- | --- |
|
|
61
63
|
| `netconverter` | A keyboard-first full-screen app: pick a file, answer a few inline questions, follow the job, get verified outputs beside your source. |
|
|
62
|
-
| `netconverter mcp` | A local MCP bridge for Claude Code, Claude Desktop, Cursor, VS Code and Codex. Your AI passes a **file path**; the bridge reads the file and uploads it straight to NetConverter.
|
|
64
|
+
| `netconverter mcp` | A local MCP bridge for Claude Code, Claude Desktop, Cursor, VS Code and Codex. Your AI passes a **file path**; the bridge reads the file and uploads it straight to NetConverter. Automatic file-transfer responses contain paths, hashes, job IDs and summaries. Authorized result tools can expose configuration sections under the account and workspace privacy settings. |
|
|
63
65
|
| `netconverter validate edge.cfg --vendor fortinet` | Plain one-shot commands that print JSON, for scripts and CI. |
|
|
64
66
|
|
|
65
67
|
## What it supports
|
|
@@ -152,7 +154,7 @@ confirmation without showing it (ChatGPT, Claude Code), approve in the conversat
|
|
|
152
154
|
bridge with `--no-upload-confirm`.
|
|
153
155
|
|
|
154
156
|
Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
|
|
155
|
-
plus an allowlist of NetConverter's tools (reports, evidence, NAT, flows, knowledge base,
|
|
157
|
+
plus an allowlist of NetConverter's tools (reports, evidence, why a job needs review, NAT, flows, knowledge base,
|
|
156
158
|
guided mapping and guided migration). What the assistant sees is this folder's **exposure level**
|
|
157
159
|
(`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
|
|
158
160
|
names as tokens, addresses masked, no configuration content); secrets are removed at every
|
|
@@ -170,6 +172,27 @@ hold the assistant at masked.
|
|
|
170
172
|
Inside the app, `/activity` and the header's **Bridge** pill show what your AI did
|
|
171
173
|
through the bridge — paths, sizes, SHA-256 and job IDs only.
|
|
172
174
|
|
|
175
|
+
### Resume an evidence workbook
|
|
176
|
+
|
|
177
|
+
For full API conversion jobs, `download` saves verified configuration/report files and
|
|
178
|
+
prepares the workbook once. `complete: false` means the bundle is incomplete; inspect
|
|
179
|
+
`files`, `pending_export`, and `failure` separately. `export_reference` retains the
|
|
180
|
+
exact resume arguments even if a later status response is lost. Saved file receipts remain valid.
|
|
181
|
+
After the returned retry interval, call `download` with the same `job_id`,
|
|
182
|
+
`artifact_kind: "evidence-workbook"`, and the returned `export_id`. This checks that
|
|
183
|
+
export and downloads only its workbook when ready, without fetching primary files again.
|
|
184
|
+
Each call performs bounded work; there is no background client polling.
|
|
185
|
+
|
|
186
|
+
A timeout leaves the response outcome unknown. If preparation returned no export ID,
|
|
187
|
+
reconcile it before explicitly preparing again. Failed, stale, inaccessible, and older-server
|
|
188
|
+
exports are reported as incomplete; the client never regenerates an export during resume
|
|
189
|
+
or invokes the legacy synchronous workbook endpoint. Review a stale/failed export before
|
|
190
|
+
explicitly preparing a replacement. Export bytes stay out of model replies. Content type,
|
|
191
|
+
length, and the server SHA-256 must agree before atomic, non-overwriting publication.
|
|
192
|
+
The **50 MiB workbook download ceiling** is separate from the configurable source-upload
|
|
193
|
+
policy. Validation/optimization, Quick, diagram, and YAML/NCIR download contracts are unchanged.
|
|
194
|
+
This workflow has synthetic contract coverage; live server/client qualification is pending.
|
|
195
|
+
|
|
173
196
|
### Show a diagram in IDE chat
|
|
174
197
|
|
|
175
198
|
With the matching diagram-enabled server and bridge, use this prompt in your IDE:
|
|
@@ -10,7 +10,12 @@ curl -LsSf https://netconverter.ai/install.sh | sh
|
|
|
10
10
|
```
|
|
11
11
|
|
|
12
12
|
This installs uv and `netconverter-cli` from PyPI, signs you in, creates
|
|
13
|
-
`~/migrations` and offers to connect each AI assistant it finds (steps 2 and 6 below).
|
|
13
|
+
`~/migrations` by default and offers to connect each AI assistant it finds (steps 2 and 6 below).
|
|
14
|
+
That folder name is optional. To select your existing project folder during installation:
|
|
15
|
+
|
|
16
|
+
```sh
|
|
17
|
+
curl -LsSf https://netconverter.ai/install.sh | sh -s -- --workspace "$HOME/Projects/Acme Firewall"
|
|
18
|
+
```
|
|
14
19
|
Add `--no-connect` (`… | sh -s -- --no-connect`) to only install and sign in.
|
|
15
20
|
|
|
16
21
|
By hand:
|
|
@@ -23,7 +28,7 @@ netconverter --version
|
|
|
23
28
|
```
|
|
24
29
|
|
|
25
30
|
Without PyPI access, download `netconverter_cli-<version>-py3-none-any.whl` and
|
|
26
|
-
`SHA256SUMS` from the [latest release](https://github.com/valeronlabs/
|
|
31
|
+
`SHA256SUMS` from the [latest release](https://github.com/valeronlabs/netconverter-terminal/releases/latest),
|
|
27
32
|
run `shasum -a 256 -c SHA256SUMS` (stop if it fails), then
|
|
28
33
|
`uv tool install --python 3.12 ./netconverter_cli-<version>-py3-none-any.whl`.
|
|
29
34
|
|
|
@@ -49,12 +54,49 @@ ASA → Palo Alto scope.
|
|
|
49
54
|
## 3. Run the app in your config folder
|
|
50
55
|
|
|
51
56
|
```sh
|
|
52
|
-
|
|
53
|
-
cp /path/to/examples/demo-asa.cfg .
|
|
57
|
+
cd "/absolute/path/to/your/customer folder"
|
|
54
58
|
netconverter
|
|
59
|
+
|
|
60
|
+
# Or select that folder without changing your shell directory:
|
|
61
|
+
netconverter --workspace "/absolute/path/to/your/customer folder" run
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Use an existing folder you own; replace the example path with yours. No folder named
|
|
65
|
+
`migrations` is required. `run` opens the full-screen app, just like `netconverter`
|
|
66
|
+
without a subcommand. Nothing is uploaded when the app opens. `/ls`, `/pwd` and
|
|
67
|
+
`/cd` list files, show the app folder and change it. Local state lives in that
|
|
68
|
+
folder's `.netconverter/`. Interactive app/CLI downloads go beside a recorded
|
|
69
|
+
source, or to the workspace root when no local source is recorded. MCP `download`
|
|
70
|
+
defaults to the workspace root; its `dest_dir` can select an in-workspace folder.
|
|
71
|
+
|
|
72
|
+
### Choose how you want to work
|
|
73
|
+
|
|
74
|
+
| Mode | Start | Local file access |
|
|
75
|
+
| --- | --- | --- |
|
|
76
|
+
| Terminal by itself | `netconverter` or plain CLI commands | You choose a file and submit directly to NetConverter |
|
|
77
|
+
| Local MCP bridge | Configure your assistant with `netconverter --workspace "/absolute/project folder" connect cursor` | The assistant starts a stdio bridge confined to that configured folder |
|
|
78
|
+
| Hosted MCP | Connect ChatGPT or another remote MCP client to NetConverter | No access to your local disk; upload through Terminal/API first and use the returned source/job ID |
|
|
79
|
+
|
|
80
|
+
The bridge command is `netconverter mcp --workspace "/absolute/project folder"`.
|
|
81
|
+
It is normally launched by the assistant, not typed into an interactive chat.
|
|
82
|
+
The full-screen Terminal does not need to remain open for that separate process.
|
|
83
|
+
Opening Terminal alone does not connect a hosted assistant to your files.
|
|
84
|
+
|
|
85
|
+
Check and deliberately choose this folder's assistant exposure:
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
netconverter --workspace "/absolute/project folder" privacy status
|
|
89
|
+
netconverter --workspace "/absolute/project folder" privacy level full
|
|
55
90
|
```
|
|
56
91
|
|
|
57
|
-
|
|
92
|
+
Raising exposure requires your terminal confirmation. Full means permitted results
|
|
93
|
+
for that folder and account; it does not mean whole-computer access or grant server
|
|
94
|
+
write permissions. Full exposure does not authorize uploading every file; select
|
|
95
|
+
and authorize each intended transfer or explicitly scoped batch. The configured bridge keeps its absolute folder even if you
|
|
96
|
+
later `cd` in a shell. Run `connect` for the new intended folder and reconnect the
|
|
97
|
+
assistant to change it. Keep each customer workspace separate. In 0.8.0, automatic
|
|
98
|
+
MCP file listing is POSIX-only and needs full exposure; Windows can still submit
|
|
99
|
+
an explicitly known, authorized path. Check the running bridge's actual version.
|
|
58
100
|
|
|
59
101
|
| Key | Does |
|
|
60
102
|
| --- | --- |
|
|
@@ -2,12 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
<!-- mcp-name: ai.netconverter/netconverter -->
|
|
4
4
|
|
|
5
|
-
**Migrate, validate and optimize network configurations from the folder that holds them
|
|
5
|
+
**Migrate, validate and optimize network configurations from the folder that holds them, with direct file transport for your AI assistant.**
|
|
6
|
+
|
|
7
|
+
Version 0.8.0. Installed macOS stdio workflows and Linux/Windows CI are verified; native Windows end-to-end and individual hosted assistant workflows retain separate acceptance scopes.
|
|
6
8
|
|
|
7
9
|
NetConverter — by ValeronLabs LLC.
|
|
8
10
|
|
|
9
11
|
```text
|
|
10
|
-
◆ NetConverter v0.
|
|
12
|
+
◆ NetConverter v0.8.0 ● Server ◆ Bridge claude-code · 2m ago
|
|
11
13
|
▍ Start
|
|
12
14
|
▍ /convert Migrate a configuration to another vendor
|
|
13
15
|
▍ /validate Check a configuration before migrating
|
|
@@ -24,7 +26,7 @@ One small client, three ways in:
|
|
|
24
26
|
| | What it is |
|
|
25
27
|
| --- | --- |
|
|
26
28
|
| `netconverter` | A keyboard-first full-screen app: pick a file, answer a few inline questions, follow the job, get verified outputs beside your source. |
|
|
27
|
-
| `netconverter mcp` | A local MCP bridge for Claude Code, Claude Desktop, Cursor, VS Code and Codex. Your AI passes a **file path**; the bridge reads the file and uploads it straight to NetConverter.
|
|
29
|
+
| `netconverter mcp` | A local MCP bridge for Claude Code, Claude Desktop, Cursor, VS Code and Codex. Your AI passes a **file path**; the bridge reads the file and uploads it straight to NetConverter. Automatic file-transfer responses contain paths, hashes, job IDs and summaries. Authorized result tools can expose configuration sections under the account and workspace privacy settings. |
|
|
28
30
|
| `netconverter validate edge.cfg --vendor fortinet` | Plain one-shot commands that print JSON, for scripts and CI. |
|
|
29
31
|
|
|
30
32
|
## What it supports
|
|
@@ -117,7 +119,7 @@ confirmation without showing it (ChatGPT, Claude Code), approve in the conversat
|
|
|
117
119
|
bridge with `--no-upload-confirm`.
|
|
118
120
|
|
|
119
121
|
Bridge tools: `submit_file`, `job_status`, `wait_for_job`, `account`, `download`,
|
|
120
|
-
plus an allowlist of NetConverter's tools (reports, evidence, NAT, flows, knowledge base,
|
|
122
|
+
plus an allowlist of NetConverter's tools (reports, evidence, why a job needs review, NAT, flows, knowledge base,
|
|
121
123
|
guided mapping and guided migration). What the assistant sees is this folder's **exposure level**
|
|
122
124
|
(`netconverter privacy level none|masked|selected|full`, default **masked**: the strict view,
|
|
123
125
|
names as tokens, addresses masked, no configuration content); secrets are removed at every
|
|
@@ -135,6 +137,27 @@ hold the assistant at masked.
|
|
|
135
137
|
Inside the app, `/activity` and the header's **Bridge** pill show what your AI did
|
|
136
138
|
through the bridge — paths, sizes, SHA-256 and job IDs only.
|
|
137
139
|
|
|
140
|
+
### Resume an evidence workbook
|
|
141
|
+
|
|
142
|
+
For full API conversion jobs, `download` saves verified configuration/report files and
|
|
143
|
+
prepares the workbook once. `complete: false` means the bundle is incomplete; inspect
|
|
144
|
+
`files`, `pending_export`, and `failure` separately. `export_reference` retains the
|
|
145
|
+
exact resume arguments even if a later status response is lost. Saved file receipts remain valid.
|
|
146
|
+
After the returned retry interval, call `download` with the same `job_id`,
|
|
147
|
+
`artifact_kind: "evidence-workbook"`, and the returned `export_id`. This checks that
|
|
148
|
+
export and downloads only its workbook when ready, without fetching primary files again.
|
|
149
|
+
Each call performs bounded work; there is no background client polling.
|
|
150
|
+
|
|
151
|
+
A timeout leaves the response outcome unknown. If preparation returned no export ID,
|
|
152
|
+
reconcile it before explicitly preparing again. Failed, stale, inaccessible, and older-server
|
|
153
|
+
exports are reported as incomplete; the client never regenerates an export during resume
|
|
154
|
+
or invokes the legacy synchronous workbook endpoint. Review a stale/failed export before
|
|
155
|
+
explicitly preparing a replacement. Export bytes stay out of model replies. Content type,
|
|
156
|
+
length, and the server SHA-256 must agree before atomic, non-overwriting publication.
|
|
157
|
+
The **50 MiB workbook download ceiling** is separate from the configurable source-upload
|
|
158
|
+
policy. Validation/optimization, Quick, diagram, and YAML/NCIR download contracts are unchanged.
|
|
159
|
+
This workflow has synthetic contract coverage; live server/client qualification is pending.
|
|
160
|
+
|
|
138
161
|
### Show a diagram in IDE chat
|
|
139
162
|
|
|
140
163
|
With the matching diagram-enabled server and bridge, use this prompt in your IDE:
|
|
@@ -147,6 +147,14 @@ netconverter update --yes # same, without the prompt
|
|
|
147
147
|
folder's exposure level decides what the assistant sees. Run `connect` again to drop an old `--strict`,
|
|
148
148
|
which would hold the assistant at masked after you raise the level.
|
|
149
149
|
|
|
150
|
+
The example `~/migrations` is an installer default, not a required folder.
|
|
151
|
+
`netconverter --workspace "/absolute/customer folder" run` opens the interactive
|
|
152
|
+
app; `netconverter mcp --workspace "/absolute/customer folder"` is the separate
|
|
153
|
+
stdio bridge an assistant launches. The latter does not create a public HTTP
|
|
154
|
+
endpoint or let hosted ChatGPT read your disk. `connect` pins the selected folder;
|
|
155
|
+
reconfigure and reconnect the assistant when intentionally changing that folder.
|
|
156
|
+
See [the three working modes](../QUICK_START.md#choose-how-you-want-to-work).
|
|
157
|
+
|
|
150
158
|
### Exposure levels (`privacy`)
|
|
151
159
|
|
|
152
160
|
`netconverter privacy level LEVEL` sets what assistants connected to this folder may see; the
|
|
@@ -200,7 +208,7 @@ changes nothing locally; those apps read jobs, results and the knowledge base bu
|
|
|
200
208
|
submit files. `--all` connects every local assistant whose config folder exists and that
|
|
201
209
|
is not connected yet. `--print` shows every change without writing; `--yes` applies all of them.
|
|
202
210
|
|
|
203
|
-
`update` reads the latest release of `valeronlabs/
|
|
211
|
+
`update` reads the latest release of `valeronlabs/netconverter-terminal` from the
|
|
204
212
|
public GitHub API, downloads the wheel and `SHA256SUMS` to a temporary folder,
|
|
205
213
|
installs only when the SHA-256 matches, and runs `uv tool install --force <wheel>`.
|
|
206
214
|
Without `uv` on PATH it prints the steps instead and exits 1.
|
|
@@ -271,14 +279,16 @@ configuration text). Default: `compare_against_intent`, `fetch`, `get_account`,
|
|
|
271
279
|
`get_unused_objects`, `get_vpn_summary`, `get_zone_summary`, `kb_explain`,
|
|
272
280
|
`kb_search`, `list_jobs`, `list_objects_with_attribute`, `list_rules_matching`,
|
|
273
281
|
`query_ir`, `search`, `select_job`, `simulate_flow`, `vendor_capability_lookup`,
|
|
274
|
-
`get_mapping_questions`, `validate_mapping`, `apply_mapping_answers`, `list_operations`,
|
|
282
|
+
`why_needs_review`, `get_mapping_questions`, `validate_mapping`, `apply_mapping_answers`, `list_operations`,
|
|
275
283
|
`get_decision_document`, `validate_decision_document`, `propose_operations`, `submit_conversion`,
|
|
276
284
|
`set_view_level` (lowers the server's view for the session; it can never raise it).
|
|
277
285
|
At levels `none`, `masked` and `selected` (the default is masked; `full` uses the default list):
|
|
278
286
|
`list_jobs`, `select_job`, `get_account`, `search`, `fetch`,
|
|
279
287
|
`kb_search`, `kb_explain`, `vendor_capability_lookup`, `get_job_brief`,
|
|
280
|
-
`get_evidence`, `get_report`, the three guided-mapping tools, plus the chosen sections' tools under `selected`. A listed tool appears
|
|
281
|
-
only if the server offers it.
|
|
288
|
+
`get_evidence`, `get_report`, `why_needs_review`, the three guided-mapping tools, plus the chosen sections' tools under `selected`. A listed tool appears
|
|
289
|
+
only if the server offers it. `why_needs_review` (aws#1494: the ranked readiness checks that hold a job,
|
|
290
|
+
each with a count, up to five items, the remediation and the evidence section) needs a server that offers
|
|
291
|
+
it; on an older server a call returns `server_upgrade_required` ("needs a newer NetConverter server").
|
|
282
292
|
The bridge sends the level on every request (`X-NetConverter-View: none|masked|selected|full`;
|
|
283
293
|
the server may only lower the grant's view, never raise it) and reads the view in force from
|
|
284
294
|
`get_account`. Until the server applies it, the bridge enforces strict locally: it refuses
|
|
@@ -343,9 +353,10 @@ file is reported as a missing file, never as "not signed in".
|
|
|
343
353
|
| Full-screen UI unsuitable | Use `netconverter plain` or individual CLI commands |
|
|
344
354
|
| "the credentials are in the encrypted file …, which this process cannot open" | Set `NETCONVERTER_CREDENTIAL_PASSPHRASE` (or `NETCONVERTER_CREDENTIAL_PASSPHRASE_FILE`) to the passphrase used at sign-in, in the shell or in the AI client's `env` for the bridge. "does not open" means a wrong passphrase or an altered file |
|
|
345
355
|
| "Your system keyring is locked" (exit 3) | The OS keyring did not answer within 5 seconds (a locked Secret Service collection after a reboot, or a keychain waiting for a password). Unlock it (for example by logging in to the desktop session), or sign in again with `netconverter login` |
|
|
356
|
+
| `keyring_unreachable` from the bridge (macOS) | Run the same installation under the same macOS user, unlock the login Keychain, and respond to any OS permission prompt yourself. Check `netconverter whoami`, then reconnect. Do not change privacy or paste credentials into chat. |
|
|
346
357
|
| `keyring_unreachable` from the bridge (Linux) | The assistant launched `netconverter mcp` without `DBUS_SESSION_BUS_ADDRESS`; the bridge tries `$XDG_RUNTIME_DIR/bus` and `/run/user/<uid>/bus`, else set that variable (or `NETCONVERTER_API_KEY`) in the assistant's MCP server environment and restart it |
|
|
347
358
|
| `submit_file` always fails `upload_declined` / `confirmation_required` (ChatGPT, Claude Code) | The assistant declines confirmation forms without showing them. Say yes in the conversation so it can retry with the `confirm_token`, or start the bridge with `--no-upload-confirm` (`NETCONVERTER_MCP_UPLOAD_CONFIRM=0`) |
|
|
348
|
-
| Guided tools
|
|
359
|
+
| Guided tools missing | Read `account` → `guided_migration.tools` and the actual catalog. Masked sessions can expose mapping questions/validation when advertised. Broader editing requires full exposure; writes additionally require server permission. Exposure cannot grant that permission. |
|
|
349
360
|
| Assistant cannot see a NetConverter tool | The bridge lists only allowlisted remote tools the server offers (fewer below `full`; `netconverter privacy status` shows the level); update the client with `netconverter update` |
|
|
350
361
|
| `netconverter update` says uv is not on PATH | Install uv, or follow the printed download, `shasum -a 256 -c SHA256SUMS` and `uv tool install --force` steps |
|
|
351
362
|
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Explicit YAML and NCIR downloads
|
|
2
|
+
|
|
3
|
+
Use the standard bridge's `download` tool with an explicit `export_kind`:
|
|
4
|
+
|
|
5
|
+
- `decision-yaml`: a prescan decision revision, or the frozen effective YAML
|
|
6
|
+
recorded by a completed conversion. For a prescan, pass `revision` and,
|
|
7
|
+
when available, `expected_document_sha256` from the decision overview.
|
|
8
|
+
- `source-ncir`: the verified source Stage-2.5 NCIR. This is not a mapped target
|
|
9
|
+
inventory or a claim that source extraction was complete.
|
|
10
|
+
|
|
11
|
+
The terminal downloads through the authenticated External API directly into
|
|
12
|
+
the workspace. Only file names, byte counts and SHA-256 receipts return to the
|
|
13
|
+
assistant. Downloading a file does not authorize displaying its body in chat.
|
|
14
|
+
Ordinary job downloads do not automatically fetch these documents.
|
|
15
|
+
|
|
16
|
+
The server checks tenant and owner scope and the stored artifact identity.
|
|
17
|
+
The terminal rejects redirects, missing or mismatched hashes, substituted
|
|
18
|
+
decision revisions, unknown provenance, and streams over 100 MiB. Verified
|
|
19
|
+
files use revision/hash names and atomic writes; different existing files
|
|
20
|
+
are preserved. A projected customer NCIR can differ from the internal stored
|
|
21
|
+
artifact; the server identifies both the original artifact hash and the hash
|
|
22
|
+
of the actual exported bytes.
|
|
23
|
+
|
|
24
|
+
Export requests require identity HTTP encoding; compressed responses are
|
|
25
|
+
refused before decoding. Error bodies are limited to 8 KiB. Credential refresh
|
|
26
|
+
retries at most once, after that bounded read, so an initial 401 response cannot
|
|
27
|
+
bypass the download limits. Error messages retain only a bounded error code.
|
|
28
|
+
|
|
29
|
+
A conversion export never substitutes the prescan's latest edits. Missing
|
|
30
|
+
historical documents, pending jobs, integrity failures and unsupported servers
|
|
31
|
+
remain errors; the terminal does not reconstruct the document or silently use
|
|
32
|
+
another download route. The restricted Quick API and `--guided` pilot retain
|
|
33
|
+
their existing artifact contracts.
|
|
34
|
+
|
|
35
|
+
These are candidate capabilities. Live server/client and final package
|
|
36
|
+
acceptance must be recorded separately from mocked transport tests.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Verified artifact publication
|
|
2
|
+
|
|
3
|
+
Ordinary job downloads, Quick API artifacts, diagrams and explicit document
|
|
4
|
+
exports share `Workspace.save_artifact`. It checks the supplied SHA-256 before
|
|
5
|
+
publishing through the same filesystem boundary used by guided artifacts.
|
|
6
|
+
|
|
7
|
+
POSIX operations traverse directories without following symlinks, retain
|
|
8
|
+
directory descriptors and verify directory identities during publication.
|
|
9
|
+
Windows uses held native handles on local NTFS, pinning ancestors against
|
|
10
|
+
renaming and refusing reparse points. Neither path overwrites a conflicting
|
|
11
|
+
customer file. Special files and hard links are refused, and existing files
|
|
12
|
+
are compared with a bounded read before an identical download is reused.
|
|
13
|
+
|
|
14
|
+
Generic downloads permit verified empty files and files up to 100 MiB.
|
|
15
|
+
Guided artifact publication retains its separate 32 MiB ceiling and nonempty
|
|
16
|
+
requirement. Existing identical generic downloads remain reusable, including
|
|
17
|
+
legacy Windows files whose ACLs were inherited; new Windows files receive a
|
|
18
|
+
protected owner-only ACL. Guided artifact reuse retains its stricter ACL rule.
|
|
19
|
+
|
|
20
|
+
After publication, the workspace retains only the verified hash and byte count
|
|
21
|
+
in memory. MCP builds its file receipt from that metadata without reopening
|
|
22
|
+
the pathname. A receipt identifies the bytes checked at publication; it does
|
|
23
|
+
not attest to later edits made by a user or another process. Raw file contents
|
|
24
|
+
are never retained in the receipt or returned to the model by this mechanism.
|
|
25
|
+
|
|
26
|
+
If verification or directory synchronization fails after a final filename was
|
|
27
|
+
published, the operation returns an error and no publication receipt. The final
|
|
28
|
+
file may remain: cleanup never unlinks that pathname, because a concurrent
|
|
29
|
+
customer save could have replaced it. Temporary-file cleanup still uses the
|
|
30
|
+
held directory and checks the temporary file's identity. A retained file does
|
|
31
|
+
not establish a successful flush or abrupt power-loss durability; inspect it
|
|
32
|
+
or retry the same download before treating it as a completed transfer.
|
|
33
|
+
|
|
34
|
+
Synthetic race tests cover directory replacement before and during publication,
|
|
35
|
+
conflicting concurrent files, hard links, FIFOs, oversized existing files and
|
|
36
|
+
post-publication pathname substitution. The private Windows CI lane runs real
|
|
37
|
+
native filesystem tests. Live service, installed-client and abrupt power-loss
|
|
38
|
+
acceptance remain separate from those tests.
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Negotiated configuration file transport
|
|
2
|
+
|
|
3
|
+
This development change addresses engine issue
|
|
4
|
+
[2195](https://github.com/devnexthop/aws-netconverter.ai/issues/2195).
|
|
5
|
+
Public terminal release and platform acceptance are separate gates.
|
|
6
|
+
|
|
7
|
+
Full API clients read the authenticated `/capabilities` limits before submission.
|
|
8
|
+
`max_inline_config_bytes` limits legacy JSON submission. `max_upload_bytes` is the
|
|
9
|
+
effective file allowance, governed by the administrator's upload policy and the
|
|
10
|
+
account's limits. `file_id_submission: true` enables multipart upload followed by
|
|
11
|
+
a `/jobs` request containing only the returned file ID and migration settings.
|
|
12
|
+
The terminal applies a 100 MiB local safety ceiling. An unavailable policy fails
|
|
13
|
+
closed; only an older server returning 404 uses the legacy 5 MiB inline path.
|
|
14
|
+
The dedicated Quick pilot retains its own smaller limits.
|
|
15
|
+
|
|
16
|
+
The bridge receives a path, reads at most the advertised allowance plus one byte,
|
|
17
|
+
checks the source format, and transfers the selected snapshot directly over authenticated
|
|
18
|
+
HTTPS. It verifies the upload receipt's SHA-256 and byte count before queueing.
|
|
19
|
+
The model receives the job ID, status, source hash and size, never the file body.
|
|
20
|
+
Summaries and decision values returned by MCP are still visible to the model.
|
|
21
|
+
|
|
22
|
+
All source reads use held descriptors on POSIX or native handles on local NTFS,
|
|
23
|
+
refuse special files and hard links, and verify the file and parent identity.
|
|
24
|
+
A parent replacement cannot redirect the read outside the workspace. Files
|
|
25
|
+
changed after CLI selection must be selected again; a failed local read creates
|
|
26
|
+
no new pending job and preserves any existing ambiguous submission.
|
|
27
|
+
|
|
28
|
+
Native configurations must be nonempty UTF-8 text without NUL bytes. Full-API
|
|
29
|
+
conversion can also submit an opaque ZIP when the server advertises file-ID
|
|
30
|
+
transport. Prescan additionally supports Check Point and Cisco FMC handoff ZIPs
|
|
31
|
+
over that transport. The client neither extracts nor interprets archive members;
|
|
32
|
+
the server remains responsible for validating the handoff manifest, scope,
|
|
33
|
+
vendor, size and contents. The ZIP transport tests use synthetic non-production
|
|
34
|
+
manifests and do not establish any vendor bundle's conversion correctness.
|
|
35
|
+
ZIPs cannot use legacy inline submission, the Quick pilot, validation or
|
|
36
|
+
optimization. Prescans of other ZIP source types also refuse before upload.
|
|
37
|
+
The server must support the handoff's manifest and selected-device scope; an
|
|
38
|
+
older server may reject it after upload. That refusal is returned honestly,
|
|
39
|
+
without retrying inline or substituting conversion. A successful transport
|
|
40
|
+
receipt alone is not manager-bundle or guided-workflow acceptance.
|
|
41
|
+
|
|
42
|
+
Accepted vendor aliases (`aruba_cx`, `fortinet_fortigate`, `checkpoint` and
|
|
43
|
+
`check-point`) resolve to their canonical identity before MCP source reading,
|
|
44
|
+
confirmation and replay binding. Router/switch and Junos SET/hierarchical codes
|
|
45
|
+
remain distinct. Unknown or ambiguous codes and cross-device requests refuse;
|
|
46
|
+
the server remains authoritative for supported directed paths and source-only
|
|
47
|
+
targets. New vendor identities require terminal contract updates before use.
|
|
48
|
+
|
|
49
|
+
The bridge saves private transport receipts under `.netconverter/submissions/`.
|
|
50
|
+
These contain hashes, request keys, file IDs and bounded job receipts, not source
|
|
51
|
+
content or credentials. An OS lock serializes submissions for the same path.
|
|
52
|
+
After an ambiguous job response, retry the same arguments: the original uploaded
|
|
53
|
+
file and idempotency key are reused, including after restarting the bridge.
|
|
54
|
+
A completed identical request returns its original job with `replayed: true`
|
|
55
|
+
after checking current access. Use the supported job rerun workflow for a new run.
|
|
56
|
+
Changes to a pending source, options, account, server or exposure are refused;
|
|
57
|
+
resolve the original request before replacing its receipt.
|
|
58
|
+
|
|
59
|
+
API keys selected explicitly, by automatic fallback, or after bridge startup use
|
|
60
|
+
the same credential normalization as REST requests when binding a receipt. OAuth
|
|
61
|
+
token refresh preserves its issuer/subject/organization partition; changing a key
|
|
62
|
+
or OAuth identity does not reuse the prior partition.
|
|
63
|
+
|
|
64
|
+
New receipts use journal version 2 with canonical vendor identities. Version-1
|
|
65
|
+
receipts are retained losslessly: equivalent old aliases can replay the same
|
|
66
|
+
completed job after an access check, or retry an ambiguous request with its
|
|
67
|
+
original file ID, idempotency key and vendor values. No new confirmation or
|
|
68
|
+
upload is introduced. A changed or nonunique legacy scope requires explicit
|
|
69
|
+
reconciliation; it never silently becomes a new job. An old bare `aruba_cx`
|
|
70
|
+
source receipt also requires reconciliation because the old client sent the
|
|
71
|
+
wrong device type. Unknown journal versions and malformed records refuse.
|
|
72
|
+
Fresh version-2 work retains the existing confirmation for genuinely changed
|
|
73
|
+
intent. Legacy records are not rewritten just to upgrade their format.
|
|
74
|
+
|
|
75
|
+
An ambiguous job submission is retryable for at most **23 hours from its first
|
|
76
|
+
attempt**, conservatively inside the server's 24-hour idempotency retention.
|
|
77
|
+
This relies on the local clock: missing, malformed, future or expired timestamps
|
|
78
|
+
refuse another POST and preserve the receipt for reconciliation. Keep the clock
|
|
79
|
+
accurate; no new key is generated automatically after the window. Completed
|
|
80
|
+
receipts remain replayable after checking current server access.
|
|
81
|
+
|
|
82
|
+
A first-attempt, well-formed rejection with a recognized 400, 403, 404, 413, 422
|
|
83
|
+
or 429 code clears that rejected request so corrected work can be confirmed.
|
|
84
|
+
Transport/response-parse failures and any later rejection after an ambiguous
|
|
85
|
+
attempt preserve the original receipt. The journal only reads bounded regular
|
|
86
|
+
files; POSIX receipt writes synchronize the file and its parent directory.
|
|
87
|
+
On POSIX, directory creation and every lock, read, replacement, deletion and
|
|
88
|
+
directory sync use securely opened directory descriptors. Each path component
|
|
89
|
+
is opened without following symlinks. On Windows, only local NTFS is supported:
|
|
90
|
+
held native handles pin every ancestor against deletion or renaming, reparse
|
|
91
|
+
points are refused, and an exclusive write handle locks the journal. Metadata
|
|
92
|
+
files and the submission directory require protected owner-only ACLs. Both
|
|
93
|
+
implementations refuse metadata hard links and special files.
|
|
94
|
+
|
|
95
|
+
Windows writes use write-through handles, checked file flushes and native
|
|
96
|
+
handle-based replacement/deletion. An error preserves the request's retry
|
|
97
|
+
identity; a failure after replacement is treated as ambiguous. This is not a
|
|
98
|
+
claim of tested abrupt power-loss durability or a POSIX-style directory flush.
|
|
99
|
+
The Windows contract follows Microsoft's [sharing rules](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilew),
|
|
100
|
+
[native rename contract](https://learn.microsoft.com/en-us/windows/win32/api/winbase/ns-winbase-file_rename_info)
|
|
101
|
+
and [file flush requirements](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers).
|
|
102
|
+
|
|
103
|
+
The full-API CLI/TUI pending session also binds the uploaded receipt to its
|
|
104
|
+
original credential and server, preserves prior ambiguous attempts on later
|
|
105
|
+
rejections, and applies the same 23-hour retry window. Changing accounts or
|
|
106
|
+
servers refuses resume without altering the original pending session. Older
|
|
107
|
+
pending sessions without a transport binding require reconciliation.
|
|
108
|
+
|
|
109
|
+
If the upload response itself is lost, no job has been queued by this client yet.
|
|
110
|
+
A retry may leave a quota-bound orphan upload; server-side upload idempotency is
|
|
111
|
+
not claimed. No client automatically deletes those files.
|
|
112
|
+
|
|
113
|
+
Transport receipt reuse avoids repeating an already obtained confirmation for an
|
|
114
|
+
identical interrupted submission. It does not authorize a different migration or
|
|
115
|
+
replace the independent guided-conversion approval workflow tracked in
|
|
116
|
+
[2194](https://github.com/devnexthop/aws-netconverter.ai/issues/2194).
|
|
117
|
+
|
|
118
|
+
Local mocked transport tests establish boundary and retry behavior. The private
|
|
119
|
+
Windows CI lane exercises actual NTFS handles, junction refusal, exclusive locks,
|
|
120
|
+
ACLs, replacement, cleanup and bridge retry against synthetic HTTP responses.
|
|
121
|
+
Live server, admin policy, large-config conversion, installed Windows client and
|
|
122
|
+
hosted-client compatibility must be recorded separately before claiming them tested.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Exact-revision prescan approval
|
|
2
|
+
|
|
3
|
+
The standard bridge can proxy `request_submission_review` and
|
|
4
|
+
`get_submission_approval` when the authenticated server exposes them. These
|
|
5
|
+
tools require full exposure and the server's account-specific grant. The
|
|
6
|
+
restricted `--guided` pilot retains its separate contract.
|
|
7
|
+
|
|
8
|
+
After proposing and validating choices, request review for the exact prescan
|
|
9
|
+
revision, target, and acknowledged warnings. The review URL opens the server's
|
|
10
|
+
human approval ceremony. A URL, pending response, assistant statement, or local
|
|
11
|
+
`confirm_token` is not a server approval receipt.
|
|
12
|
+
|
|
13
|
+
Once the user approves, retrieve the receipt and call `submit_conversion` with
|
|
14
|
+
the prescan ID and revision, `draft_id`, `approval_ref`, and a stable
|
|
15
|
+
`idempotency_key`. The bridge forwards these handles without another queue
|
|
16
|
+
confirmation. The server checks ownership, current revision, expiry, revocation,
|
|
17
|
+
and the approved source/NCIR/decision binding before atomically consuming the
|
|
18
|
+
receipt and queuing the job. An ambiguous retry must keep the same handles and
|
|
19
|
+
key; no local acknowledgement creates approval authority.
|
|
20
|
+
|
|
21
|
+
The bridge refuses receipt-shaped requests if the advertised server contract
|
|
22
|
+
lacks the required tools or receipt fields. It does not fall back to an older
|
|
23
|
+
submission that could ignore approval fields. Ordinary legacy submissions keep
|
|
24
|
+
their existing confirmation behavior. Initial file upload consent remains
|
|
25
|
+
separate from approval of the migration design.
|
|
26
|
+
|
|
27
|
+
This source change is a candidate. Mocked bridge tests do not establish a live
|
|
28
|
+
portal ceremony, final worker behavior, or customer package acceptance.
|