@appland/appmap 3.168.0 → 3.169.0

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 (49) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/built/docs/appmap-docs.md +1 -1
  3. package/built/docs/community.md +1 -1
  4. package/built/docs/get-started-with-appmap/index.md +1 -1
  5. package/built/docs/get-started-with-appmap/navie-ai-quickstart.md +6 -5
  6. package/built/docs/navie-reference/index.md +18 -0
  7. package/built/docs/navie-reference/navie-accessing-logs.md +42 -0
  8. package/built/docs/navie-reference/navie-bring-your-own-model-examples.md +202 -0
  9. package/built/docs/navie-reference/navie-commands.md +119 -0
  10. package/built/docs/navie-reference/navie-github-repository.md +12 -0
  11. package/built/docs/{using-navie-ai/how-navie-works.md → navie-reference/navie-how-it-works.md} +5 -4
  12. package/built/docs/navie-reference/navie-openai-key-management.md +83 -0
  13. package/built/docs/navie-reference/navie-options.md +87 -0
  14. package/built/docs/navie-reference/navie-pre-built-libraries-for-appmap-data.md +23 -0
  15. package/built/docs/navie-reference/navie-user-interface.md +32 -0
  16. package/built/docs/navie-reference.md +1 -0
  17. package/built/docs/reference/appmap-airgapped-install.md +293 -0
  18. package/built/docs/reference/appmap-client-cli.md +1 -1
  19. package/built/docs/reference/appmap-java.md +1 -1
  20. package/built/docs/reference/guides/exporting-appmap-diagrams.md +1 -0
  21. package/built/docs/reference/guides/handling-large-appmap-diagrams.md +1 -1
  22. package/built/docs/reference/guides/index.md +1 -0
  23. package/built/docs/reference/guides/navigating-code-objects.md +2 -2
  24. package/built/docs/reference/guides/openapi.md +1 -1
  25. package/built/docs/reference/guides/reading-sql-in-appmap-diagrams.md +1 -1
  26. package/built/docs/reference/guides/refine-appmap-data.md +1 -1
  27. package/built/docs/reference/guides/reverse-engineering.md +1 -0
  28. package/built/docs/reference/guides/using-appmap-analysis.md +1 -1
  29. package/built/docs/reference/guides/using-appmap-diagrams.md +2 -2
  30. package/built/docs/reference/index.md +3 -1
  31. package/built/docs/reference/integrations/atlassian-compass.md +1 -0
  32. package/built/docs/reference/integrations/atlassian-confluence.md +1 -0
  33. package/built/docs/reference/integrations/docker.md +1 -0
  34. package/built/docs/reference/integrations/index.md +1 -0
  35. package/built/docs/reference/integrations/mermaid.md +1 -0
  36. package/built/docs/reference/integrations/plantuml.md +1 -0
  37. package/built/docs/reference/integrations/postman.md +1 -0
  38. package/built/docs/reference/integrations/readme.md +1 -0
  39. package/built/docs/reference/integrations/smartbear-swaggerhub.md +2 -1
  40. package/built/docs/reference/uninstalling-appmap.md +1 -1
  41. package/built/docs/reference/vscode.md +1 -1
  42. package/built/docs/using-navie-ai/bring-your-own-model.md +38 -37
  43. package/built/docs/using-navie-ai/how-to-open-navie.md +5 -5
  44. package/built/docs/using-navie-ai/index.md +8 -7
  45. package/built/docs/using-navie-ai/using-navie.md +64 -75
  46. package/built/fulltext/FileIndex.js +0 -1
  47. package/built/fulltext/FileIndex.js.map +1 -1
  48. package/package.json +2 -2
  49. package/built/docs/reference/integrations/circle-ci.md +0 -425
@@ -5,6 +5,7 @@ description: "Generate, modify, and compare PlantUML sequence diagrams with AppM
5
5
  integrations: true
6
6
  name: PlantUML
7
7
  step: 3
8
+ redirect_from: [/docs/integrations/plantuml]
8
9
  ---
9
10
 
10
11
  # PlantUML
@@ -5,6 +5,7 @@ description: "Learn how to import your AppMap generated OpenAPI definitions into
5
5
  integrations: true
6
6
  name: Postman
7
7
  step: 4
8
+ redirect_from: [/docs/integrations/postman]
8
9
  ---
9
10
 
10
11
  # Postman
@@ -5,6 +5,7 @@ description: "Optimize your AppMap API interaction with Readme's developer hub.
5
5
  integrations: true
6
6
  name: Readme
7
7
  step: 6
8
+ redirect_from: [/docs/integrations/readme]
8
9
  ---
9
10
 
10
11
  # Readme
@@ -6,6 +6,7 @@ integrations: true
6
6
  name: SmartBear SwaggerHub
7
7
  render_with_liquid: false
8
8
  step: 5
9
+ redirect_from: [/docs/integrations/smartbear-swaggerhub]
9
10
  ---
10
11
 
11
12
  # SmartBear SwaggerHub and Portal
