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

package/dist/esm/lib/fusion-ai.js

@@ -0,0 +1,2 @@
+export const configureFusionAI = (fn) => fn;
+//# sourceMappingURL=fusion-ai.js.map

package/dist/esm/lib/fusion-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-ai.js","sourceRoot":"","sources":["../../../src/lib/fusion-ai.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAkD,EAAE,EAAE,CAAC,EAAE,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '12.3.10';
+export const version = '13.0.0-cli-search-index.0';
 //# sourceMappingURL=version.js.map

package/dist/types/bin/framework.node.d.ts

@@ -1,4 +1,4 @@
-import { type ModulesInstance } from '@equinor/fusion-framework-module';
+import { ModulesConfigurator, type ModulesInstance } from '@equinor/fusion-framework-module';
 import { type MsalNodeModule } from '@equinor/fusion-framework-module-msal-node';
 import { type HttpModule } from '@equinor/fusion-framework-module-http';
 import { type ServiceDiscoveryModule } from '@equinor/fusion-framework-module-service-discovery';
@@ -62,6 +62,18 @@ export type FusionFrameworkSettings = {
         scope?: string[];
     };
 };
+/**
+ * Configures the Fusion Framework with the provided settings and returns a configurator.
+ *
+ * This function creates and configures a module configurator with HTTP, service discovery,
+ * and authentication modules based on the supplied configuration. The returned configurator
+ * can be further customized before initialization.
+ *
+ * @param config - The settings for framework configuration.
+ * @returns A configured module configurator ready for initialization.
+ * @throws Will throw if required authentication parameters are missing.
+ */
+export declare const configureFramework: (config: FusionFrameworkSettings) => ModulesConfigurator<Modules>;
 /**
  * Initializes the Fusion Framework with the provided settings.
  *

package/dist/types/bin/index.d.ts

@@ -14,7 +14,7 @@ export { loadPortalManifest } from './portal-manifest.js';
 export { generatePortalConfig } from './portal-config.js';
 export { publishPortalConfig } from './portal-config-publish.js';
 export { uploadPortalBundle, type UploadPortalOptions } from './portal-upload.js';
-export { tagPortal, AllowedTags as AllowedPortalTags } from './portal-tag.js';
+export { tagPortal } from './portal-tag.js';
 export { pack } from './pack.js';
 export { ConsoleLogger } from './utils/ConsoleLogger.js';
-export { initializeFramework, resolveDefaultEnv, type FusionFramework, type FusionFrameworkSettings, FusionEnv, } from './framework.node.js';
+export { initializeFramework, configureFramework, resolveDefaultEnv, type FusionFramework, type FusionFrameworkSettings, FusionEnv, } from './framework.node.js';

package/dist/types/bin/portal-tag.d.ts

@@ -1,19 +1,5 @@
 import type { FusionFramework } from './framework.node.js';
 import { type ConsoleLogger } from './utils/index.js';
-/**
- * Allowed tags for portal versions in the portal service.
- *
- * - `latest`: Marks the most recent stable version of the portal template.
- * - `preview`: Marks a pre-release or preview version for testing or review.
- *
- * Used by {@link tagPortal} to validate and apply version tags.
- *
- * @public
- */
-export declare enum AllowedTags {
-    Latest = "latest",
-    Preview = "preview"
-}
 /**
  * Options for tagging a portal template version in the portal service.
  *
@@ -21,7 +7,7 @@ export declare enum AllowedTags {
  * {@link tagPortal} function, including the tag type, portal name,
  * version, framework instance, and logger.
  *
- * @property tag - The tag to apply to the portal version (e.g., 'latest' or 'preview').
+ * @property tag - The tag to apply to the portal version (any string value).
  * @property name - The unique name identifying the portal template.
  * @property version - The version of the portal template to tag.
  * @property framework - The FusionFramework instance used for service discovery and requests.
@@ -30,14 +16,14 @@ export declare enum AllowedTags {
  * @public
  */
 export type TagPortalOptions = {
-    tag: AllowedTags;
+    tag: string;
     name: string;
     version: string;
     framework: FusionFramework;
     log?: ConsoleLogger | null;
 };
 /**
- * Tags a portal template version in the portal service with a specified tag (e.g., 'latest' or 'preview').
+ * Tags a portal template version in the portal service with a specified tag.
  *
  * This function validates input, creates a client for the portal service, and sends a tag request.
  * It provides detailed logging and error handling for common failure scenarios.

package/dist/types/cli/commands/ai/chat.d.ts

@@ -0,0 +1,2 @@
+export declare const command: import("commander").Command;
+export default command;

package/dist/types/cli/commands/ai/embeddings.d.ts

@@ -0,0 +1,2 @@
+export declare const command: import("commander").Command;
+export default command;

package/dist/types/cli/commands/ai/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI command: `ai`
+ *
+ * Manage Large Language Model (ai) integrations and configurations.
+ *
+ * Features:
+ * - Interactive chat with AI models
+ * - Document embedding and chunking utilities
+ * - Configure ai clients
+ * - Test model connections
+ * - Manage API keys and settings
+ *
+ * Usage:
+ *   $ ffc ai <subcommand> [options]
+ *
+ * Subcommands:
+ *   chat        Interactive chat with AI models
+ *   embeddings  Document embedding utilities for ai processing
+ *
+ * Examples:
+ *   $ ffc ai chat
+ *   $ ffc ai chat --model gpt-4 --api-key sk-...
+ *   $ ffc ai embeddings --dry-run ./src
+ *   $ ffc ai embeddings --chunk-size 1000 ./docs/readme.md
+ */
+export declare const command: import("commander").Command;
+export default command;

