neatlogs-cli 0.1.0-team-test.6 → 0.1.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to `neatlogs-cli` are documented in this file.
 
 ## Unreleased
 
+## 0.1.0 (release candidate)
+
+- Prepare the first stable `neatlogs-cli` version under the MIT license.
+- Keep the `neatlogs` command and existing package name for compatibility.
+- Support separate US and EU host profiles with deployment-bound credentials.
+- Include read-oriented OAuth defaults, bounded login shutdown, current API
+  contracts and safe request-ID diagnostics from the retest repairs.
+- Publication and deployed end-to-end acceptance remain release requirements.
+
+## 0.1.0-team-test.7 (unpublished; superseded by 0.1.0)
+
+- Include the merged fresh-start fixes: read-only default OAuth scopes and
+  field-specific guidance for required analytics dates and other arguments.
+- Refresh the embedded Public API contract for detection issue semantics
+  returned by the current dev backend.
+- Preserve safe server request IDs and operation paths when a response fails
+  JSON decoding or strict contract validation, without exposing response bodies.
+
 ## 0.1.0-team-test.6
 
 - Close unused browser callback connections so OAuth login, denial, and timeout
@@ -52,7 +70,3 @@ All notable changes to `neatlogs-cli` are documented in this file.
 ## 0.1.0-team-test.1
 
 - Team-testing prerelease of the NeatLogs public API CLI.
-
-## 0.1.0
-
-- Initial public release of the NeatLogs public API CLI.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NeatLogs contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -34,14 +34,21 @@ flowchart LR
 
 ## Human quickstart
 
+The stable release candidate in this checkout is `neatlogs-cli@0.1.0`, under
+the MIT license in [LICENSE](LICENSE). It is not published by a source change.
+Verify `npm view neatlogs-cli@0.1.0 version` before using the stable install
+command; the currently published team-test release remains available through
+`npm install --global neatlogs-cli@team-test` until the reviewed release ships.
+
 1. Install the CLI and confirm that it runs.
 
    ```bash
-   npm install --global neatlogs-cli@team-test
+   npm install --global neatlogs-cli@0.1.0
    neatlogs --version
    ```
 
-   The current dev team-test release is `0.1.0-team-test.6`. Use Node.js 22 or
+   The stable candidate is `0.1.0`; publication must be independently verified.
+   Use Node.js 22 or
    24. The complete dev setup and verification flow is in the
    [team quickstart](../backend/docs/public-api/dev-team-quickstart.md).
 
@@ -79,6 +86,26 @@ flowchart LR
 `profile set` stores non-secret host and project preferences. Login stores the
 OAuth credentials separately in the native operating-system vault.
 
+## US and EU profiles
+
+One CLI package supports both regions. Use the dashboard origin, not the SDK
+ingest/backend URL, as the CLI host:
+
+```bash
+neatlogs profile set us --host '<us-dashboard-origin>'
+neatlogs profile set eu --host 'https://eu.app.neatlogs.com'
+neatlogs --profile eu auth login
+neatlogs --profile eu projects list
+neatlogs profile set eu --host 'https://eu.app.neatlogs.com' --project '<eu-project-uuid>'
+neatlogs --profile eu traces list --limit 10
+```
+
+The EU backend uses `https://eu.ingest.neatlogs.com`, but OAuth discovery and
+public API requests stay on `https://eu.app.neatlogs.com`. Sign in separately
+for each profile; US credentials do not authorize EU requests. Region support
+requires the frontend, backend, schema and runtime configuration to be deployed
+there first. See the [EU release preflight](../backend/docs/public-api/eu-release.md).
+
 ## Completion and bounded pagination
 
 Generate completion from the installed CLI command tree, then regenerate it
@@ -120,6 +147,10 @@ The consent page lists only the permissions requested by this login command.
 `offline_access` allows refresh tokens; it is not an API permission shown by
 `whoami`.
 
+Existing OAuth credentials retain their issued scopes after a CLI upgrade.
+Log out of the selected profile and sign in again to apply the stable release's
+read-oriented defaults; request write scopes explicitly when needed.
+
 ## Agent and CI automation
 
 In **Settings → Service Accounts**, create a dedicated account, bind only the