minovative-mind-cli 1.0.0

package/README.md

@@ -0,0 +1,418 @@
+# Minovative Mind CLI
+
+An automated AI agent powered by Vertex AI that helps you write software right inside your terminal.
+
+[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
+[![Version](https://img.shields.io/npm/v/minovative-mind-cli.svg)](https://npmjs.org/package/minovative-mind-cli)
+[![Downloads/week](https://img.shields.io/npm/dw/minovative-mind-cli.svg)](https://npmjs.org/package/minovative-mind-cli)
+
+See [FEATURES.md](./FEATURES.md) and [ARCHITECTURE.md](./ARCHITECTURE.md) to learn more about the built-in safety, context intelligence, and self-correction systems.
+
+## Supported Models
+
+The CLI supports the following advanced reasoning and coding models via Vertex AI Model Garden. You can hot-swap between these models at any time during a chat session by typing `/models` in the CLI:
+
+- **Gemini 2.5 Pro**: Best for complex coding and large context windows.
+- **Gemini 2.5 Flash**: Lightning fast, balanced performance for everyday tasks.
+- **Claude Opus 4.6**: Anthropic's highly capable model for complex reasoning.
+- **Claude Sonnet 4.6**: Anthropic's fast and highly intelligent coding model.
+
+Note: Background utility tasks (like Intent Routing, Context Investigation, and Auto-Commits) are hardcoded to use fast, lightweight Gemini models (Flash and Flash-Lite) to keep the CLI snappy and cost-effective, reserving your selected model exclusively for the heavy lifting of writing code.
+
+<!-- toc -->
+* [Minovative Mind CLI](#minovative-mind-cli)
+* [Usage](#usage)
+* [Commands](#commands)
+<!-- tocstop -->
+
+# Usage
+
+<!-- usage -->
+```sh-session
+$ npm install -g minovative-mind-cli
+$ minovative-mind-cli COMMAND
+running command...
+$ minovative-mind-cli (--version)
+minovative-mind-cli/1.0.0 darwin-arm64 node-v25.6.1
+$ minovative-mind-cli --help [COMMAND]
+USAGE
+  $ minovative-mind-cli COMMAND
+...
+```
+<!-- usagestop -->
+
+# Commands
+
+<!-- commands -->
+* [`minovative-mind-cli chat`](#minovative-mind-cli-chat)
+* [`minovative-mind-cli help [COMMAND]`](#minovative-mind-cli-help-command)
+* [`minovative-mind-cli login`](#minovative-mind-cli-login)
+* [`minovative-mind-cli logout`](#minovative-mind-cli-logout)
+* [`minovative-mind-cli plugins`](#minovative-mind-cli-plugins)
+* [`minovative-mind-cli plugins add PLUGIN`](#minovative-mind-cli-plugins-add-plugin)
+* [`minovative-mind-cli plugins:inspect PLUGIN...`](#minovative-mind-cli-pluginsinspect-plugin)
+* [`minovative-mind-cli plugins install PLUGIN`](#minovative-mind-cli-plugins-install-plugin)
+* [`minovative-mind-cli plugins link PATH`](#minovative-mind-cli-plugins-link-path)
+* [`minovative-mind-cli plugins remove [PLUGIN]`](#minovative-mind-cli-plugins-remove-plugin)
+* [`minovative-mind-cli plugins reset`](#minovative-mind-cli-plugins-reset)
+* [`minovative-mind-cli plugins uninstall [PLUGIN]`](#minovative-mind-cli-plugins-uninstall-plugin)
+* [`minovative-mind-cli plugins unlink [PLUGIN]`](#minovative-mind-cli-plugins-unlink-plugin)
+* [`minovative-mind-cli plugins update`](#minovative-mind-cli-plugins-update)
+
+## `minovative-mind-cli chat`
+
+Start an interactive AI coding agent session powered by Vertex AI.
+
+```
+USAGE
+  $ minovative-mind-cli chat
+
+DESCRIPTION
+  Start an interactive AI coding agent session powered by Vertex AI.
+
+EXAMPLES
+  $ minovative-mind-cli
+
+  $ minovative-mind-cli --help
+```
+
+_See code: [src/commands/chat.ts](https://github.com/quarantiine/minovative-mind-cli/blob/v1.0.0/src/commands/chat.ts)_
+
+## `minovative-mind-cli help [COMMAND]`
+
+Display help for minovative-mind-cli.
+
+```
+USAGE
+  $ minovative-mind-cli help [COMMAND...] [-n]
+
+ARGUMENTS
+  [COMMAND...]  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for minovative-mind-cli.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.50/src/commands/help.ts)_
+
+## `minovative-mind-cli login`
+
+Sign in to your Minovative Mind account using GitHub
+
+```
+USAGE
+  $ minovative-mind-cli login
+
+DESCRIPTION
+  Sign in to your Minovative Mind account using GitHub
+```
+
+_See code: [src/commands/login.ts](https://github.com/quarantiine/minovative-mind-cli/blob/v1.0.0/src/commands/login.ts)_
+
+## `minovative-mind-cli logout`
+
+Sign out of your Minovative Mind account
+
+```
+USAGE
+  $ minovative-mind-cli logout
+
+DESCRIPTION
+  Sign out of your Minovative Mind account
+```
+
+_See code: [src/commands/logout.ts](https://github.com/quarantiine/minovative-mind-cli/blob/v1.0.0/src/commands/logout.ts)_
+
+## `minovative-mind-cli plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ minovative-mind-cli plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ minovative-mind-cli plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/index.ts)_
+
+## `minovative-mind-cli plugins add PLUGIN`
+
+Installs a plugin into minovative-mind-cli.
+
+```
+USAGE
+  $ minovative-mind-cli plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into minovative-mind-cli.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the MINOVATIVE_MIND_CLI_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the MINOVATIVE_MIND_CLI_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ minovative-mind-cli plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ minovative-mind-cli plugins add myplugin
+
+  Install a plugin from a github url.
+
+    $ minovative-mind-cli plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ minovative-mind-cli plugins add someuser/someplugin
+```
+
+## `minovative-mind-cli plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ minovative-mind-cli plugins inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN...  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ minovative-mind-cli plugins inspect myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/inspect.ts)_
+
+## `minovative-mind-cli plugins install PLUGIN`
+
+Installs a plugin into minovative-mind-cli.
+
+```
+USAGE
+  $ minovative-mind-cli plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into minovative-mind-cli.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the MINOVATIVE_MIND_CLI_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the MINOVATIVE_MIND_CLI_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ minovative-mind-cli plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ minovative-mind-cli plugins install myplugin
+
+  Install a plugin from a github url.
+
+    $ minovative-mind-cli plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ minovative-mind-cli plugins install someuser/someplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/install.ts)_
+
+## `minovative-mind-cli plugins link PATH`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ minovative-mind-cli plugins link PATH [-h] [--install] [-v]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help          Show CLI help.
+  -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ minovative-mind-cli plugins link myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/link.ts)_
+
+## `minovative-mind-cli plugins remove [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ minovative-mind-cli plugins remove [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ minovative-mind-cli plugins unlink
+  $ minovative-mind-cli plugins remove
+
+EXAMPLES
+  $ minovative-mind-cli plugins remove myplugin
+```
+
+## `minovative-mind-cli plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ minovative-mind-cli plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/reset.ts)_
+
+## `minovative-mind-cli plugins uninstall [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ minovative-mind-cli plugins uninstall [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ minovative-mind-cli plugins unlink
+  $ minovative-mind-cli plugins remove
+
+EXAMPLES
+  $ minovative-mind-cli plugins uninstall myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/uninstall.ts)_
+
+## `minovative-mind-cli plugins unlink [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ minovative-mind-cli plugins unlink [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  [PLUGIN...]  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ minovative-mind-cli plugins unlink
+  $ minovative-mind-cli plugins remove
+
+EXAMPLES
+  $ minovative-mind-cli plugins unlink myplugin
+```
+
+## `minovative-mind-cli plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ minovative-mind-cli plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.72/src/commands/plugins/update.ts)_
+<!-- commandsstop -->

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+execute({dir: import.meta.url}).catch(console.error)

package/dist/commands/chat.d.ts

@@ -0,0 +1,7 @@
+import 'dotenv/config';
+import { Command } from '@oclif/core';
+export default class DefaultCommand extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/chat.js

@@ -0,0 +1,30 @@
+import 'dotenv/config';
+import { Command } from '@oclif/core';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { startAgentLoop } from '../services/agent.js';
+import { getAuthorizedIdToken, login } from '../services/auth.js';
+export default class DefaultCommand extends Command {
+    static description = 'Start an interactive AI coding agent session powered by Vertex AI.';
+    static examples = ['<%= config.bin %>', '<%= config.bin %> --help'];
+    async run() {
+        const workspaceRoot = process.cwd();
+        console.clear();
+        p.intro(`${pc.bgCyan(pc.black(' Minovative Mind '))} ${pc.dim('v' + this.config.version)}`);
+        // Check authentication
+        let idToken = await getAuthorizedIdToken();
+        if (!idToken) {
+            p.log.warn('You are not signed in.');
+            const success = await login();
+            if (!success) {
+                p.outro(pc.red('Login failed. Cannot start chat.'));
+                this.exit(1);
+            }
+            // Re-fetch token after successful login
+            idToken = await getAuthorizedIdToken();
+        }
+        p.log.info(`${pc.dim('Workspace:')} ${pc.cyan(workspaceRoot)}`);
+        p.log.info(`${pc.dim('Commands:')} Type ${pc.yellow('/')} to open the command menu. Type ${pc.yellow('exit')} to leave.`);
+        await startAgentLoop(workspaceRoot, this.config.version);
+    }
+}

package/dist/commands/login.d.ts

@@ -0,0 +1,5 @@
+import { Command } from '@oclif/core';
+export default class LoginCommand extends Command {
+    static description: string;
+    run(): Promise<void>;
+}

package/dist/commands/login.js

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { login } from '../services/auth.js';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+export default class LoginCommand extends Command {
+    static description = 'Sign in to your Minovative Mind account using GitHub';
+    async run() {
+        p.intro(`${pc.bgCyan(pc.black(' Minovative Mind '))} - Login`);
+        const success = await login();
+        if (success) {
+            p.outro(pc.green('You are now ready to use the Minovative Mind CLI!'));
+        }
+        else {
+            p.outro(pc.red('Login failed.'));
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/logout.d.ts

@@ -0,0 +1,5 @@
+import { Command } from '@oclif/core';
+export default class LogoutCommand extends Command {
+    static description: string;
+    run(): Promise<void>;
+}

package/dist/commands/logout.js

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+import { logout } from '../services/auth.js';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+export default class LogoutCommand extends Command {
+    static description = 'Sign out of your Minovative Mind account';
+    async run() {
+        p.intro(`${pc.bgCyan(pc.black(' Minovative Mind '))} - Logout`);
+        logout();
+        p.outro(pc.green('You have been signed out.'));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/services/agent-tools.d.ts

@@ -0,0 +1,36 @@
+import { type FunctionDeclaration } from '@google/generative-ai';
+export interface ToolResult {
+    error?: string;
+    output: string;
+}
+/**
+ * FunctionDeclaration-compatible schema objects that describe
+ * every tool the agent can invoke. Passed to the model at init.
+ */
+export declare const toolDeclarations: FunctionDeclaration[];
+export type ApprovalMode = 'ask' | 'skip-once' | 'skip-all';
+export declare function getApprovalMode(): ApprovalMode;
+export declare function setApprovalMode(mode: ApprovalMode): void;
+/**
+ * If set to 'skip-once', reverts to 'ask' after a single command is run.
+ */
+export declare function consumeSkipOnce(): void;
+export declare function readFile(workspaceRoot: string, filePath: string, startLine?: number, endLine?: number, targetElements?: string[]): Promise<ToolResult>;
+export declare function writeFile(workspaceRoot: string, filePath: string, content: string): Promise<ToolResult>;
+export declare function deleteFile(workspaceRoot: string, filePath: string): Promise<ToolResult>;
+export declare function renameFile(workspaceRoot: string, sourcePath: string, targetPath: string): Promise<ToolResult>;
+export declare function modifyFile(workspaceRoot: string, filePath: string, edits: Array<{
+    searchContent: string;
+    replaceContent: string;
+}>): Promise<ToolResult>;
+export declare function listDirectory(workspaceRoot: string, dirPath: string, maxDepth?: number): Promise<ToolResult>;
+export declare function runCommand(workspaceRoot: string, command: string): Promise<ToolResult>;
+export declare function grepSearch(workspaceRoot: string, pattern: string, fileGlob?: string): Promise<ToolResult>;
+export declare function traceDependencies(workspaceRoot: string, filePath: string, direction?: string, maxDepth?: number): Promise<ToolResult>;
+export declare function findRecentChanges(workspaceRoot: string, dirPath?: string, minutes?: number, maxDepth?: number): Promise<ToolResult>;
+export declare function createAndRunTest(workspaceRoot: string, language: string, code: string): Promise<ToolResult>;
+/**
+ * Dispatches a function call from the model to the appropriate local tool.
+ * Returns the tool result as a string to feed back to the model.
+ */
+export declare function executeTool(workspaceRoot: string, toolName: string, args: Record<string, unknown>): Promise<ToolResult>;