package/dist/types/cli/commands/ai/utils/extract-git-metadata.d.ts

@@ -0,0 +1,49 @@
+import { type SimpleGit } from 'simple-git';
+export type GitMetadata = Partial<{
+    git_remote_url: string;
+    git_commit_hash: string;
+    git_commit_date: string;
+    git_link: string;
+}>;
+/**
+ * Git diff options for filtering changed files
+ */
+export interface GitDiffOptions {
+    /** Enable diff-based file filtering */
+    diff: boolean;
+    /** Git reference to compare against (default: HEAD~1) */
+    baseRef?: string;
+    /** Working directory for git operations */
+    cwd?: string;
+}
+export declare const resolveProjectRoot: (filePath: string) => string | undefined;
+export declare const getGit: (filePath: string) => {
+    git: SimpleGit | undefined;
+    gitRepoPath: string;
+} | undefined;
+export declare const extractGitMetadata: (filePath: string) => Promise<GitMetadata | undefined>;
+/**
+ * Get list of changed files using git diff
+ * @param options - Git diff configuration options
+ * @returns Array of changed file paths
+ */
+export declare const getChangedFiles: (options: GitDiffOptions) => Promise<string[]>;
+/**
+ * Check if a file path matches any of the changed files
+ * @param filePath - File path to check
+ * @param changedFiles - Array of changed file paths
+ * @returns True if file has changed
+ */
+export declare const isFileChanged: (filePath: string, changedFiles: string[]) => boolean;
+/**
+ * Get git status information for debugging
+ * @param cwd - Working directory
+ * @returns Git status information
+ */
+export declare const getGitStatus: (cwd?: string) => Promise<{
+    branch: string;
+    commit: string;
+    hasChanges: boolean;
+    stagedFiles: number;
+    unstagedFiles: number;
+}>;

package/dist/types/cli/commands/ai/utils/generate-cunk-id.d.ts

@@ -0,0 +1 @@
+export declare const generateChunkId: (filePath: string, chunkIndex?: number) => string;

package/dist/types/cli/commands/ai/utils/parse-markdown.d.ts

