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.
Files changed (163) hide show
  1. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/CHANGELOG.md +28 -0
  2. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/PKG-INFO +32 -9
  3. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/QUICK_START.md +47 -5
  4. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/README.md +27 -4
  5. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/COMMANDS.md +16 -5
  6. netconverter_cli-0.8.0/docs/DOCUMENT_EXPORTS.md +36 -0
  7. netconverter_cli-0.8.0/docs/DOWNLOAD_SECURITY.md +38 -0
  8. netconverter_cli-0.8.0/docs/FILE_TRANSPORT.md +122 -0
  9. netconverter_cli-0.8.0/docs/PRESCAN_APPROVAL.md +28 -0
  10. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/PRIVACY.md +51 -7
  11. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/RELEASING.md +24 -7
  12. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/README.md +1 -1
  13. netconverter_cli-0.8.0/docs/connect/chatgpt.md +96 -0
  14. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/getting-access.md +1 -1
  15. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/pyproject.toml +5 -5
  16. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/__init__.py +1 -1
  17. netconverter_cli-0.8.0/src/netconverter_cli/_journal_directory.py +131 -0
  18. netconverter_cli-0.8.0/src/netconverter_cli/api.py +550 -0
  19. netconverter_cli-0.8.0/src/netconverter_cli/backend.py +257 -0
  20. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/catalog.py +50 -4
  21. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/clerk.py +153 -49
  22. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/cli.py +16 -9
  23. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/connect.py +9 -7
  24. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/controller.py +41 -10
  25. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/credential_file.py +17 -18
  26. netconverter_cli-0.8.0/src/netconverter_cli/credential_lock.py +87 -0
  27. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/credentials.py +86 -4
  28. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/draft_io.py +60 -27
  29. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/exposure.py +28 -9
  30. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_client_features.py +71 -4
  31. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_server.py +343 -57
  32. netconverter_cli-0.8.0/src/netconverter_cli/submission_journal.py +178 -0
  33. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/update.py +1 -1
  34. netconverter_cli-0.8.0/src/netconverter_cli/upload_policy.py +47 -0
  35. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/windows_draft_io.py +15 -12
  36. netconverter_cli-0.8.0/src/netconverter_cli/windows_submission_io.py +184 -0
  37. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/workspace.py +24 -49
  38. netconverter_cli-0.8.0/src/netconverter_cli/workspace_listing.py +170 -0
  39. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/conftest.py +3 -0
  40. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk_recovery_issue_11.py +30 -7
  41. netconverter_cli-0.8.0/tests/test_credential_transactions_issue_58.py +476 -0
  42. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_io.py +4 -1
  43. netconverter_cli-0.8.0/tests/test_issue_066_storage_quota.py +116 -0
  44. netconverter_cli-0.8.0/tests/test_issue_2174_artifact_publication.py +198 -0
  45. netconverter_cli-0.8.0/tests/test_issue_2174_document_exports.py +343 -0
  46. netconverter_cli-0.8.0/tests/test_issue_2194_prescan_receipts.py +169 -0
  47. netconverter_cli-0.8.0/tests/test_issue_2195_file_transport.py +440 -0
  48. netconverter_cli-0.8.0/tests/test_issue_2195_security_boundaries.py +192 -0
  49. netconverter_cli-0.8.0/tests/test_issue_2292_resumable_download.py +269 -0
  50. netconverter_cli-0.8.0/tests/test_issue_51_response_secrets.py +108 -0
  51. netconverter_cli-0.8.0/tests/test_issue_61_api_key_submission.py +111 -0
  52. netconverter_cli-0.8.0/tests/test_issue_63_64_submission_boundary.py +195 -0
  53. netconverter_cli-0.8.0/tests/test_issue_65_legacy_receipts.py +210 -0
  54. netconverter_cli-0.8.0/tests/test_issue_73_guided_disclosure.py +19 -0
  55. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_keyring_bus_017.py +10 -0
  56. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp.py +16 -7
  57. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_features_020.py +1 -1
  58. netconverter_cli-0.8.0/tests/test_mcp_workspace_discovery.py +205 -0
  59. netconverter_cli-0.8.0/tests/test_source_snapshot_cli.py +74 -0
  60. netconverter_cli-0.8.0/tests/test_source_snapshot_transport.py +238 -0
  61. netconverter_cli-0.8.0/tests/test_status_metadata_disclosure_issue_2295.py +91 -0
  62. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_vendor_error_022.py +9 -3
  63. netconverter_cli-0.8.0/tests/test_why_needs_review_1494.py +109 -0
  64. netconverter_cli-0.8.0/tests/test_windows_artifact_publication.py +132 -0
  65. netconverter_cli-0.8.0/tests/test_windows_source_snapshot.py +69 -0
  66. netconverter_cli-0.8.0/tests/test_windows_submission_journal.py +212 -0
  67. netconverter_cli-0.7.3/docs/connect/chatgpt.md +0 -63
  68. netconverter_cli-0.7.3/src/netconverter_cli/api.py +0 -320
  69. netconverter_cli-0.7.3/src/netconverter_cli/backend.py +0 -124
  70. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/.gitignore +0 -0
  71. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/LICENSE +0 -0
  72. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/SECURITY.md +0 -0
  73. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/VERIFICATION.md +0 -0
  74. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-ai.md +0 -0
  75. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-code.md +0 -0
  76. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/claude-desktop.md +0 -0
  77. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/compatibility.md +0 -0
  78. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/openclaw.md +0 -0
  79. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/connect/other-assistants.md +0 -0
  80. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/docs/guided-workflows.md +0 -0
  81. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/examples/README.md +0 -0
  82. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/activity.py +0 -0
  83. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/branding.py +0 -0
  84. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/commands.py +0 -0
  85. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/connect_openclaw.py +0 -0
  86. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/design_catalog.py +0 -0
  87. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/diagrams.py +0 -0
  88. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/draft_cli.py +0 -0
  89. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/drafts.py +0 -0
  90. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/errors.py +0 -0
  91. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided.py +0 -0
  92. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided_operations.json +0 -0
  93. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/guided_projects.json +0 -0
  94. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/job_options.py +0 -0
  95. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/license.py +0 -0
  96. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/mcp_workflows.py +0 -0
  97. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/one_shot.py +0 -0
  98. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/palette.py +0 -0
  99. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/presentation.py +0 -0
  100. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy.py +0 -0
  101. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy_apply.py +0 -0
  102. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/privacy_cli.py +0 -0
  103. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/project_cli.py +0 -0
  104. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/projects.py +0 -0
  105. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/providers.py +0 -0
  106. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/remote_mcp.py +0 -0
  107. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/setup.py +0 -0
  108. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/summary.py +0 -0
  109. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/tui.py +0 -0
  110. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/src/netconverter_cli/walkthrough.py +0 -0
  111. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/opt_4056e02e5b66.json +0 -0
  112. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/tra_4058ef406cd6.json +0 -0
  113. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/tra_running.json +0 -0
  114. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/val_9f9acb9b5a59.json +0 -0
  115. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/fixtures/jobs/val_9f9acb9b5a59.sarif +0 -0
  116. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_autodetect_v5.py +0 -0
  117. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_boundaries.py +0 -0
  118. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_bridge_polish_021.py +0 -0
  119. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk.py +0 -0
  120. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_clerk_host_binding.py +0 -0
  121. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_cli_020.py +0 -0
  122. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_030.py +0 -0
  123. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_031.py +0 -0
  124. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_compat_014.py +0 -0
  125. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_direct_entry.py +0 -0
  126. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_connect_openclaw_014.py +0 -0
  127. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_credential_file_010.py +0 -0
  128. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_diagrams.py +0 -0
  129. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_download_analysis.py +0 -0
  130. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_cli.py +0 -0
  131. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_draft_jobs.py +0 -0
  132. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_drafts.py +0 -0
  133. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_errors_009.py +0 -0
  134. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_exposure_levels_013.py +0 -0
  135. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_folders_cd_ls.py +0 -0
  136. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_full_api_019.py +0 -0
  137. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_mapping_012.py +0 -0
  138. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_guided_prescan_037.py +0 -0
  139. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_help_008.py +0 -0
  140. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_inline.py +0 -0
  141. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_keyring_timeout_010.py +0 -0
  142. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_license.py +0 -0
  143. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_auth_016.py +0 -0
  144. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_jobs.py +0 -0
  145. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_mcp_workflows.py +0 -0
  146. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_options_011_019.py +0 -0
  147. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_polish_028.py +0 -0
  148. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_presentation.py +0 -0
  149. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_privacy_apply_013.py +0 -0
  150. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_privacy_cli_013.py +0 -0
  151. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_projects.py +0 -0
  152. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_protocols.py +0 -0
  153. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_readonly_workspace.py +0 -0
  154. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_sessions.py +0 -0
  155. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_setup.py +0 -0
  156. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_signin_default.py +0 -0
  157. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_stage_029.py +0 -0
  158. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_strict_default_011.py +0 -0
  159. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_strict_view_015.py +0 -0
  160. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_summary_007.py +0 -0
  161. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_update.py +0 -0
  162. {netconverter_cli-0.7.3 → netconverter_cli-0.8.0}/tests/test_walkthrough.py +0 -0
  163. {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.7.3
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/netconverter_terminals
7
- Project-URL: Documentation, https://github.com/valeronlabs/netconverter_terminals/blob/main/QUICK_START.md
8
- Project-URL: Issues, https://github.com/valeronlabs/netconverter_terminals/issues
9
- Project-URL: Changelog, https://github.com/valeronlabs/netconverter_terminals/blob/main/CHANGELOG.md
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 — and let your own AI assistant do it too, without the configuration ever passing through the model.**
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.7.3 ● Server ◆ Bridge claude-code · 2m ago
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. The AI sees paths, job IDs and summaries — never the configuration. |
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/netconverter_terminals/releases/latest),
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
- mkdir -p ~/NetConverter-Demo && cd ~/NetConverter-Demo
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
- The folder you start in is the workspace. Nothing is uploaded when the app opens.
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 — and let your own AI assistant do it too, without the configuration ever passing through the model.**
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.7.3 ● Server ◆ Bridge claude-code · 2m ago
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. The AI sees paths, job IDs and summaries — never the configuration. |
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/netconverter_terminals` from the
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 (`list_operations`, `submit_conversion` …) missing | They need exposure level `full` (`netconverter privacy level full`, then reconnect the assistant); the two write tools also need the tenant to have them enabled. `account` → `guided_migration` says which |
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.