@@ -114,6 +115,6 @@ env:
114
115
 
115
116
  Refer to [this project on GitHub](https://github.com/land-of-apps/rails_tutorial_sample_app_7th_ed/blob/smartbear-api-comparison/.github/workflows/openapi-compare.yml) for a fully working example of this GitHub Action.
116
117
 
117
- With this configuratino enabled, when a user makes a commit which changes the routes that are NOT currently in the published API spec on SwaggerHub this build will fail and the user will be unable to deploy unless they update the API spec on SwaggerHub or remove the offending changes.
118
+ With this configuration enabled, when a user makes a commit which changes the routes that are NOT currently in the published API spec on SwaggerHub this build will fail and the user will be unable to deploy unless they update the API spec on SwaggerHub or remove the offending changes.
118
119
 
119
120
  <img class="video-screenshot" src="/assets/img/swaggerhub-github-build-failure.webp"/>
@@ -5,7 +5,7 @@ description: "Learn how to uninstall AppMap components like IDE plugins, librari
5
5
  toc: true
6
6
  reference: true
7
7
  name: Uninstalling AppMap
8
- step: 19
8
+ step: 20
9
9
  ---
10
10
 
11
11
  # Uninstalling AppMap
@@ -121,7 +121,7 @@ Learn more about AppMap in GitHub Codespaces:
121
121
 
122
122
  ## Generate OpenAPI Definitions
123
123
 
124
- After [recording AppMap Data](/docs/recording-methods.html) for your project, open the command pallette using `CTRL+SHIFT+P` or `COMMAND+SHIFT+P` on macOS, type `AppMap: Generate OpenAPI`, then hit `Enter`. This will open a new file with your OpenAPI definition document. Save this file locally, share with your team, or ingest as a [new collection into API tools like Postman.](https://blog.postman.com/new-postman-integration-with-appmap-create-and-manage-always-accurate-collections/)
124
+ After [recording AppMap Data](/docs/recording-methods.html) for your project, open the command palette using `CTRL+SHIFT+P` or `COMMAND+SHIFT+P` on macOS, type `AppMap: Generate OpenAPI`, then hit `Enter`. This will open a new file with your OpenAPI definition document. Save this file locally, share with your team, or ingest as a [new collection into API tools like Postman.](https://blog.postman.com/new-postman-integration-with-appmap-create-and-manage-always-accurate-collections/)
125
125
 
126
126
  ![alt_text](/assets/img/openapi/openapi-1.webp "OpenAPI export to file")
127
127
 
@@ -1,25 +1,55 @@
1
1
  ---
2
2
  layout: docs
3
3
  title: Docs - Navie
4
- name: Bring Your Own LLM Model
5
- step: 4
4
+ name: Choose Your LLM
5
+ step: 2
6
6
  navie: true
7
7
  toc: true
8
8
  description: Use AppMap Navie with your own OpenAI account or OpenAI-compatible LLM running either locally or remotely.
9
- redirect_from: [/docs/navie/bring-your-own-llm, /docs/navie/bring-your-own-key]
9
+ redirect_from: [/docs/navie/bring-your-own-llm, /docs/navie/bring-your-own-key, /docs/navie/bring-your-own-model.html]
10
10
  ---
11
11
 
12
- # Bring Your Own LLM Model
12
+ # Choose Your LLM
13
13
 
14
14
  By default, when asking a question to Navie, your code editor will interact with the AppMap hosted proxy for OpenAI. If you have a requirement to bring your own key or otherwise use your own OpenAI account you can specify your own OpenAI key; this will cause Navie to connect to OpenAI directly, without AppMap proxy acting as an intermediate.
15
15
 
16
- You can also use any OpenAI API compatible LLM model either running locally or via a 3rd party provider. Finally, for VS Code users with an active GitHub Copilot subscription, you can leverage the Copilot Language Models as a supported Navie backend. Refer to the [Navie docs for more examples](/docs/navie-reference#bring-your-own-model-examples) of using alternative language models.
16
+ You can also use any OpenAI API compatible LLM model either running locally or via a 3rd party provider. Finally, for VS Code users with an active GitHub Copilot subscription, you can leverage the Copilot Language Models as a supported Navie backend. Refer to the [Navie docs for more examples](/docs/navie-reference#bring-your-own-model-examples) of using alternative language models.
17
+ - [Using GitHub Copilot Language Models](#using-github-copilot-language-models)
17
18
  - [Bring Your Own OpenAI API Key (BYOK)](#bring-your-own-openai-api-key-byok)
18
19
  - [Bring Your Own Anthropic (Claude) API Key (BYOK)](#bring-your-own-anthropic-claude-api-key-byok)
19
20
  - [Bring Your Own Model (BYOM)](#bring-your-own-model-byom)
20
- - [Using GitHub Copilot Language Models](#using-github-copilot-language-models)
21
21
  - [Examples](#examples)
22
22
 
23
+ ## Using GitHub Copilot Language Models
24
+
25
+ Starting with VS Code `1.91` and greater, and with an active GitHub Copilot subscription, you can use Navie with the Copilot Language Model as a supported LLM backend. This allows you to leverage the powerful runtime powered Navie AI Architect with your existing Copilot subscription. This is the recommended option for users in corporate environments where Copilot is the only approved and supported language model.
26
+
27
+ ### Requirements <!-- omit in toc -->
28
+
29
+ The following items are required to use the GitHub Copilot Language Model with Navie:
30
+
31
+ - VS Code Version `1.91` or greater
32
+ - AppMap Extension version `v0.123.0` or greater
33
+ - GitHub Copilot VS Code extension must be installed
34
+ - Signed into an active paid or trial GitHub Copilot subscription
35
+
36
+ #### Setup <!-- omit in toc -->
37
+
38
+ Open the VS Code Settings, and search for `navie vscode`
39
+
40
+ <img class="video-screenshot" src="/assets/img/product/navie-copilot-1.webp"/>
41
+
42
+ Click the box to use the `VS Code language model...`
43
+
44
+ After clicking the box to enable the VS Code LM, you'll be instructed to reload your VS Code to enable these changes.
45
+
46
+ For more details about using the GitHub Copilot Language Model as a supported Navie backend, refer to the [Navie reference guide](/docs/navie-reference/navie-bring-your-own-model-examples.html)
47
+
48
+ #### Video Demo
49
+
50
+ {% include vimeo.html id='992238965' %}
51
+
52
+
23
53
  ## Bring Your Own OpenAI API Key (BYOK)
24
54
 
25
55
  Navie AI uses the AppMap hosted proxy with an AppMap managed OpenAI API key. If you have requirements to use your existing OpenAI API key, you can configure that within AppMap. This will ensure all Navie requests will be interacting with your own OpenAI account.
@@ -52,7 +82,7 @@ After your code editor reloads, you can confirm your requests are being routed t
52
82
 
53
83
  AppMap generally uses the latest OpenAI models as the default, but if you want to use an alternative model like `gpt-3.5` or a preview model like `gpt-4-vision-preview` you can modify the `APPMAP_NAVIE_MODEL` environment variable after configuring your own OpenAI API key to use other OpenAI models.
54
84
 
55
- After setting your `APPMAP_NAVIE_MODEL` with your chosen model reload/restart your code editor and then confirm it's configuration by opening a new Navie chat window. In this example i've configured my model to be `gpt-4o` with my personal OpenAI API Key.
85
+ After setting your `APPMAP_NAVIE_MODEL` with your chosen model reload/restart your code editor and then confirm it's configuration by opening a new Navie chat window. In this example I've configured my model to be `gpt-4o` with my personal OpenAI API Key.
56
86
 
57
87
  ![JetBrains OpenAI key modal](/assets/img/product/custom-model.webp)
58
88
 
@@ -166,35 +196,6 @@ After reloading you can confirm the model is configured correctly in the Navie C
166
196
 
167
197
  <img class="video-screenshot" src="/assets/img/product/navie-confirm-ui-vscode.webp"/>
168
198
 
169
- ## Using GitHub Copilot Language Models
170
-
171
- Starting with VS Code `1.91` and greater, and with an active GitHub Copilot subscription, you can use Navie with the Copilot Language Model as a supported LLM backend. This allows you to leverage the powerful runtime powered Navie AI Architect with your existing Copilot subscription. This is the recommended option for users in corporate environments where Copilot is the only approved and supported language model.
172
-
173
- ### Requirements <!-- omit in toc -->
174
-
175
- The following items are required to use the GitHub Copilot Language Model with Navie:
176
-
177
- - VS Code Version `1.91` or greater
178
- - AppMap Extension version `v0.123.0` or greater
179
- - GitHub Copilot VS Code extension must be installed
180
- - Signed into an active paid or trial GitHub Copilot subscription
181
-
182
- #### Setup <!-- omit in toc -->
183
-
184
- Open the VS Code Settings, and search for `navie vscode`
185
-
186
- <img class="video-screenshot" src="/assets/img/product/navie-copilot-1.webp"/>
187
-
188
- Click the box to use the `VS Code language model...`
189
-
190
- After clicking the box to enable the VS Code LM, you'll be instructed to reload your VS Code to enable these changes.
191
-
192
- For more details about using the GitHub Copilot Language Model as a supported Navie backend, refer to the [Navie reference guide](/docs/navie-reference#github-copilot-language-model)
193
-
194
- #### Video Demo
195
-
196
- {% include vimeo.html id='992238965' %}
197
-
198
199
  ## Examples
199
200
 
200
- Refer to the [Navie Reference Guide](/docs/navie-reference) for detailed examples of using Navie with your own LLM backend.
201
+ Refer to the [Navie Reference Guide](/docs/navie-reference/navie-bring-your-own-model-examples.html) for detailed examples of using Navie with your own LLM backend.
@@ -2,14 +2,14 @@
2
2
  layout: docs
3
3
  title: Docs - AppMap Navie
4
4
  description: "Learn how to open AppMap Navie in your code editor. Open Navie in your VS Code or JetBrains code editor to start working with Navie AI"
5
- name: How to Open Navie
6
- step: 2
5
+ name: Open Navie
6
+ step: 1
7
7
  navie: true
8
8
  toc: true
9
- redirect_from: [/docs/using-navie-ai/using-navie.html#how-to-open-navie]
9
+ redirect_from: [/docs/using-navie-ai/using-navie.html#how-to-open-navie, /docs/navie/how-to-open-navie]
10
10
  ---
11
11
 
12
- # How to Open Navie <!-- omit in toc -->
12
+ # Open Navie <!-- omit in toc -->
13
13
 
14
14
  - [In VS Code](#in-vs-code)
15
15
  - [In JetBrains](#in-jetbrains)
@@ -19,7 +19,7 @@ redirect_from: [/docs/using-navie-ai/using-navie.html#how-to-open-navie]
19
19
 
20
20
  ### In the VS Code Sidebar <!-- omit in toc -->
21
21
 
22
- You can open Navie in the VC Code sidebar by expanding (if necessary) the Navie section and select the `New Navie Chat` button.
22
+ You can open Navie in the VSCode sidebar by expanding (if necessary) the Navie section and select the `New Navie Chat` button.
23
23
 
24
24
  <img class="video-screenshot" src="/assets/img/product/navie-sidebar.webp"/>
25
25
 
@@ -4,18 +4,19 @@ title: Docs - AppMap Navie
4
4
  description: "Optimize AI code completion with AppMap Navie, leveraging runtime code execution insights for hyper-personalized AI-assisted coding."
5
5
  name: index
6
6
  step: 1
7
+ redirect_from: [/docs/navie]
7
8
  ---
8
9
 
9
- # Using Navie AI
10
+ # Using Navie
10
11
 
11
- AppMap Navie is the missing link that improves the power of AI code completers and code assistants. Leveraging the unique ability that AppMap has to understand your code's execution at runtime, Navie transforms this data into a powerhouse of hyper-personalized context-aware insights for AI-assisted coding.
12
+ AppMap Navie is designed to help developers solve issues and add features in their codebase by leveraging runtime data and AI-driven commands. By following a structured workflow, you can maximize Navie’s capabilities to plan, generate, and verify your code changes with precision. This guide outlines the recommended workflow and provides an overview of the key command modes used throughout the process.
12
13
 
13
- That means you're not just working with static analysis anymore, and you're not looking at just individual files or functions. With Navie, you can understand the entire codebase at an architectural level, how it behaves and executes, and provide much more detailed answers to your software questions.
14
+ 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/using-navie-ai/bring-your-own-model.html#azure-openai) or [hosted locally](/docs/using-navie-ai/bring-your-own-model.html#ollama).
14
15
 
15
- - [How Navie Works](/docs/using-navie-ai/how-navie-works)
16
- - [How to Open Navie](/docs/using-navie-ai/how-to-open-navie)
17
- - [Using Navie](/docs/using-navie-ai/using-navie)
18
- - [Bring Your Own LLM Model](/docs/using-navie-ai/bring-your-own-model.html)
16
+ - [Open Navie](/docs/using-navie-ai/how-to-open-navie)
17
+ - [Choose Your LLM](/docs/using-navie-ai/bring-your-own-model.html)
18
+ - [Using Navie For Solving Issues](/docs/using-navie-ai/using-navie)
19
+ - [How Navie Works](/docs/navie-reference/navie-how-it-works.html)
19
20
 
20
21
  **Install AppMap for your preferred code editor to get started.**
21
22
 
@@ -2,119 +2,108 @@
2
2
  layout: docs
3
3
  title: Docs - AppMap Navie
4
4
  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."
5
- name: Using Navie
5
+ name: Using Navie for Solving Issues
6
6
  step: 3
7
7
  navie: true
8
8
  toc: true
9
- redirect_from: [/docs/guides/navie-best-practices]
9
+ redirect_from: [/docs/guides/navie-best-practices, /docs/navie/using-navie]
10
10
  ---
11
- # Using Navie
11
+ # Using Navie for Solving Issues
12
12
 
13
- - [User Interface](#user-interface)
14
- - [Basic Layout](#basic-layout)
15
- - [Navie Advanced Commands](#navie-advanced-commands)
16
- - [Navie Best Practices](#navie-best-practices)
17
- - [Create AppMap Data](#create-appmap-data)
18
- - [Ask Navie](#ask-navie)
19
- - [Implement Generated Code](#implement-generated-code)
20
- - [Repeat](#repeat)
13
+ AppMap Navie is designed to help developers solve issues and add features in their codebase by leveraging runtime data and AI-driven commands. By following a structured workflow, you can maximize Navie’s capabilities to plan, generate, and verify your code changes with precision. This guide outlines the recommended workflow and provides an overview of the key command modes used throughout the process.
21
14
 
22
- When you ask a question to Navie, it will search through all your AppMap Diagrams (if they exist) and your static source code 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.
15
+ ## Recommended Workflow
23
16
 
24
- ## User Interface
25
- AppMap Navie AI is an AI assistant that enables you to ask architectural level questions about your code base. Navie is also able to help you generate new code that can span across your entire project. The primary user interface for Navie is within your VS Code or JetBrains code editor. Refer to the Navie docs to [learn how to open Navie](/docs/using-navie-ai/how-to-open-navie) for your code editor.
17
+ To achieve the highest quality results when using Navie, we suggest using the following command modes when prompting Navie. Simply type `@` into the chat input to access the list of available command modes.
26
18
 
27
- ![Navie User Interface](/assets/img/docs/appmap-navie-user-interface.webp)
19
+ ![Command Palette](/assets/img/command-palette-menu.webp)
28
20
 
29
- ## Basic Layout
21
+ 1. **@explain**(default)
22
+ The @explain command helps you learn more about your project. It prompts Navie to be more explanatory and dive into architectural level questions pulling information from across your entire code base.
30
23
 
31
- The Navie user interface consists of 5 key areas.
24
+ 2. **@diagram**
25
+ The @diagram command prompts Navie to create visual diagrams such as sequence diagrams, class diagrams, and flow charts. These diagrams are based on the code and runtime data associated with the issue or feature. Navie diagrams are exportable, compatible with Mermaid, and can be used to enhance technical documentation or shared with team members.
32
26
 
33
- <ol type="A">
34
- <b><li>AppMap Data Status Panel</li></b>
35
- This panel will list the current status of the AppMap Data that has been created for your project. AppMap Data are your application runtime traces which include things like HTTP and SQL requests, data flows, class and function level instrumentation, and more. Without AppMap Data created for your project, Navie can search through your static source code in your workspace for relevant code snippets.
36
- <b><li>Navie Context Window</li></b>
37
- Upon asking a question to Navie it will search through your AppMap Data (if exists) and the source code in your open workspace to locate all the relevant context for your question. This area will reflect the information that Navie is aware of when answering. You can use this information to better understand how Navie is responding.
38
- <b><li>LLM Model Config Button</li></b>
39
- You can configure Navie to use your own OpenAI API key or bring your own LLM model running locally or within another provider. Clicking the gear icon will open the configuration modal for the bring your own model settings. <a href="/docs/using-navie-ai/bring-your-own-model">Refer to the AppMap docs for more details</a>
40
- about how to configure Navie to use your own LLM models.
41
- <b><li>Active LLM Model</li></b>
42
- This panel will display the currently configured LLM model in use with Navie. The LLM details are displayed in the following format: <code>Model: &lt;Model Name&gt; (&lt;location&gt;)</code>. When using the default Navie backend, the location will be listed as <code>default</code>. When using your own OpenAI API key the location will be listed as <code>via OpenAI</code>. When using <a href="/docs/using-navie-ai/bring-your-own-model.html#configuration">Navie Bring Your Own Model</a>
43
- , the location will be the value of the <code>OPENAI_BASE_URL</code> environment variable, for example <code>via localhost</code> when using <a href="/docs/using-navie-ai/bring-your-own-model.html#ollama">Ollama</a> or <a href="/docs/using-navie-ai/bring-your-own-model.html#lm-studio">LM Studio</a>.
44
- <b><li>Navie Chat Window</li></b>
45
- This is your primary location for interacting with Navie. Here you can ask Navie questions about how your application works, ask Navie to generate code or test cases, and you can even have Navie create a pull request based on your changes. To learn more about specific Navie commands refer to the <a href="#navie-commands">Navie Commands</a> section.
46
- </ol>
27
+ 3. **@plan**
28
+ The @plan command helps you generate a step-by-step, multi-file plan that aligns with your application's design. Based on the issue you are working on, Navie will propose a solution with code snippets, flow charts, and runtime context to ensure accuracy.
47
29
 
48
- ## Navie Commands
30
+ 4. **@generate**
31
+ With a defined plan, the @generate command allows Navie to create, lint, and repair code automatically. Navie generates the necessary changes across multiple files while adhering to the plan.
49
32
 
50
- Navie supports a variety of `@` prefixed commands you can use at the beginning of any question you ask. For example, you can use the `@plan` command to focus the Navie AI response to build a detailed architecture plan for a new feature. You can use the `@generate` command to create code to implement a Navie AI created plan. Navie supports a growing list of advanced commands which focus the AI responses towards completing the specific task requested.
33
+ 5. **@test**
34
+ Navie can also assist in generating and refining test cases. The @test command is used to generate tests for both new and existing code to ensure functionality and catch breaking behaviors.
51
35
 
52
- For more detailed documentation about the available Navie prefix commands available, refer to the [Navie Commands Documentation](/docs/navie-reference#navie-commands).
36
+ 6. **@review**
37
+ Finally, the @review command allows you to compare the newly generated code with your existing codebase, ensuring that the changes are in line with the desired functionality and do not introduce regressions.
53
38
 
54
- ## Navie Best Practices
55
39
 
56
- To generate the highest quality responses from Navie, we recommend the following approach.
57
40
 
58
- - [User Interface](#user-interface)
59
- - [Basic Layout](#basic-layout)
60
- - [Navie Advanced Commands](#navie-advanced-commands)
61
- - [Navie Best Practices](#navie-best-practices)
62
- - [Create AppMap Data](#create-appmap-data)
63
- - [Ask Navie](#ask-navie)
64
- - [Implement Generated Code](#implement-generated-code)
65
- - [Repeat](#repeat)
41
+ #### Step-by-Step Example of Solving an Issue with Navie
66
42
 
67
- ### Create AppMap Data
43
+ The Navie command modes are available to be used in any sequence at any time. However, building up understanding through the iteration of the following process has proven to maximize the quality and consistency of positive results.
68
44
 
69
- 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.
45
+ {% include vimeo.html id='1012769182' %}
70
46
 
71
- 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.
72
47
 
73
- 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.
48
+ ##### Step 1: Collect Data and Plan the Solution
49
+ Copy the details of your issue, including the steps to reproduce it, into Navie using the `@plan` command.
74
50
 
75
- 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.
51
+ ```plaintext
52
+ @plan
53
+ <Paste issue text from GitHub, Jira, or any issue tracking system>
54
+ ```
76
55
 
77
- 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.
56
+ Navie will analyze the runtime data (if available) and relevant code to create a detailed plan for resolving the issue. You can review and adjust this plan by conversing with Navie.
78
57
 
79
- 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)).
58
+ When you ask Navie a question, the default mode is `@explain`, which you can use to understand code behavior and refine the plan.
80
59
 
81
- 5. **Process Recording**: A broader approach that records all activity within the configured scope of your application, from startup to shutdown. This method is useful when other methods are not applicable or when you need a comprehensive capture of your application's behavior. (Process recording is language specific, refer to [the language reference docs for examples](/docs/reference)).
60
+ **For complex issues** that require runtime analysis, Navie will suggest that you record AppMap data. You may decide that runtime analysis is needed to understand the detailed behavior of your running application. See the [When to Create AppMap Data](/docs/get-started-with-appmap/making-appmap-data.html) section below to choose the best method for your issue.
82
61
 
83
- Each of these methods generates AppMap Data in JSON format, which are then visualized through interactive diagrams in your code editor. This visualization supports a deep understanding of your application's architecture, dependencies, and runtime behavior, facilitating enhanced code quality and performance optimization.
62
+ **Pin specific data files** to your conversation with Navie to include data sources you know are relevant to the issue. This includes pinning the text of the issue itself.
84
63
 
85
- ### Ask Navie
64
+ ![Relevant content pinned to the context window](/assets/img/pinned-context.webp)
86
65
 
87
- 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.
66
+ **Pin code from Navie responses** to your conversation when a Navie response contains code that you want to reference in subsequent prompts.
88
67
 
89
- 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/using-navie-ai/bring-your-own-model.html#azure-openai) or [hosted locally](/docs/using-navie-ai/bring-your-own-model.html#ollama).
68
+ ![Relevant content pinned to the context window](/assets/img/pin-from-response.webp)
90
69
 
91
- You can ask free formed questions, or refer to the [Navie Reference docs](/docs/navie-reference) to learn more about the advanced Navie chat commands you can use with your question.
70
+ **Visualize code behavior** using the `@diagram` command to create visual explanations of the existing code or proposed changes.
92
71
 
93
- **Examples of good questions to ask Navie.**
72
+ Supported diagram types include sequence diagram, flow chart, entity-relationship, and class diagram.
94
73
 
95
- * Why is `behavior X` happening in dev and not in production?
96
- * Why did the `feature x` return a 500 error?
97
- * How can I make `feature x` use the database more efficiently?
98
- * What can I do to optimize the queries on this page?
99
- * Where does user registration happens in my code base?
100
- * Provide a solution to add Google OAuth login support for my user login pages.
101
- * Explain what functions or files are involved when a user logs into my service.
102
- * Loading the "products" view page is slow in production, provide suggested guidance with relevant code changes I can make to improve the speed.
74
+ ```plaintext
75
+ @diagram
76
+ <Insert details for the code behavior you want diagrammed>
77
+ ```
78
+ If AppMap data is available for the issue you're working on, Navie will have a deep understanding of your application's architecture. This enhances the quality of insights you receive when asking questions. Navie can search through your AppMap data to pinpoint the files, methods, and external services involved in processes like user registration.
103
79
 
104
- ### Implement Generated Code
80
+ Navie can also provide **comparative analysis and recommendations** based on patterns in your existing codebase.
105
81
 
106
- 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.
82
+ ##### Step 3: Generating Code
83
+ Once the plan is confirmed, use the `@generate` command to produce the necessary code changes.
107
84
 
108
- 1. **Identifying Components**: Navie can search through your AppMap Data to highlight the files, methods, and external services interacting during the registration process, offering runtime sequence diagrams for clarity.
85
+ ```plaintext
86
+ @generate
87
+ ```
109
88
 
110
- 2. **Implementation Guidance**: After identifying the areas of interest, you might need specific implementation advice. For instance, where and how to integrate third-party libraries into your existing codebase. Navie can provide detailed instructions on modifying settings files, updating URL configurations, and extending forms with new functionalities.
89
+ Navie will generate code based on the approved plan, updating multiple files if needed. The changes will be consistent with your project’s architecture and runtime context.
111
90
 
112
- 3. **Debugging and Optimization**: Beyond initial implementation, Navie can assist in debugging by pointing out potential sources of errors or inefficiencies in the code paths triggered during user interactions.
91
+ ##### Step 4: Testing the Changes
113
92
 
114
- 4. **Comparative Analysis and Recommendations**: By analyzing the runtime behavior and execution flow, Navie can offer recommendations to enhance performance, improve security, or reduce technical debt, backed by the rich data context of your application's actual operations.
93
+ The `@test` command helps you generate test cases. It works best when you specify the code that you want to test. You can do this by selecting the relevant code directly or by indicating the files to be tested in your conversation with Navie.
115
94
 
116
- 5. **Custom Queries**: Tailor your questions to fit unique development needs—whether you're troubleshooting a specific error, seeking optimization opportunities, or curious about the interactions between various components of your application.
95
+ To guide Navie, you can:
96
+ - Pin files containing the code you want to test in the Navie context window
97
+ - Select code and use the lightbulb icon in your editor (VS Code or JetBrains) to add it to the conversation.
117
98
 
118
- ### Repeat
99
+ This way, Navie knows exactly what to focus on and can generate precise, relevant test cases based on the code you want to validate.
119
100
 
120
- Continue to ask follow-up question to Navie as you are making code changes or when you need additional details or more specific advice. Additionally, as you make changes to your application, continue creating AppMap recordings of the updated code interactions and start new conversations with Navie to dive deeper into your feature implementation.
101
+ ```plaintext
102
+ @test
103
+ ```
104
+
105
+ After Navie generates test cases, insert them into your project’s test suite and run them using your test framework. Navie ensures that all test cases pass successfully.
106
+
107
+ ---
108
+
109
+ AppMap Navie empowers developers to solve issues and implement features efficiently by combining runtime data, AI planning, and code generation. Using commands like `@explain`, `@plan`, `@generate`, `@test`, and `@diagram`, Navie offers a streamlined approach to addressing codebase changes with minimal manual intervention. Follow the recommended workflow and utilize these powerful commands to improve your development process while maintaining high-quality code.
@@ -178,7 +178,6 @@ const BINARY_FILE_EXTENSIONS = [
178
178
  'jpg',
179
179
  'min.js',
180
180
  'min.css',
181
- 'mjs',
182
181
  'mkv',
183
182
  'mo',
184
183
  'mov',
@@ -1 +1 @@
1
- {"version":3,"file":"FileIndex.js","sourceRoot":"","sources":["../../src/fulltext/FileIndex.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAwC;AACxC,uDAAuC;AAEvC,oEAAqC;AACrC,oDAA4B;AAC5B,kDAA8B;AAC9B,2BAAgC;AAEhC,0EAAkD;AAClD,oEAA4C;AAC5C,4CAA6C;AAC7C,gFAAwD;AACxD,kEAA0C;AAC1C,mFAAgF;AAEhF,MAAM,KAAK,GAAG,IAAA,eAAS,EAAC,mBAAmB,CAAC,CAAC;AAa7C,MAAa,SAAS;IACpB,YAAmB,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;QAoFrC,mBAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAChD,CACE,SAAiB,EACjB,SAAmB,EACnB,OAAwB,EACxB,MAAe,EACf,KAAc,EACd,EAAE;YACF,MAAM,UAAU,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;YAC3F,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE;gBAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;aAC9C;QACH,CAAC,CACF,CAAC;QAEF,oCAAsC;QApGpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,uHAAuH,CACxH,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC1C,uBAAA,IAAI,qBAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAClC,kEAAkE,CACnE,MAAA,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,QAAkB,EAAE,KAAK,GAAG,EAAE;QACnC,MAAM,KAAK,GAAG,qGAAqG,CAAC;QAEpH,MAAM,UAAU,GAAG,IAAA,uBAAa,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,OAAO;YACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;gBACtB,KAAK,CAAC,aAAc,GAA6B,CAAC,SAAS,EAAE,CAAC,CAAC;aAChE;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;YAC7B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAAqB,EACrB,eAAqC,EACrC,eAAqC,EACrC,SAAS,GAAG,GAAG;QAEf,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE;YACnC,IAAI;gBACF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAG,MAAM,eAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC5C,MAAM,SAAS,GACb,QAAQ,KAAK,oBAAQ,CAAC,EAAE;oBACtB,CAAC,CAAC,MAAM,IAAA,6BAAmB,EAAC,SAAS,CAAC;oBACtC,CAAC,CAAC,MAAM,IAAA,0BAAgB,EAAC,SAAS,CAAC,CAAC;gBAExC,MAAM,iBAAiB,GAAG,MAAM,WAAW,CACzC,SAAS,EACT,SAAS,EACT,eAAe,EACf,eAAe,CAChB,CAAC;gBAEF,MAAM,OAAO,GAAG;oBACd,mBAAmB,EAAE,SAAS,CAAC,MAAM,GAAG,KAAM;oBAC9C,YAAY,EAAE,SAAS,CAAC,MAAM,GAAG,KAAM;iBACxC,CAAC;gBAEF,IAAI,OAAO,CAAC,YAAY,EAAE;oBACxB,KAAK,CAAC,4BAA4B,CAAC,CAAC;oBACpC,KAAK,CACH,6BAA6B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CACtF,CAAC;iBACH;qBAAM;oBACL,KAAK,CAAC,6BAA6B,CAAC,CAAC;iBACtC;gBAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE;oBAC5D,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;oBAEzE,2CAA2C;oBAC3C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;iBACxD;gBAED,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAG,CACT,WAAW,SAAS,CAAC,MAAM,aAAa,SAAS,OAAO,OAAO,GAAG,SAAS,IAAI,CAChF,CAAC;aACH;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,8BAA8B,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;aAClE;SACF;IACH,CAAC;IAqBD,SAAS,CAAC,SAAiB,EAAE,QAAgB,EAAE,UAA0B,EAAE;QACzE,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACpE,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC;QAEhD,IAAI;YACF,IAAI,KAAK,GAAG,IAAA,uBAAa,EAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEpD,IAAI,YAAY,EAAE;gBAChB,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAC,CAAC;gBAClF,KAAK,IAAI,IAAI,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;aACxD;YAED,KAAK,CAAC,sBAAsB,QAAQ,eAAe,KAAK,EAAE,CAAC,CAAC;YAE5D,uBAAA,IAAI,yBAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;SAC9C;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,IAAI,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;IACH,CAAC;CACF;AA5HD,8BA4HC;;AAED,SAAgB,gBAAgB,CAAC,aAAqB;IACpD,IAAA,gBAAM,EAAC,IAAA,eAAU,EAAC,aAAa,CAAC,EAAE,cAAc,aAAa,iBAAiB,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,wBAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAJD,4CAIC;AAEM,KAAK,UAAU,cAAc,CAClC,WAAqB,EACrB,aAAqB,EACrB,eAA0B,EAC1B,eAA0B;IAE1B,IAAA,gBAAM,EAAC,CAAC,IAAA,eAAU,EAAC,aAAa,CAAC,EAAE,cAAc,aAAa,iBAAiB,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,IAAI,wBAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,EAAE,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAZD,wCAYC;AAED,MAAM,sBAAsB,GAAa;IACvC,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,SAAS;IACT,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;CACN,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAE1B,MAAM,oBAAoB,GAAa;IACrC,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;CACN,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAE1B,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,EAAE;IACxC,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAE;IACtC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEK,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,SAAmB,EACnB,eAA0B,EAC1B,eAA0B;IAE1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,IAAI,YAAY,CAAC,QAAQ,CAAC;YAAE,SAAS;QAErC,MAAM,WAAW,GAAG,IAAA,6DAA6B,EAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;QAC9F,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI;YACF,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE;gBAClB,UAAU,GAAG,IAAI,CAAC;gBAClB,IAAI,KAAK,CAAC,IAAI,GAAG,KAAM,EAAE;oBACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE;wBACxB,KAAK,CAAC,4BAA4B,QAAQ,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;wBACtE,UAAU,GAAG,KAAK,CAAC;qBACpB;yBAAM;wBACL,KAAK,CAAC,sBAAsB,QAAQ,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;qBACjE;iBACF;aACF;SACF;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,IAAI,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;QAED,IAAI,UAAU;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KACvC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAnCD,kCAmCC"}
1
+ {"version":3,"file":"FileIndex.js","sourceRoot":"","sources":["../../src/fulltext/FileIndex.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@appland/appmap",
3
- "version": "3.168.0",
3
+ "version": "3.169.0",
4
4
  "description": "",
5
5
  "bin": "built/cli.js",
6
6
  "engines": {
@@ -89,7 +89,7 @@
89
89
  "@appland/components": "^4.12.0",
90
90
  "@appland/diagrams": "^1.8.0",
91
91
  "@appland/models": "^2.10.2",
92
- "@appland/navie": "^1.28.0",
92
+ "@appland/navie": "^1.33.0",
93
93
  "@appland/openapi": "^1.8.0",
94
94
  "@appland/rpc": "^1.13.0",
95
95
  "@appland/scanner": "^1.86.0",