@@ -0,0 +1,9 @@
+import type { VectorStoreDocument, VectorStoreDocumentMetadata } from '@equinor/fusion-framework-module-ai/lib';
+import type { SourceFile } from './types.js';
+export type MarkdownMetadata<T extends Record<string, unknown> = Record<string, unknown>> = VectorStoreDocumentMetadata<T & {
+    type: 'markdown';
+}>;
+export type MarkdownDocument<T extends Record<string, unknown> = Record<string, unknown>> = VectorStoreDocument<MarkdownMetadata<T>>;
+export declare const isMarkdownFile: (filePath: string) => boolean;
+export declare const parseMarkdown: <T extends Record<string, unknown> = Record<string, unknown>>(content: string, source: string) => Promise<MarkdownDocument<T>[]>;
+export declare const parseMarkdownFile: <T extends Record<string, unknown> = Record<string, unknown>>(file: SourceFile) => Promise<MarkdownDocument<T>[]>;

package/dist/types/cli/commands/ai/utils/parse-ts-doc.d.ts

@@ -0,0 +1,33 @@
+import type { VectorStoreDocument, VectorStoreDocumentMetadata } from '@equinor/fusion-framework-module-ai/lib';
+import type { SourceFile } from './types.js';
+export type TypescriptMetadata = VectorStoreDocumentMetadata<{
+    type: 'tsdoc';
+    ts_kind: string;
+    ts_name: string;
+}>;
+export type TypescriptDocument = VectorStoreDocument<TypescriptMetadata>;
+export interface ParseTsDocOptions {
+    /** The project root path for generating relative paths */
+    projectRoot?: string;
+}
+/**
+ * Checks if a file is a TypeScript or TSX file based on its extension.
+ * @param filePath - The path to the file.
+ * @returns True if the file ends with .ts or .tsx, false otherwise.
+ */
+export declare const isTypescriptFile: (filePath: string) => boolean;
+/**
+ * Parses TSDoc from a string of TypeScript code.
+ * @param content - The TypeScript code content.
+ * @param options - Optional parsing configuration.
+ * @returns An array of TypeScript documents with TSDoc metadata.
+ */
+export declare const parseTsDocSync: (content: string, options?: ParseTsDocOptions) => TypescriptDocument[];
+/**
+ * Parses TSDoc from a TypeScript file by path.
+ * @param file - The source file object.
+ * @param options - Optional parsing configuration.
+ * @returns An array of TypeScript documents with TSDoc metadata.
+ * @throws If the file is not a TypeScript file.
+ */
+export declare const parseTsDocFromFileSync: (file: SourceFile, options?: ParseTsDocOptions) => TypescriptDocument[];

package/dist/types/cli/commands/ai/utils/setup-framework.d.ts

@@ -0,0 +1,6 @@
+import { type IAIProvider } from '@equinor/fusion-framework-module-ai';
+import { type FusionFramework } from '../../../../bin/framework.node.js';
+import type { AiOptions } from '../../../options/ai.js';
+export declare const setupFramework: (options: AiOptions) => Promise<FusionFramework & {
+    ai: IAIProvider;
+}>;

package/dist/types/cli/commands/ai/utils/types.d.ts

@@ -0,0 +1,5 @@
+export type SourceFile = {
+    path: string;
+    projectRoot?: string;
+    relativePath?: string;
+};

package/dist/types/cli/commands/portal/publish.d.ts

@@ -15,7 +15,7 @@
  *   -d, --debug          Enable debug mode for verbose logging
  *   -e, --env <env>      Target environment
  *   -m, --manifest       Manifest file to use for bundling
- *   -t, --tag            Tag to apply to the published portal
+ *   -t, --tag            Tag to apply to the published portal (any string value)
  *
  * Example:
  *   $ ffc portal publish

package/dist/types/cli/commands/portal/tag.d.ts

@@ -12,7 +12,7 @@
  *   $ ffc portal tag <tag> [options]
  *
  * Arguments:
- *   <tag>                  Tag to apply (e.g., latest, preview)
+ *   <tag>                  Tag to apply (e.g., latest, preview, next, or any string value)
  *
  * Options:
  *   -m, --manifest <file>  Manifest file to use (optional, defaults to portal.manifest.ts)

