@equinor/fusion-framework-cli 13.0.0-cli-search-index.4 → 13.0.0

package/CHANGELOG.md

@@ -1,56 +1,154 @@
 # Change Log
 
-## 13.0.0-cli-search-index.4
+## 13.0.0
+
+### Major Changes
+
+- [`e2d2a76`](https://github.com/equinor/fusion-framework/commit/e2d2a76d08b86c3a9d8783fed1606551df9d5633) Thanks [@odinr](https://github.com/odinr)! - Add plugin system for extensible CLI architecture and new framework configuration utilities.
+
+  **Plugin System:**
+
+  - Support for optional plugins via `fusion-cli.config.ts` configuration file
+  - Automatic plugin discovery and loading from project root or CLI package directory
+  - Plugin registration via package name or direct function imports
+  - Support for `.ts`, `.js`, and `.json` config file formats
+  - Multiple plugin resolution strategies for different installation methods
+
+  **New Exports:**
+
+  - `configureFramework` - Separated framework configuration from initialization for advanced use cases
+  - `defineFusionCli` - Type-safe utility for defining CLI plugin configurations
+
+  **Enhancements:**
+
+  - Non-interactive mode support for `create app` command with `--git-protocol`, `--cleanup`/`--no-cleanup`, and `--no-open` options
+  - Automatic `.env` file loading via dotenv for environment variable support
+  - Improved error handling and plugin resolution strategies
+
+  **Documentation:**
+
+  - Added comprehensive AI commands documentation (internal use only)
+  - Updated README with plugin system usage instructions
+
+  **Quick Usage:**
+
+  1. Install a plugin package:
+
+  ```sh
+  pnpm add -D @equinor/fusion-framework-cli-plugin-ai-chat
+  ```
+
+  2. Create `fusion-cli.config.ts` in your project root:
+
+  ```typescript
+  import { defineFusionCli } from "@equinor/fusion-framework-cli";
+
+  export default defineFusionCli(() => ({
+    plugins: [
+      "@equinor/fusion-framework-cli-plugin-ai-chat",
+      // Or use direct imports:
+      // import aiChatPlugin from '@equinor/fusion-framework-cli-plugin-ai-chat';
+      // plugins: [aiChatPlugin],
+    ],
+  }));
+  ```
+
+  3. Plugins are automatically loaded when CLI starts:
+
+  ```sh
+  # Plugin commands are now available
+  ffc ai chat
+  ```
+
+  Plugins can be registered by package name (string) or direct function imports. The config file supports `.ts`, `.js`, or `.json` formats. If no config file exists, the CLI works normally without plugins.
 
 ### Patch Changes
 
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`91fbb14`](https://github.com/equinor/fusion-framework/commit/91fbb14c3618d4d494e0468fdef691a8cb48253d) Thanks [@odinr](https://github.com/odinr)! - Refactor `ai embeddings` command pipeline to improve performance and maintainability.
+- Updated dependencies [[`24403fc`](https://github.com/equinor/fusion-framework/commit/24403fc96d24d942f0c9632ed900b1a0f4065c1e)]:
+  - @equinor/fusion-framework-module-msal-node@2.0.2
+
+## 12.5.1
 
-  - Optimize file deletion with batch operations instead of one-by-one processing
-  - Improve RxJS stream handling with better separation of removed vs new/modified files
-  - Enhance result tracking to report deleted files and added document IDs
-  - Add clearer logging and comments throughout the pipeline
-  - Ensure deletions happen before additions using concat operator
+### Patch Changes
 
-  No public API changes; internal improvements only.
+- [#3845](https://github.com/equinor/fusion-framework/pull/3845) [`5114ac4`](https://github.com/equinor/fusion-framework/commit/5114ac4f71a60935d0194b9b2766f95adff0ba1e) Thanks [@asbjornhaland](https://github.com/asbjornhaland)! - Fix tsconfig references
+
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-portal@1.2.6
 
-## 13.0.0-cli-search-index.3
+## 12.5.0
 
 ### Minor Changes
 
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`551765f`](https://github.com/equinor/fusion-framework/commit/551765fc100332dd5d9e7ef2b14dfb51269bf888) Thanks [@odinr](https://github.com/odinr)! - Add `--clean` option to `ai embeddings` command to delete all existing documents from the vector store before processing.
+- [#3842](https://github.com/equinor/fusion-framework/pull/3842) [`d38cd60`](https://github.com/equinor/fusion-framework/commit/d38cd60472380d60282c2a5672dc6e3bba3e7ca9) Thanks [@asbjornhaland](https://github.com/asbjornhaland)! - Add module fusion-framework-module-analytics
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-portal@1.2.6
+
+## 12.4.6
 
-  Enhanced file status tracking to handle new, modified, and removed files. Removed files are automatically deleted from the vector store during processing.
+### Patch Changes
 
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`d09f820`](https://github.com/equinor/fusion-framework/commit/d09f8205cc091aa6af8d8527e3ed74d92ab9dc30) Thanks [@odinr](https://github.com/odinr)! - Add `ai search` command to search the vector store and validate embeddings.
+- [`41f8e9b`](https://github.com/equinor/fusion-framework/commit/41f8e9b7a9b2680553e089d04095a9db7821567e) Thanks [@odinr](https://github.com/odinr)! - Internal: upgrade build tooling dependency `esbuild` to 0.27.0 in `@equinor/fusion-imports`. No public API changes and no runtime impact to consumers.
 
-  The new command enables semantic search using vector embeddings with support for:
+- Updated dependencies [[`41f8e9b`](https://github.com/equinor/fusion-framework/commit/41f8e9b7a9b2680553e089d04095a9db7821567e)]:
+  - @equinor/fusion-imports@1.1.8
+  - @equinor/fusion-framework-dev-server@1.1.18
+  - @equinor/fusion-framework-dev-portal@1.2.6
 
-  - Configurable result limits
-  - OData filter expressions for metadata-based filtering
-  - JSON output option for programmatic use
-  - Raw metadata output option
-  - Verbose output mode
+## 12.4.5
 
-  Usage: `ffc ai search <query> [options]`
+### Patch Changes
+
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-server@1.1.17
+  - @equinor/fusion-framework-dev-portal@1.2.6
 
-## 13.0.0-cli-search-index.2
+## 12.4.4
 
 ### Patch Changes
 
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`acb5554`](https://github.com/equinor/fusion-framework/commit/acb55542ea92c7d559ca15d6397321379c2f234a) Thanks [@odinr](https://github.com/odinr)! - Internal: refactor AI framework setup to use ModulesConfigurator directly instead of configureFramework, removing need for dummy auth configuration and improving type safety. Also removes logging of sensitive API key information.
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-server@1.1.16
+  - @equinor/fusion-framework-dev-portal@1.2.6
 
-## 13.0.0-cli-search-index.1
+## 12.4.3
 
-### Minor Changes
+### Patch Changes
 
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`ccc6745`](https://github.com/equinor/fusion-framework/commit/ccc6745995c36771933b50461ea27e9b07c56a17) Thanks [@odinr](https://github.com/odinr)! - Add new `lib/ai` export path exposing `configureFusionAI` and `FusionAIConfig` for programmatic AI configuration.
+- [#3768](https://github.com/equinor/fusion-framework/pull/3768) [`28cffb2`](https://github.com/equinor/fusion-framework/commit/28cffb2d0a779bc190eb6d615f4bf6f86bb001c3) Thanks [@dependabot](https://github.com/apps/dependabot)! - chore: bump inquirer from 12.10.0 to 13.0.1
 
-  This provides a public API for configuring Fusion AI settings including metadata processing, embedding chunking, and pattern matching.
+  Updated inquirer to v13.0.1 and migrated deprecated `list` prompt type to `select` for compatibility with inquirer v13 breaking changes.
 
-## 13.0.0-cli-search-index.0
+- [#3779](https://github.com/equinor/fusion-framework/pull/3779) [`ee6aa77`](https://github.com/equinor/fusion-framework/commit/ee6aa7764776000edab9233ad9a4716b2d85c4eb) Thanks [@dependabot](https://github.com/apps/dependabot)! - chore: bump vite from 7.1.12 to 7.2.4
 
-### Major Changes
+- Updated dependencies [[`a768715`](https://github.com/equinor/fusion-framework/commit/a7687155c0666655afd932887e475415a7b76b31), [`0d31799`](https://github.com/equinor/fusion-framework/commit/0d31799be8da15b7ee4ddca643d6dc684092b905), [`ee6aa77`](https://github.com/equinor/fusion-framework/commit/ee6aa7764776000edab9233ad9a4716b2d85c4eb)]:
+  - @equinor/fusion-imports@1.1.7
+  - @equinor/fusion-framework-module-msal-node@2.0.1
+  - @equinor/fusion-framework-dev-portal@1.2.6
+  - @equinor/fusion-framework-dev-server@1.1.15
+
+## 12.4.2
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-portal@1.2.5
+  - @equinor/fusion-framework-dev-server@1.1.14
+
+## 12.4.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @equinor/fusion-framework-dev-portal@1.2.5
+  - @equinor/fusion-framework-dev-server@1.1.13
+
+## 12.4.0
+
+### Minor Changes
 
 - [`393f163`](https://github.com/equinor/fusion-framework/commit/393f1637ed33b84a6330b5eb122ab549805416bd) Thanks [@Noggling](https://github.com/Noggling)! - **Portal Tags Now Support Any String Value**
 
@@ -105,35 +203,6 @@
 
   This change provides much greater flexibility for deployment workflows while maintaining the same API structure and functionality.
 
-### Minor Changes
-
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`db880d1`](https://github.com/equinor/fusion-framework/commit/db880d1fbdb62ba4667f11229d1e6c3a4cea06fc) Thanks [@odinr](https://github.com/odinr)! - Add new `ai` command with `chat` and `embeddings` subcommands for LLM integration and document processing.
-
-  The CLI now supports interactive AI chat and document embedding utilities for processing codebase documentation and generating vector embeddings for search indexing.
-
-  **New Commands:**
-
-  - `ffc ai chat` - Interactive chat with AI models
-  - `ffc ai embeddings` - Document embedding utilities for AI processing
-
-  **Features:**
-
-  - Interactive chat interface with conversation history
-  - Document chunking and embedding generation
-  - Support for markdown and TypeScript documentation parsing
-  - Git metadata extraction for context-aware embeddings
-  - Vector store integration for search indexing
-
-### Patch Changes
-
-- [#3757](https://github.com/equinor/fusion-framework/pull/3757) [`db880d1`](https://github.com/equinor/fusion-framework/commit/db880d1fbdb62ba4667f11229d1e6c3a4cea06fc) Thanks [@odinr](https://github.com/odinr)! - preview release
-
-- Updated dependencies [[`db880d1`](https://github.com/equinor/fusion-framework/commit/db880d1fbdb62ba4667f11229d1e6c3a4cea06fc)]:
-  - @equinor/fusion-framework-dev-portal@1.2.6-cli-search-index.0
-  - @equinor/fusion-framework-dev-server@1.1.13-cli-search-index.0
-  - @equinor/fusion-framework-module-msal-node@2.0.1-cli-search-index.0
-  - @equinor/fusion-imports@1.1.7-cli-search-index.0
-
 ## 12.3.10
 
 ### Patch Changes

package/README.md

@@ -14,6 +14,7 @@ Fusion Framework CLI is a command-line tool for developing, building, and publis
 - Environment-specific configuration handling
 - Integrated authentication and authorization
 - CI/CD pipeline support with automated publishing
+- **Plugin system**: Extensible architecture with optional plugins (e.g., AI/LLM commands)
 
 ## Prerequisites
 
@@ -101,6 +102,29 @@ pnpm fusion-framework-cli app config --publish --env <environment>
 | `pnpm fusion-framework-cli portal ...` | Working with Fusion portal templates |
 | `pnpm fusion-framework-cli disco ...` | Service discovery and resolution     |
 
+**Optional Plugins:**
+| Command | Description |
+|---------|-------------|
+| `pnpm fusion-framework-cli ai ...` | AI/LLM commands (requires `@equinor/fusion-framework-cli-plugin-ai`) |
+
+**Plugin System:**
+
+The CLI supports optional plugins that extend functionality. To use plugins:
+
+1. Install the plugin package: `pnpm add -D @equinor/fusion-framework-cli-plugin-ai`
+2. Create a `fusion-cli.config.ts` file in your project root:
+   ```typescript
+   import { defineFusionCli } from '@equinor/fusion-framework-cli';
+   
+   export default defineFusionCli(() => ({
+     plugins: [
+       '@equinor/fusion-framework-cli-plugin-ai',
+     ],
+   }));
+   ```
+
+Plugins are automatically discovered and loaded when the CLI starts. The config file can be `.ts`, `.js`, or `.json`. If no config file exists, the CLI works normally without plugins.
+
 ## Example: package.json
 
 A minimal example for a Fusion Framework app: