@appland/appmap 3.140.1 → 3.141.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+# [@appland/appmap-v3.141.0](https://github.com/getappmap/appmap-js/compare/@appland/appmap-v3.140.1...@appland/appmap-v3.141.0) (2024-05-10)
+
+
+### Bug Fixes
+
+* Don't yield absolute paths from listProjectFiles ([7f76bf9](https://github.com/getappmap/appmap-js/commit/7f76bf982db474c8672976df659c381c3b633dc2))
+* Handle multiple -d options to rpc command ([81c88c2](https://github.com/getappmap/appmap-js/commit/81c88c27050330870dd09bb7a2959cc47a498ed6))
+* Prevent SIGPIPE in large projects ([a13b628](https://github.com/getappmap/appmap-js/commit/a13b628e4b4669999d61212c474f08c268e4d2c9))
+* Query keywords now additionally split on underscore ([b7fceb3](https://github.com/getappmap/appmap-js/commit/b7fceb327029b7c9232f044c34ecac9486d00009))
+
+
+### Features
+
+* Include static symbol names in file terms ([320bba5](https://github.com/getappmap/appmap-js/commit/320bba5e0221ebf703a029671c60b262249563ef))
+* Index directory files in batches ([dd662fd](https://github.com/getappmap/appmap-js/commit/dd662fd6f098499c346696747640862420427073))
+
 # [@appland/appmap-v3.140.1](https://github.com/getappmap/appmap-js/compare/@appland/appmap-v3.140.0...@appland/appmap-v3.140.1) (2024-05-03)
 
 

package/built/cmds/index/index.js

@@ -109,7 +109,7 @@ const handler = async (argv) => {
             };
             const buildRemoteNavie = (threadId, contextProvider, projectInfoProvider, helpProvider) => new navie_remote_1.default(threadId, contextProvider, projectInfoProvider, helpProvider);
             const navieProvider = useLocalNavie() ? buildLocalNavie : buildRemoteNavie;
-            (0, handleWorkingDirectory_1.configureRpcDirectories)([process.cwd()]);
+            await (0, handleWorkingDirectory_1.configureRpcDirectories)([process.cwd()]);
             const rpcMethods = [
                 (0, numProcessed_1.numProcessed)(cmd),
                 (0, search_1.search)(),

package/built/cmds/index/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmds/index/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmds/index/index.ts"],"names":[],"mappings":"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"}

package/built/cmds/index/rpc.js

@@ -142,7 +142,8 @@ const handler = async (argv) => {
         return navie;
     };
     const navieProvider = useLocalNavie() ? buildLocalNavie : buildRemoteNavie;
-    (0, handleWorkingDirectory_1.configureRpcDirectories)(directories);
+    (0, client_1.loadConfiguration)(false);
+    await (0, handleWorkingDirectory_1.configureRpcDirectories)(directories);
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const rpcMethods = [
         (0, search_1.search)(),

package/built/cmds/index/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/cmds/index/rpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/cmds/index/rpc.ts"],"names":[],"mappings":"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"}

package/built/docs/appmap-docs.md

@@ -0,0 +1,27 @@
+---
+layout: docs
+toc: true
+title: Docs - AppMap Docs
+description: "Explore AppMap, and AppMap Navie AI, an open-source code analysis and AI assistant that capturing code execution traces as interactive diagrams and powers runtime context for AI code generation."
+redirect_from: [/docs, /docs/faq, /docs/appmap-overview]
+
+---
+# AppMap Docs
+
+AppMap is a developer tools platform powered by runtime analysis and AI. It's composed of three components:
+
+* Navie - AI code architect.  
+* AppMap data - Runtime traces of your application runtime.  
+* AppMap diagrams - Interactive visualizations of AppMap data.  
+
+By using AppMap data, Navie is the first AI code architect with the context to understand how your app works when it runs, like a principal engineer or software architect. AppMap data provides Navie with accurate information about application behavior, APIs, database queries, and more, providing valuable context so you can ask more challenging questions and get better answers.
+
+Over 90,000 software developers are using the [AppMap extension for VSCode](https://marketplace.visualstudio.com/items?itemName=appland.appmap) and the [AppMap plugin for JetBrains](https://plugins.jetbrains.com/plugin/16701-appmap).
+
+<a class="btn btn-primary btn-lg" href="/docs/get-started-with-appmap/">Get Started with AppMap</a>
+
+{% include docs/app_framework_logos.html %}
+
+![Getting started screenshot](/assets/img/docs/dependency-map-example.webp)
+_AppMap dependency map in Visual Studio Code_
+

package/built/docs/get-started-with-appmap/add-appmap-to-your-code-editor.md

@@ -0,0 +1,98 @@
+---
+layout: docs
+setup-appmap-ide: true
+title: Docs - Getting Started with AppMap
+description: "Integrate AppMap into your Code Editor easily with AppMap for Visual Studio Code and JetBrains IDEs."
+step: 1
+name: Add AppMap to your Code Editor
+redirect_from: [/docs/add-appmap-to-a-project/, /docs/install-appmap-agent, /docs/quickstart, /docs/quickstart/index.html,/docs/setup-appmap-in-your-code-editor/add-appmap-to-your-code-editor]
+---
+
+# Add AppMap to your Code Editor
+
+- [AppMap for Visual Studio Code](#appmap-for-visual-studio-code)
+  - [Activate AppMap in Visual Studio Code](#activate-appmap-in-visual-studio-code)
+- [AppMap for JetBrains IDEs](#appmap-for-jetbrains-ides)
+  - [Activate AppMap in JetBrains IDEs](#activate-appmap-in-jetbrains-ides)
+- [Keep your extension up to date](#keep-your-extension-up-to-date)
+  - [Update AppMap for Visual Studio Code](#update-appmap-for-visual-studio-code)
+  - [Update AppMap for JetBrains code editors](#update-appmap-for-jetbrains-code-editors)
+- [Next Steps](#next-steps)
+  
+## AppMap for Visual Studio Code
+
+The AppMap extension is listed on the <a href="https://marketplace.visualstudio.com/items?itemName=appland.appmap" target="_blank">Visual Studio Code Marketplace</a>.
+
+<img title="AppMap available in Visual Studio Code" class="inline-partial-screenshot" src="/assets/img/docs/vscode-marketplace-tab-in-IDE.png">
+
+1. Open extensions from the sidebar in Visual Studio Code
+2. Type 'AppMap' into the search bar
+3. Click to install
+
+<a class="btn btn-dark btn-with-inline-img" href="https://marketplace.visualstudio.com/items?itemName=appland.appmap">
+    <img class="inline-button-img" src="/assets/img/vscode-icon.svg">
+    Install from the VS Code Marketplace
+</a>
+
+### Activate AppMap in Visual Studio Code
+
+After installing and opening the extension, you will need to first activate AppMap with your email address or with your GitHub or GitLab account.  Activating AppMap only generates a valid license key associated with your account and does NOT send any of your source code or sensitive data to AppMap systems.  For more information refer to the [AppMap Security FAQ](/security).
+
+<div class="alert alert-info">If you do not see an option to <b>Activate AppMap</b>, upgrade to the <a href="https://marketplace.visualstudio.com/items?itemName=appland.appmap">latest version </a>of the AppMap extension.</div>
+
+<img title="Activate AppMap in VS Code" class="inline-partial-screenshot" src="/assets/img/docs/activate-vscode.webp">
+
+## AppMap for JetBrains IDEs
+
+The AppMap plugin has official support for **IntelliJ**, **PyCharm**, and **RubyMine** listed on the <a href="https://plugins.jetbrains.com/plugin/16701-appmap" target="_blank">JetBrains Marketplace</a>.
+
+<img title="AppMap available in JetBrains IDE" class="inline-partial-screenshot" src="/assets/img/docs/jetbrains-marketplace-tab-in-IDE.webp">
+
+1. Start your JetBrains IDE and open Preferences
+2. Open Plugins, then click on Marketplace
+3. Search for AppMap, select and install AppMap
+
+<a class="btn btn-dark btn-with-inline-img" href="https://plugins.jetbrains.com/plugin/16701-appmap">
+    <img class="inline-button-img" src="/assets/img/jetbrains.svg">
+     Install from the JetBrains Marketplace
+</a>
+
+### Activate AppMap in JetBrains IDEs
+
+After installing and opening the extension, you will need to first activate AppMap with your email address or with your GitHub or GitLab account.  Activating AppMap only generates a valid license key associated with your account and does NOT send any of your source code or sensitive data to AppMap systems.  For more information refer to the [AppMap Security FAQ](/security).
+
+<div class="alert alert-info">If you do not see an option to <b>Activate AppMap</b>, upgrade to the <a href="https://plugins.jetbrains.com/plugin/16701-appmap">latest version</a> of the AppMap plugin.</div>
+
+<img title="AppMap available in JetBrains IDE" class="inline-partial-screenshot" src="/assets/img/docs/activate-jetbrains.webp">
+
+## Keep your extension up to date
+
+New development happens fast at AppMap. Keep your extension up to date to take advantage of new features.
+
+### Update AppMap for Visual Studio Code 
+
+<p class="alert alert-info">To get access to <a href="https://appmap.io/product/appmap-navie">AppMap Navie</a> you need to be running AppMap VS Code Plugin version >= 0.118.1</p>
+
+To update AppMap for Visual Studio Code navigate to the extensions tab > installed. Select 'AppMap' from your installed extensions and click the update button.
+
+Alternatively you can update to the latest AppMap software release on the [the VS Code Marketplace.](https://marketplace.visualstudio.com/items?itemName=appland.appmap) 
+
+<image class="video-screenshot" src="/assets/img/docs/update-appmap-for-visual-studio-code.webp"/> 
+
+**NOTE**: Make sure to either reload the extension, or reload/restart VS Code after updating the plugin.
+
+### Update AppMap for JetBrains code editors
+
+<p class="alert alert-info">To get access to <a href="https://appmap.io/product/appmap-navie">AppMap Navie</a> you need to be running AppMap JetBrains Plugin version >= 0.64.0</p>
+
+To update AppMap for JetBrains code editor open the Settings window and select Plugins. Select 'AppMap' from your installed extensions and click the update button.
+
+Alternatively you can update to the latest AppMap software release on the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/16701-appmap)
+
+<image class="video-screenshot" src="/assets/img/docs/update-appmap-for-intellij.webp"/> 
+
+**NOTE**: Make sure to either reload the extension, or reload/restart JetBrains after updating the plugin.
+
+## Next Steps
+
+After installing the AppMap plugin for your code editor, Open the [Navie AI Quickstart](/docs/get-started-with-appmap/navie-ai-quickstart) and ask questions about your application.

package/built/docs/get-started-with-appmap/index.md

@@ -0,0 +1,20 @@
+---
+layout: docs
+title: Docs - AppMap in your Code Editor
+description: "Learn to set up and navigate AppMap in your code editor efficiently. Explore features like generating AppMap Data from tests and remote recording."
+toc: true
+redirect_from: [/docs/your-first-15-minutes-with-appmap/, /docs/code-editor-extensions/,/docs/code-editor-extensions/appmap-for-vs-code, /docs/code-editor-extensions/appmap-for-jetbrains,/docs/setup-appmap-in-your-code-editor/index.html]
+---
+
+# Get Started with AppMap
+
+<p class="alert alert-info">
+If at any point you would like some help, <a href="/slack">join us in Slack</a>!
+You'll find the AppMap team there, along with other AppMap users.
+</p>
+
+### Step 1: [Add AppMap to your Code Editor](/docs/get-started-with-appmap/add-appmap-to-your-code-editor)
+
+### Step 2: [Ask Navie AI a Question](/docs/get-started-with-appmap/navie-ai-quickstart)
+
+### Step 3: [Make AppMap Data and Improve Navie's Responses](/docs/get-started-with-appmap/making-appmap-data)

package/built/docs/get-started-with-appmap/making-appmap-data.md

@@ -0,0 +1,151 @@
+---
+layout: docs
+title: Docs - Getting Started with AppMap
+description: "Automatically generate AppMap Data from tests or from application interactions and improve the quality of responses from Navie AI"
+name: Making AppMap Data
+setup-appmap-ide: true
+toc: true
+step: 3
+redirect_from: [/docs/recording-methods,/docs/your-first-15-minutes-with-appmap/generate-appmaps-with-tests, /docs/quickstart/intellij/step-3, /docs/quickstart/pycharm/step-3, /docs/quickstart/vscode/javascript-step-3.html, /docs/quickstart/rubymine/step-3, /docs/quickstart/vscode/python-step-3, /docs/quickstart/vscode/ruby-step-3, /docs/quickstart/vscode/java-step-3, ./reference/remote-recording.html, /docs/quickstart/vscode/step-2, /docs/diagrams/quickstart/vscode/ruby-step-3-tests, /docs/quickstart/vscode/java-step-3.html, /docs/quickstart/vscode/python-step-3.html, /docs/quickstart/vscode/ruby-step-3.html, /docs/quickstart/webstorm/step-3, /docs/diagrams/quickstart/vscode/java-step-3-tests, /docs/diagrams/quickstart/vscode/javascript-step-3-tests, /docs/diagrams/quickstart/vscode/python-step-3-tests, /docs/diagrams/quickstart/vscode/ruby-step-3-tests, /docs/diagrams/quickstart/intellij/step-3-tests, /docs/diagrams/quickstart/webstorm/step-3-tests, /docs/diagrams/quickstart/pycharm/step-3-tests, /docs/diagrams/quickstart/rubymine/step-3-tests, /docs/setup-appmap-in-your-code-editor/generate-appmaps-from-tests, /docs/setup-appmap-in-your-code-editor/generate-appmap-data-from-tests, /docs/your-first-15-minutes-with-appmap/generate-appmaps-with-remote-recording, /docs/setup-appmap-in-your-code-editor/generate-appmaps-with-remote-recording, /docs/setup-appmap-in-your-code-editor/generate-appmap-data-with-remote-recording, /docs/your-first-15-minutes-with-appmap/streaming-appmaps-with-request-recording, /docs/setup-appmap-in-your-code-editor/generate-appmaps-with-request-recording, /docs/setup-appmap-in-your-code-editor/generate-appmap-data-with-request-recording]
+---
+
+# Making AppMap Data
+
+You can improve the quality and accuracy of Navie AI by making AppMap Data for your project.  Learn more about AppMap Data and how to make AppMap data by running your test cases or interacting with your application. 
+
+- [With Test Case Recording](#with-test-case-recording)
+- [With API Request Recording](#with-api-request-recording)
+- [With Remote Application Recording](#with-remote-application-recording)
+- [With Code Block Recording](#with-code-block-recording)
+- [With Process Recording](#with-process-recording)
+
+
+### How AppMap Data Works <!-- omit in toc -->
+
+### Language “agent” <!-- omit in toc -->
+
+The AppMap process begins with the AppMap recording agent. This “agent” is a language-specific library - agents are available for Java, Python, Ruby and Node.js (Beta). You add the agent as a dependency of your project in the normal manner - via Maven, Gradle, Pip, Bundler, Yarn, etc. Then you configure your application to load the agent when the application runs. 
+
+<table class="table table-striped table-bordered">
+    <tr>
+        <th>Java</th>
+        <th>Python</th>
+        <th>Ruby</th>
+        <th>Node.js</th>
+    </tr>
+    <tr>
+        <td><code>-javaagent</code> JVM option </td>
+        <td>Django environment </td>
+        <td><code>test</code> and/or <code>development</code> bundle</td>
+        <td><code>npx appmap-node <i>yourapp</i></code></td> 
+    </tr>
+    <tr>
+        <td>Gradle plugin</td>
+        <td>Flask environment </td>
+        <td></td>
+        <td></td> 
+    </tr>
+        <tr>
+        <td>Maven plugin</td>
+        <td>FastAPI environment</td>
+        <td></td>
+        <td></td> 
+    </tr>
+</table>
+
+AppMap is designed primarily to record _full details of your code_, including _parameters and return values_, as well as _I/O_ (especially _SQL_ and _HTTP client requests_), it includes _log statements_, the _execution stack_, _timing information_, and _exceptions_. It captures all of this with minimal configuration. It’s designed primarily for non-production environments.
+
+### appmap.yml configuration <!-- omit in toc -->
+When you start your app with the AppMap agent enabled, it reads a configuration file called appmap.yml. This file serves several basic purposes. It tells the AppMap agent:
+
+* Which code to record
+* Where to write the AppMap Data.
+
+And it also tells other AppMap tools:
+* The project name
+* The language name
+* Where the AppMap Data is located
+
+**Note:** In most environments, a default appmap.yml will be auto-generated by the AppMap agent if none exists.
+
+#### About AppMap Data <!-- omit in toc -->
+AppMap Data is ordinary JSON files. As you record AppMap Data with test case recording, requests recording, or process recording, these JSON files are generated and written to the filesystem. The default location for AppMap Data is `tmp/appmap`, relative to the process working directory. Be sure that you know that the working directory of the application server is! You’ll need to know this to find and open your AppMap Diagrams.
+
+When you use remote recording, the HTTP “stop” command responds with the AppMap in the response payload. It’s up to the client to decide where to write the file. For example, you can start and stop a remote recording using cURL, and write the output of the “stop” command to a file of your choosing. 
+
+When you use code block recording, it’s up to you in your code snippet to write the AppMap to a file. Naturally, you can direct the data anywhere you please.
+
+AppMap files conform to the [AppMap specification](https://github.com/getappmap/appmap), which is freely available on GitHub. 
+
+## With Test Case Recording
+AppMap provides specialized support for recording test cases. When you run your test cases in a supported framework (there are many - see the [language agent reference](/docs/reference) for details), a separate AppMap Diagram is created for each test case. AppMap Diagrams created from tests cases have some distinct features:
+
+* Each AppMap file is named for the test case, and stored in a folder called `$appmap_dir/$test_framework`
+* The test framework name and version are stored in the AppMap.
+* The test case name, file name and line number are stored in the AppMap.
+* The test status (`succeeded` or `failed`) and any test failure message are stored in the AppMap.
+
+Recording the test suite of an application is a good way to quickly obtain a lot of data about an application. And because test cases work the same way for each build, recording test cases is also a good way to compare the behavior of application code across versions.
+
+AppMap integrates with popular test frameworks, so you can automatically record an AppMap from each test case that you run.
+
+Some benefits of test case recording include:
+
+* **Named for the test case** The name of each AppMap corresponds to the name of the test.
+* **Includes source location** The AppMap metadata contains the path and line number of the test case. From the AppMap Diagram, you can navigate to the test case code.
+* **Supports incremental testing** AppMap's dependency analysis capability can help you re-run out-of-date test cases as you modify the code - even in very large repositories.
+
+For details on test case recording, see:
+
+* [Tests recording - Ruby](/docs/reference/appmap-ruby#tests-recording)
+* [Tests recording - Python](/docs/reference/appmap-python#tests-recording)
+* [Tests recording - Java](/docs/reference/appmap-java#tests-recording)
+* [Tests recording - Node.js](/docs/reference/appmap-node#tests-recording)
+
+## With API Request Recording
+For web applications, AppMap can be configured to record an AppMap for each HTTP server request handled by the app. This is a great way to collect data interactively. Just start the application with the AppMap language agent enabled, and start interacting with the app - manually, or using QA scripts or an API testing tool like Postman. AppMap Data is generated continuously as the application handles requests.
+
+You can configure your application to record an AppMap of each HTTP server request.
+
+Some characteristics of request recording include:
+
+* **Named for the route** The name of each AppMap contains the HTTP request method and path, so you can see at a glance what request AppMap contains.
+* **Sortable by timestamp** In the AppMap extension, AppMap Data recorded from requests are sorted by timestamp, with newest AppMap Diagrams at the top. So you can see a chronology of the requests that your app is serving.
+
+For details on requests recording, see:
+
+* [Requests recording - Ruby](/docs/reference/appmap-ruby#requests-recording)
+* [Requests recording - Python](/docs/reference/appmap-python#requests-recording)
+* [Requests recording - Java](/docs/reference/appmap-java#requests-recording)
+* [Requests recording - Node.js](/docs/reference/appmap-node#request-recording)
+
+## With Remote Application Recording
+Remote recording is similar to requests recording, in that:
+* It’s for web applications
+* It makes AppMap Data as the application handles requests
+
+But unlike requests recording, you control the boundaries of the AppMap, each AppMap can contain more than one HTTP server request, and it will also contain non-HTTP activity such as background jobs. To start a remote recording, you send an HTTP command to the AppMap agent running inside your application’s web stack to start recording. From that point on, everything that happens inside the application is recorded, until you send the “stop” command.
+
+Remote recording enables you to create an AppMap while interacting directly with your app through the UI or API.
+
+Some benefits of remote recording include:
+
+* **Named by you** When you finish creating a remote recording, you give it a name that makes sense to you. For example, you can name it for the user flow, or the ID number of the issue that you are trying to reproduce.
+* **Contains a sequence of requests** A remote recording AppMap contains the entire sequence of HTTP server requests that occur as you use the application.
+* **Contains both foreground and background work** A remote recording AppMap contains all threads of execution, not just the web server. So you can see background jobs, message queue activity, and other threads of activity along with the main HTTP server request.
+* **Ideal for sharing** When you reproduce a bug, security vulnerability, or performance problem in a remote recording AppMap, you can share it with colleagues so they can see exactly what the problem is. An AppMap contains much more information than the source code itself.
+
+For details on remote recording, see:
+
+* [Remote recording - Ruby](/docs/reference/appmap-ruby#remote-recording)
+* [Remote recording - Python](/docs/reference/appmap-python#remote-recording)
+* [Remote recording - Java (JetBrains)](/docs/reference/jetbrains#running-a-java-application-with-appmap)
+* [Remote recording - Java (VS Code)](/docs/reference/vscode#remote-recording)
+* [Remote recording - Java (command line)](/docs/reference/appmap-java#remote-recording)
+* [Remote recording - Node.js](/docs/reference/appmap-node#remote-recording)
+
+## With Code Block Recording
+Some language agents enable you to make an AppMap by adding a simple code snippet to your code. This gives you total control over what’s recorded. The only downside of this is that you need access to the source code - which is not required by other recording methods. Refer to the [AppMap Reference Guide](/docs/reference/) for language specific configuration of this recording option. 
+
+## With Process Recording
+Process recording is something of a last resort, when other recording methods aren’t available. When you run your application with process recording enabled, _everything_ that happens in the code (as configured by the appmap.yml) is recorded, from process startup to shutdown.  Refer to the [AppMap Reference Guide](/docs/reference/) for language specific configuration of this recording option. 

package/built/docs/get-started-with-appmap/navie-ai-quickstart.md

@@ -0,0 +1,73 @@
+---
+layout: docs
+setup-appmap-ide: true
+title: Docs - AppMap in your Code Editor
+description: "Learn how AppMap Navie AI works: Ask Navie architectural level questions about your code and use AppMap Data as"
+step: 2
+name: Navie AI Quickstart
+redirect_from: [/docs/setup-appmap-in-your-code-editor/navie-ai-quickstart]
+---
+
+# AppMap Navie AI Quickstart
+
+- [Open AppMap Navie AI](#open-appmap-navie-ai)
+- [Ask Navie about your App](#ask-navie-about-your-app)
+- [Improve Navie AI Responses with AppMap Data](#improve-navie-ai-responses-with-appmap-data)
+- [Next Steps](#next-steps)
+
+## Open AppMap Navie AI
+
+After you complete the installation of AppMap for your code editor. Open the Navie Chat Window to ask Navie about your application. 
+
+To open the Navie Chat, open the AppMap plugin in the sidebar menu for your code editor, and select the `New Navie Chat` option.
+
+![Open Navie](/assets/img/open-navie.webp)
+
+## Ask Navie about your App
+
+You can ask questions about your application with Navie immediately after installing the plugin.  AppMap Data is not required but Navie only has partial information about your project and the answers will not include any runtime specific information. 
+
+By default, Navie will utilize an OpenAI service hosted by AppMap. If, for data privacy or other reasons, you are do not wish to use the AppMap OpenAI proxy, you can [bring your own OpenAI API key](/docs/navie/bring-your-own-model.html#bring-your-own-openai-api-key-byok), or use an [entirely different AI Model](/docs/navie/bring-your-own-model.html#ollama), hosted in your environment or hosted locally.
+
+When you ask a question to Navie, it will search through all your AppMap Diagrams (if they exist) for your project to pull in relevant traces, sequence diagrams, and code snippets for analysis. It will then send these code snippets and runtime code sequence diagrams to the Generative AI service along with your question. 
+
+You can ask free-form questions, or start your question with one of these commands:
+
+- `@explain`: (Default) Help you understand your project. This mode is used when there is no prefix.
+- `@help`: Get assistance with configuring and using AppMap.
+- `@generate`: Optimizes the answer to focus on new code generation.
+
+After asking Navie a question, Navie will search through your application source code, finding any relevant code snippets. It will include relevant AppMap Data like sequence diagrams and data flows if they exist for your project. You will see on the right hand side of the Navie window the relevant context from your code included with the question. 
+
+The Navie UI includes a standard chat window, and a context panel which will include all the context that is included in the query to the AI provider.  This context can include things such as:
+
+**Always available:**  
+- Code Snippets
+
+**If AppMap Data exists:**  
+- Sequence Diagrams
+- HTTP Requests
+- SQL Queries
+- Other I/O Data
+
+![Navie Context Window](/assets/img/navie-context-window.webp)
+
+## Improve Navie AI Responses with AppMap Data
+
+Generate AppMap Data and you will greatly improve the quality of your Navie AI responses. With AppMap Data for your project, you can now ask much deeper architectural questions about your application. This is possible because of the additional context from AppMap Data and the higher accuracy and relevance of the code snippets which are relevant to your question. 
+
+View the [Navie AI examples page](/product/examples/navie) to see some examples of Navie fixing complex architectural issues, performance issues, and adding new features to your application.
+
+After your AppMap Data is generated, the Navie window will indicate the AppMap Data that exists for your project. 
+
+![Navie AppMap Data Exists](/assets/img/navie-appmap-data-exists.webp)
+
+With this AppMap Data in your project, asking questions to Navie will now include data flows, sequence diagrams, traces, in addition to the relevant code snippets for the project. 
+
+![Navie AppMap context window 2](/assets/img/navie-appmap-context-window.webp)
+
+## Next Steps
+
+Continue to ask questions to Navie, creating new code for your application, and continue to generate additional AppMap Data as your code changes.  On each subsequent question asked, Navie will re-query your AppMap Data, traces, data flows, and source code for your project to power the context for the answer. 
+
+[Learn more about making AppMap Data to improve Navie response accuracy](/docs/get-started-with-appmap/making-appmap-data)

package/built/docs/guides/exporting-appmap-diagrams.md

@@ -4,7 +4,7 @@ title: Docs - Guides
 description: "Learn how to export your AppMap Diagrams into raw JSON format, SVG formats, and into 3rd party documentation tools like Confluence"
 guides: true
 name: Exporting AppMap Diagrams
-step: 2`
+step: 4
 ---
 
 # Exporting AppMap Diagrams <!-- omit in toc -->

package/built/docs/guides/handling-large-appmap-diagrams.md

@@ -4,7 +4,7 @@ title: Docs - Guides
 description: "Learn how to manage large AppMap Diagrams effectively. Discover tips to handle AppMap Data over 10 MB and 200 MB in size, focusing on optimizing AppMap Data for better interpretation and performance."
 guides: true
 name: Handling Large AppMap Diagrams
-step: 3
+step: 4
 redirect_from: [/docs/reference/handling-large-appmaps, /docs/guides/handling-large-appmaps]
 ---
 

package/built/docs/guides/index.md

@@ -9,12 +9,14 @@ step: 1
 
 These guide contain in-depth information on how to use AppMap for different use cases and scenarios.
 
+- [Navie Best Practices](/docs/guides/navie-best-practices)
 - [Using AppMap Diagrams](/docs/guides/using-appmap-diagrams)
+- [Navigating Code Objects](/docs/guides/navigating-code-objects)
 - [Exporting AppMap Diagrams](/docs/guides/exporting-appmap-diagrams)
 - [Handling Large AppMap Diagrams](/docs/guides/handling-large-appmap-diagrams)
 - [Reading SQL in AppMap Diagrams](/docs/guides/reading-sql-in-appmap-diagrams)
 - [Refining AppMap Data](/docs/guides/refine-appmap-data)
 - [Generating OpenAPI Definitions](/docs/guides/openapi)
-- [Configuring Analysis](/docs/guides/configuring-analysis)
+- [Using AppMap Analysis](/docs/guides/using-appmap-analysis)
 - [Reverse Engineering with AppMap](/docs/guides/reverse-engineering)
 - [Understanding the Runtime Code Review Report](/docs/guides/runtime-code-review)

package/built/docs/{navie/using-navie.md → guides/navie-best-practices.md}

@@ -1,16 +1,14 @@
 ---
 layout: docs
-title: Docs - AppMap Navie AI
+title: Docs - Guides
 description: "Learn how to use AppMap Navie to provide personalized code analysis. Generate AppMap Data, ask Navie questions, analyze code, and iterate for optimal results."
-name: Using Navie
-step: 3
-toc: true
-navie: true
-toc: true
-redirect_from: [/docs/navie/how-to-use-navie]
+guides: true
+name: Navie Best Practices
+step: 1
+redirect_from: [/docs/navie/using-navie]
 ---
 
-# Using Navie
+# Navie Best Practices
 
 When you ask a question to Navie, it will search through all your AppMap Diagrams created for your project to pull in relevant traces, sequence diagrams, and code snippets for analysis.  It will then send these code snippets and runtime code sequence diagrams to the Generative AI service along with your question.  By sending this valuable context to the AI interface, your answers will be much more personal and specific to your codebase, files, and functions. Additionally, the Generative AI will be able to understand how your code works at runtime and will be able to make architectural level recommendations across your entire application. 
 
@@ -23,15 +21,15 @@ To generate the highest quality responses from Navie, we recommend the following
 
 ## Create AppMap Data
 
-We recommend creating maps that are most relevant to the question or area of the application you are going to be working with. For example, if i wanted to understand how my new user registration flow worked I could [create a remote recording](/docs/setup-appmap-in-your-code-editor/generate-appmap-data-with-remote-recording) of a new user registration flow. Alternatively, I could [run all the test cases](/docs/setup-appmap-in-your-code-editor/generate-appmap-data-from-tests) related to new user creation, registration, and adjacent areas. 
+We recommend creating maps that are most relevant to the question or area of the application you are going to be working with. For example, if i wanted to understand how my new user registration flow worked I could [create a remote recording](/docs/get-started-with-appmap/making-appmap-data.html#with-remote-application-recording) of a new user registration flow. Alternatively, I could [run all the test cases](/docs/get-started-with-appmap/making-appmap-data.html#with-test-case-recording) related to new user creation, registration, and adjacent areas. 
 
-Depending on your language and framework there [are up to 5 different ways](/docs/setup-appmap-in-your-code-editor/how-appmap-works.html#recording-methods) that you can record AppMap Diagrams for your application.
+Depending on your language and framework there [are up to 5 different ways](/docs/get-started-with-appmap/making-appmap-data) that you can record AppMap Diagrams for your application.
 
-1. **[Test Case Recording](/docs/setup-appmap-in-your-code-editor/generate-appmap-data-from-tests.html)**: This method is particularly useful for automated testing environments. AppMap integrates with numerous testing frameworks, creating individual AppMap Diagrams for each test case run. These AppMap Diagrams include detailed information such as the test framework, test case names, and their outcomes, enabling a comprehensive overview of test coverage and facilitating easier debugging and performance optimization.
+1. **[Test Case Recording](/docs/get-started-with-appmap/making-appmap-data.html#with-test-case-recording)**: This method is particularly useful for automated testing environments. AppMap integrates with numerous testing frameworks, creating individual AppMap Diagrams for each test case run. These AppMap Diagrams include detailed information such as the test framework, test case names, and their outcomes, enabling a comprehensive overview of test coverage and facilitating easier debugging and performance optimization.
 
-2. **[Requests Recording](/docs/setup-appmap-in-your-code-editor/generate-appmap-data-with-request-recording)**: Ideal for web applications, this method records each HTTP request processed by your application. By simply running your application with the AppMap agent and interacting with it—either manually or through automated scripts—you can generate a rich dataset of AppMap Diagrams that capture the full scope of your application's request handling.
+2. **[Requests Recording](/docs/get-started-with-appmap/making-appmap-data.html#with-api-request-recording)**: Ideal for web applications, this method records each HTTP request processed by your application. By simply running your application with the AppMap agent and interacting with it—either manually or through automated scripts—you can generate a rich dataset of AppMap Diagrams that capture the full scope of your application's request handling.
 
-3. **[Remote Recording](/docs/setup-appmap-in-your-code-editor/generate-appmap-data-with-remote-recording)**: Similar to request recording but offering more control over the recording session. You initiate and stop recording via HTTP commands, allowing the inclusion of multiple requests and other non-HTTP activities within a single AppMap. This method is particularly suited for capturing detailed interactions within web applications, including background jobs and other processes.
+3. **[Remote Recording](/docs/get-started-with-appmap/making-appmap-data.html#with-remote-application-recording)**: Similar to request recording but offering more control over the recording session. You initiate and stop recording via HTTP commands, allowing the inclusion of multiple requests and other non-HTTP activities within a single AppMap. This method is particularly suited for capturing detailed interactions within web applications, including background jobs and other processes.
 
 4. **Code Block Recording**: Provides the highest level of control, enabling you to specify exactly which blocks of code to record by inserting simple code snippets. This method requires source code access and is a powerful option for targeting specific functionalities or debugging complex issues. (Code Block recording is language specific, refer to [the language reference docs for examples](/docs/reference)).
 
@@ -43,6 +41,14 @@ Each of these methods generates AppMap Data in JSON format, which are then visua
 
 Navie, can address a wide range of questions about your application, extending beyond what static analysis AI assistants can provide, to understand dynamic interactions, dependencies, and performance bottlenecks to help your developers design and deliver solutions faster for a host of complex issues.
 
+If you are not able to use the AppMap OpenAI proxy, you can bring your own OpenAI API key, or use an entirely different AI Model, [hosted in your environment](/docs/navie/bring-your-own-model.html#azure-openai) or [hosted locally](/docs/navie/bring-your-own-model.html#ollama). 
+
+You can ask free formed questions, or start your question with one of these commands:
+
+- `@explain`: (Default) Navie will help you understand your project. This mode is used when there is no prefix.
+- `@help`: Navie will help you setup AppMap, including generating AppMap recordings and diagrams.
+- `@generate`: Navie will help you generate new code.
+
 **Examples of good questions to ask Navie.**
 
 * Why is `behavior X` happening in dev and not in production?
@@ -54,7 +60,7 @@ Navie, can address a wide range of questions about your application, extending b
 * Explain what functions or files are involved when a user logs into my service. 
 * Loading the "products" view page is slow in production, provide suggested guidance with relevant code changes I can make to improve the speed.
 
-## Write Code
+## Implement Generated Code
 
 Navie can do more than just provide code implementation details, you can talk to Navie about a variety of other topics as you are updating your application based on it's recommendations.