package/dist/types/cli/options/ai.d.ts

@@ -0,0 +1,105 @@
+import { type Command } from 'commander';
+/**
+ * Interface representing the AI-related options available in CLI commands.
+ * This interface defines the structure of options that can be passed to AI commands.
+ */
+export interface AiOptions {
+    /** Azure OpenAI API key for authentication */
+    openaiApiKey: string;
+    /** Azure OpenAI API version */
+    openaiApiVersion: string;
+    /** Azure OpenAI instance name */
+    openaiInstance: string;
+    /** Azure OpenAI chat deployment name (optional) */
+    openaiChatDeployment?: string;
+    /** Azure OpenAI embedding deployment name (optional) */
+    openaiEmbeddingDeployment?: string;
+    /** Azure Search endpoint URL (optional) */
+    azureSearchEndpoint?: string;
+    /** Azure Search API key (optional) */
+    azureSearchApiKey?: string;
+    /** Azure Search index name (optional) */
+    azureSearchIndexName?: string;
+}
+/**
+ * Option for specifying the Azure OpenAI API key.
+ * Required for authentication with Azure OpenAI services.
+ */
+export declare const apiKeyOption: import("commander").Option;
+/**
+ * Option for specifying the Azure OpenAI API version.
+ * Defaults to the latest stable version if not provided.
+ */
+export declare const apiVersionOption: import("commander").Option;
+/**
+ * Option for specifying the Azure OpenAI instance name.
+ * Required for Azure OpenAI service endpoint construction.
+ */
+export declare const apiInstanceOption: import("commander").Option;
+/**
+ * Option for specifying the Azure OpenAI deployment name for chat models.
+ * Required for chat completions API calls.
+ */
+export declare const chatDeploymentOption: import("commander").Option;
+/**
+ * Option for specifying the Azure OpenAI deployment name for embedding models.
+ * Required for embeddings API calls.
+ */
+export declare const embeddingDeploymentOption: import("commander").Option;
+/**
+ * Option for specifying the Azure Search endpoint URL.
+ * Required for Azure Cognitive Search operations.
+ */
+export declare const azureSearchEndpointOption: import("commander").Option;
+/**
+ * Option for specifying the Azure Search API key.
+ * Required for authentication with Azure Cognitive Search.
+ */
+export declare const azureSearchApiKeyOption: import("commander").Option;
+/**
+ * Option for specifying the Azure Search index name.
+ * Required for search operations on a specific index.
+ */
+export declare const azureSearchIndexNameOption: import("commander").Option;
+/**
+ * Enhances a given command with AI-related options.
+ *
+ * This function adds the following options to the provided command:
+ * - `openaiApiKey`: Azure OpenAI API key
+ * - `openaiApiVersion`: Azure OpenAI API version
+ * - `openaiInstance`: Azure OpenAI instance name
+ * - `openaiChatDeployment`: Chat model deployment name
+ * - `openaiEmbeddingDeployment`: Embedding model deployment name (if includeEmbedding is true)
+ * - `azureSearchEndpoint`: Azure Search endpoint URL (if includeSearch is true)
+ * - `azureSearchApiKey`: Azure Search API key (if includeSearch is true)
+ * - `azureSearchIndexName`: Azure Search index name (if includeSearch is true)
+ *
+ * @param command - The command to which AI options will be added
+ * @param args - Optional configuration for which options to include
+ * @param args.includeEmbedding - Whether to include embedding deployment option
+ * @param args.includeChat - Whether to include chat deployment option (defaults to true)
+ * @param args.includeSearch - Whether to include Azure Search options (defaults to false)
+ * @returns The enhanced command with AI options
+ *
+ * @example
+ * ```ts
+ * import { createCommand } from 'commander';
+ * import { withAiOptions } from './path/to/this/file';
+ *
+ * const command = withAiOptions(
+ *   createCommand('ai-chat')
+ *     .description('Chat with AI models')
+ *     .action((options) => {
+ *       console.log('API Key:', options.openaiApiKey);
+ *       console.log('Instance:', options.openaiInstance);
+ *       console.log('Chat Deployment:', options.openaiChatDeployment);
+ *     })
+ * );
+ * ```
+ */
+export declare const withAiOptions: (command: Command, args?: Partial<{
+    includeEmbedding: boolean;
+    includeChat: boolean;
+    includeSearch: boolean;
+}>) => Command;
+export default withAiOptions;

package/dist/types/lib/fusion-ai.d.ts

@@ -0,0 +1,20 @@
+import type { VectorStoreDocument } from '@equinor/fusion-framework-module-ai/lib';
+/**
+ * Configuration interface for Fusion AI operations
+ */
+export interface FusionAIConfig {
+    patterns?: string[];
+    /** Metadata processing configuration */
+    metadata?: {
+        /** Custom metadata processors to transform metadata before embedding */
+        attributeProcessor?: (metadata: Record<string, any>, document: VectorStoreDocument) => Record<string, any>;
+    };
+    /** Embedding generation configuration */
+    embedding?: {
+        /** Size of text chunks for embedding */
+        chunkSize?: number;
+        /** Overlap between chunks */
+        chunkOverlap?: number;
+    };
+}
+export declare const configureFusionAI: (fn: () => Promise<FusionAIConfig> | FusionAIConfig) => () => Promise<FusionAIConfig> | FusionAIConfig;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "12.3.10";
+export declare const version = "13.0.0-cli-search-index.0";

package/docs/portal.md

@@ -137,7 +137,7 @@ This command builds your portal template, uploads it to the Fusion portal regist
 | `-e`, `--env`      | Target environment for deployment (e.g., `ci`, `fqa`, `fprd`).                                      |                   |
 | `-m`, `--manifest` | Manifest file to use for bundling (e.g., `portal.manifest.ts`) (optional).                         | `portal.manifest.ts` |
 | `-s`, `--schema`   | Schema file to use for bundling (e.g., `portal.schema.ts`) (optional).                             | `portal.schema.ts` |
-| `-t`, `--tag`      | Tag to apply to the published portal (`latest` \| `preview`).                                       | `latest`          |
+| `-t`, `--tag`      | Tag to apply to the published portal (e.g., `latest`, `preview`, `next`, or any string value).     | `latest`          |
 | `-d`, `--debug`    | Enable debug mode for verbose logging.                                                              | `false`           |
 | `--token`          | Authentication token for Fusion.                                                                    |                   |
 | `--tenantId`       | Azure tenant ID for authentication.                                                                 |                   |
@@ -194,10 +194,10 @@ pnpm fusion-framework-cli portal upload my-portal.zip --name my-portal
 
 Tag a published portal template version in the Fusion portal registry.
 
-| Option/Argument   | Description                           | Default / Example |
-| ----------------- | ------------------------------------- | ----------------- |
-| `<tag>`           | Tag to apply (`latest` \| `preview`). |                   |
-| `-p, --package`   | Package to tag in format name@version. |                   |
+| Option/Argument   | Description                                     | Default / Example |
+| ----------------- | ----------------------------------------------- | ----------------- |
+| `<tag>`           | Tag to apply (e.g., `latest`, `preview`, `next`, or any string value). |                   |
+| `-p, --package`   | Package to tag in format name@version.         |                   |
 | `-m, --manifest`  | Manifest file to use.                 | `portal.manifest.ts` |
 | `--token`         | Authentication token for Fusion.      |                   |
 | `--tenantId`      | Azure tenant ID for authentication.   |                   |
@@ -212,6 +212,8 @@ pnpm fusion-framework-cli portal tag <tag> [options]
 ```sh
 pnpm fusion-framework-cli portal tag latest --package my-portal@1.0.0
 pnpm fusion-framework-cli portal tag preview --package my-portal@1.1.0-beta
+pnpm fusion-framework-cli portal tag next --package my-portal@2.0.0-alpha
+pnpm fusion-framework-cli portal tag stable --package my-portal@1.2.0
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-cli",
-  "version": "12.3.10",
+  "version": "13.0.0-cli-search-index.0",
   "keywords": [
     "Fusion",
     "Fusion Framework",
@@ -59,6 +59,10 @@
       "types": "./dist/types/lib/utils/index.d.ts",
       "import": "./dist/esm/lib/utils/index.js"
     },
+    "./ai": {
+      "types": "./dist/types/lib/ai/index.d.ts",
+      "import": "./dist/esm/lib/ai/index.js"
+    },
     "./package.json": "./package.json",
     "./README.md": "./README.md",
     "./CHANGELOG.md": "./CHANGELOG.md"
@@ -85,6 +89,9 @@
       ],
       "utils": [
         "dist/types/lib/utils/index.d.ts"
+      ],
+      "ai": [
+        "dist/types/lib/ai/index.d.ts"
       ]
     }
   },
@@ -94,23 +101,37 @@
     "directory": "packages/cli"
   },
   "dependencies": {
+    "@langchain/core": "^1.0.1",
+    "@langchain/textsplitters": "^1.0.0",
+    "@types/find-up": "^4.0.2",
     "@types/inquirer": "^9.0.9",
     "commander": "^14.0.1",
     "deepmerge": "^4.3.1",
+    "dotenv": "^17.2.2",
     "execa": "^9.6.0",
+    "find-up": "^8.0.0",
+    "findup": "^0.1.5",
+    "globby": "^15.0.0",
+    "gray-matter": "^4.0.3",
     "inquirer": "^12.9.6",
     "is-mergeable-object": "^1.1.1",
     "is-path-inside": "^4.0.0",
+    "multimatch": "^7.0.0",
     "ora": "^9.0.0",
+    "package-up": "^5.0.0",
     "read-package-up": "^11.0.0",
     "simple-git": "^3.28.0",
     "vite": "^7.1.12",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "ts-morph": "^27.0.2",
+    "tsx": "^4.19.3",
     "vite-tsconfig-paths": "^5.1.4",
     "zod": "^4.1.8",
-    "@equinor/fusion-framework-dev-portal": "1.2.5",
-    "@equinor/fusion-framework-dev-server": "1.1.12",
-    "@equinor/fusion-imports": "1.1.6",
-    "@equinor/fusion-framework-module-msal-node": "2.0.0"
+    "@equinor/fusion-framework-dev-server": "1.1.13-cli-search-index.0",
+    "@equinor/fusion-framework-dev-portal": "1.2.6-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"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.0",
@@ -129,14 +150,15 @@
     "pretty-bytes": "^7.0.0",
     "rollup": "^4.50.2",
     "rollup-plugin-terser": "^7.0.2",
-    "rxjs": "^7.8.1",
+    "rxjs": "^7.8.2",
     "type-fest": "^5.0.0",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
-    "@equinor/fusion-framework-module": "5.0.5",
-    "@equinor/fusion-framework-module-app": "7.1.0",
-    "@equinor/fusion-framework-module-http": "7.0.5",
-    "@equinor/fusion-framework-module-service-discovery": "9.0.4"
+    "@equinor/fusion-framework-module": "5.0.6-cli-search-index.0",
+    "@equinor/fusion-framework-module-ai": "1.1.0-cli-search-index.0",
+    "@equinor/fusion-framework-module-app": "7.1.1-cli-search-index.0",
+    "@equinor/fusion-framework-module-http": "7.0.6-cli-search-index.0",
+    "@equinor/fusion-framework-module-service-discovery": "9.0.5-cli-search-index.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
@@ -145,6 +167,7 @@
   },
   "scripts": {
     "prebuild": "tsc -b",
+    "dev:cli": "tsx src/cli/main.ts",
     "build": "rollup -c rollup.config.js",
     "build:clean": "rm -rf dist && rm -rf bin/build && rm -f tsconfig.tsbuildinfo && pnpm build",
     "test": "vitest",