duoops 0.1.6 → 0.1.9

package/README.md

@@ -27,18 +27,6 @@ DuoOps is a developer-focused CLI and Web Portal designed to make GitLab CI/CD p
 
 ### Installation
 
-#### Install from npm (recommended)
-
-```bash
-# Install the published CLI globally
-npm install -g duoops
-
-# Verify the binary is available
-duoops --help
-```
-
-#### Install from source (development)
-
 ```bash
 # Clone the repository
 git clone https://github.com/youneslaaroussi/duoops.git
@@ -146,35 +134,6 @@ duoops portal
 
 Open your browser to `http://localhost:3000`.
 
-### 6. Runner Utilities
-
-Once you've provisioned a runner with `duoops init`, you can inspect and manage it directly from the CLI:
-
-```bash
-# Tail the runner's systemd logs (defaults to gitlab-runner service)
-duoops runner:logs --lines 300
-
-# Reinstall the DuoOps CLI on the VM (uses the current CLI version by default)
-duoops runner:reinstall-duoops --version 0.1.0
-```
-
-### 7. Use the GitLab CI Component
-
-Instead of copying `.duoops/measure-component.yml` into every project, you can reference the published component directly:
-
-```yaml
-include:
-  - component: gitlab.com/youneslaaroussi/duoops/templates/duoops-measure-component@v0.1.0
-    inputs:
-      gcp_project_id: "my-project"
-      gcp_instance_id: "1234567890123456789"
-      gcp_zone: "us-central1-a"
-      machine_type: "e2-standard-4"
-      tags: ["gcp"]
-```
-
-Make sure your runner already has DuoOps installed (the provisioning flow handles this) and that `GCP_SA_KEY_BASE64` plus any optional BigQuery variables are set in the project’s CI/CD settings. Pin to a version tag (`@v0.1.0`) and update when you’re ready to adopt new behavior.
-
 ## 🛠️ Development
 
 ### Project Structure
@@ -198,20 +157,6 @@ pnpm build
 
 This compiles the TypeScript CLI and builds the React frontend, copying assets to the `dist/` directory.
 
-## 📦 Publishing to npm
-
-1.  Update `package.json` with the release version you want to publish.
-2.  Run the checks: `pnpm test` (this runs lint afterwards) to ensure the CLI and portal build cleanly.
-3.  Inspect the publish payload locally with `pnpm pack` (this runs the `prepack` script, which now builds the CLI, portal, and Oclif manifest automatically). Untar the generated `.tgz` if you want to double-check the contents.
-4.  When you're satisfied, publish the package: `pnpm publish --access public`.
-
-## 📦 Publishing the CI Component
-
-1.  Update `templates/duoops-measure-component.yml` and commit the changes.
-2.  Let the `.gitlab-ci.yml` validation job pass (runs automatically on MRs, default branch, and tags).
-3.  Tag the repository (e.g., `git tag v0.1.0 && git push origin v0.1.0`). Consumers reference the component with the tag via the snippet above.
-4.  Update release notes/README with the new component version so teams know what changed.
-
 ## 📄 License
 
 MIT

package/dist/commands/ask.d.ts

@@ -1,8 +1,11 @@
 import { Command } from '@oclif/core';
 export default class Ask extends Command {
     static args: {
-        question: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        question: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
+    static flags: {
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/ask.js

@@ -1,18 +1,49 @@
-import { Args, Command } from '@oclif/core';
+import { search } from '@inquirer/prompts';
+import { Args, Command, Flags } from '@oclif/core';
 import { runAgent } from '../lib/ai/agent.js';
+import { PROMPT_LIBRARY } from '../lib/ai/prompt-library.js';
 export default class Ask extends Command {
     static args = {
         question: Args.string({
             description: 'The question to ask the agent',
-            required: true,
+            required: false,
         }),
     };
     static description = 'Ask questions about your CI/CD pipelines, logs, and sustainability';
+    static flags = {
+        project: Flags.string({
+            char: 'P',
+            description: 'GitLab Project ID to contextually use',
+        }),
+    };
     async run() {
-        const { args } = await this.parse(Ask);
+        const { args, flags } = await this.parse(Ask);
+        let { question } = args;
+        if (!question) {
+            question = await search({
+                message: 'Select a prompt from the library:',
+                async source(term) {
+                    if (!term) {
+                        return PROMPT_LIBRARY.map((p) => ({
+                            description: p.description,
+                            name: p.title,
+                            value: p.description, // Passing description as the prompt to the agent
+                        }));
+                    }
+                    return PROMPT_LIBRARY
+                        .filter((p) => p.title.toLowerCase().includes(term.toLowerCase()) ||
+                        p.description.toLowerCase().includes(term.toLowerCase()))
+                        .map((p) => ({
+                        description: p.description,
+                        name: p.title,
+                        value: p.description,
+                    }));
+                },
+            });
+        }
         this.log('Thinking...');
         try {
-            const response = await runAgent(args.question);
+            const response = await runAgent(question, { projectId: flags.project });
             this.log('\n' + response);
         }
         catch (error) {

package/dist/commands/config.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class Config extends Command {
+    static args: {
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/config.js

@@ -0,0 +1,47 @@
+import { Args, Command } from '@oclif/core';
+import { bold, green } from 'kleur/colors';
+import { configManager } from '../lib/config.js';
+export default class Config extends Command {
+    static args = {
+        key: Args.string({
+            description: 'Config key (e.g., gitlabUrl, defaultProjectId)',
+            required: true,
+        }),
+        value: Args.string({
+            description: 'Config value',
+            required: true,
+        }),
+    };
+    static description = 'Set a configuration value directly';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> gitlabUrl https://gitlab.com',
+        '<%= config.bin %> <%= command.id %> defaultProjectId 123456',
+    ];
+    async run() {
+        const { args } = await this.parse(Config);
+        const { key, value } = args;
+        const currentConfig = configManager.get();
+        // Basic nested update support for measure.*
+        if (key.startsWith('measure.')) {
+            const subKey = key.split('.')[1];
+            const measure = currentConfig.measure || {
+                bigqueryDataset: '',
+                bigqueryTable: '',
+                googleProjectId: ''
+            };
+            // @ts-expect-error - dynamic assignment
+            measure[subKey] = value;
+            configManager.set({
+                ...currentConfig,
+                measure
+            });
+        }
+        else {
+            configManager.set({
+                ...currentConfig,
+                [key]: value,
+            });
+        }
+        this.log(green(`Updated ${bold(key)} to ${bold(value)}`));
+    }
+}

package/dist/commands/portal.js

@@ -28,13 +28,13 @@ export default class Portal extends Command {
         /* eslint-disable max-depth -- stream consumer adds necessary nesting */
         app.post('/api/chat', async (req, res) => {
             try {
-                const { messages } = req.body;
+                const { messages, projectId } = req.body;
                 if (!messages || !Array.isArray(messages)) {
                     res.status(400).json({ error: 'Messages array is required' });
                     return;
                 }
                 const modelMessages = await convertToModelMessages(messages);
-                const result = streamAgent(modelMessages);
+                const result = streamAgent(modelMessages, { projectId });
                 const response = result.toUIMessageStreamResponse();
                 res.status(response.status);
                 for (const [k, v] of response.headers.entries())
@@ -79,12 +79,14 @@ export default class Portal extends Command {
         });
         app.get('/api/metrics', async (req, res) => {
             try {
+                const config = configManager.get();
                 const { projectId } = req.query;
-                if (!projectId) {
-                    res.status(400).json({ error: 'Project ID is required' });
+                const targetProjectId = projectId ? String(projectId) : config.defaultProjectId;
+                if (!targetProjectId) {
+                    res.status(400).json({ error: 'Project ID is required and no default is configured' });
                     return;
                 }
-                const metrics = await fetchCarbonMetrics(String(projectId), 50);
+                const metrics = await fetchCarbonMetrics(targetProjectId, 50);
                 res.json(metrics);
             }
             catch (error) {

package/dist/lib/ai/agent.d.ts

@@ -1,6 +1,10 @@
 import type { ModelMessage } from 'ai';
-export declare const runAgent: (input: ModelMessage[] | string) => Promise<string>;
+export declare const runAgent: (input: ModelMessage[] | string, context?: {
+    projectId?: string;
+}) => Promise<string>;
 /** Same as runAgent but returns a streamText result for UI streaming (tool steps, etc.). */
-export declare function streamAgent(messages: ModelMessage[]): {
+export declare function streamAgent(messages: ModelMessage[], context?: {
+    projectId?: string;
+}): {
     toUIMessageStreamResponse(): Response;
 };

package/dist/lib/ai/agent.js

@@ -6,6 +6,48 @@ import { editingTools } from './tools/editing.js';
 import { fileTools } from './tools/filesystem.js';
 import { gitlabTools } from './tools/gitlab.js';
 import { measureTools } from './tools/measure.js';
+const baseTools = {
+    ...editingTools,
+    ...fileTools,
+    ...gitlabTools,
+    ...measureTools,
+};
+function createSystemPrompt(hasProjectId) {
+    const projectLine = hasProjectId
+        ? 'The portal already selected the GitLab project for you. All GitLab tools automatically target that project. Never attempt to guess, request, or change the project ID.'
+        : 'If a GitLab project has not been configured yet, ask the user to select one before running GitLab tools.';
+    return `You are a DevOps assistant.
+${projectLine}
+Use the available tools to answer questions about pipelines, jobs, and sustainability.`;
+}
+function createTools(projectId) {
+    return Object.fromEntries(Object.entries(baseTools).map(([name, t]) => [
+        name,
+        {
+            ...t,
+            async execute(args, options) {
+                const toolOptions = {
+                    ...(typeof options === 'object' && options !== null ? options : {}),
+                    projectId,
+                };
+                const logArgs = typeof args === 'object' && args !== null
+                    ? Object.fromEntries(Object.entries(args).filter(([key]) => key !== 'projectId' && key !== 'project_id'))
+                    : args;
+                logger.info({ args: logArgs, tool: name }, 'tool call');
+                try {
+                    const toolInstance = t;
+                    const result = await toolInstance.execute(args, toolOptions);
+                    logger.info({ result, tool: name }, 'tool result');
+                    return result;
+                }
+                catch (error) {
+                    logger.warn({ error: String(error), tool: name }, 'tool error');
+                    throw error;
+                }
+            },
+        },
+    ]));
+}
 /** Ensure no message has empty text content (Anthropic rejects "text content blocks must be non-empty"). */
 function sanitizeMessages(messages) {
     return messages.map((m) => {
@@ -38,37 +80,12 @@ function sanitizeMessages(messages) {
         return m;
     });
 }
-export const runAgent = async (input) => {
+export const runAgent = async (input, context) => {
     const model = createModel();
     const config = configManager.get();
-    const system = `You are a DevOps assistant.
-${config.defaultProjectId ? `The default GitLab Project ID is: ${config.defaultProjectId}. If the user doesn't specify a project, use this one.` : ''}
-Use the available tools to answer questions about pipelines, jobs, and sustainability.`;
-    const rawTools = {
-        ...editingTools,
-        ...fileTools,
-        ...gitlabTools,
-        ...measureTools,
-    };
-    /** Wrap each tool's execute to log invocations and results (for debugging tool round-trips). */
-    const tools = Object.fromEntries(Object.entries(rawTools).map(([name, t]) => [
-        name,
-        {
-            ...t,
-            async execute(args, options) {
-                logger.info({ args, tool: name }, 'tool call');
-                try {
-                    const result = await t.execute(args, options);
-                    logger.info({ result, tool: name }, 'tool result');
-                    return result;
-                }
-                catch (error) {
-                    logger.warn({ error: String(error), tool: name }, 'tool error');
-                    throw error;
-                }
-            },
-        },
-    ]));
+    const projectId = context?.projectId || config.defaultProjectId;
+    const system = createSystemPrompt(Boolean(projectId));
+    const tools = createTools(projectId);
     const rawMessages = Array.isArray(input)
         ? input
         : [{ content: input.trim() || ' ', role: 'user' }];
@@ -91,36 +108,12 @@ Use the available tools to answer questions about pipelines, jobs, and sustainab
     return result.text ?? '';
 };
 /** Same as runAgent but returns a streamText result for UI streaming (tool steps, etc.). */
-export function streamAgent(messages) {
+export function streamAgent(messages, context) {
     const model = createModel();
     const config = configManager.get();
-    const system = `You are a DevOps assistant.
-${config.defaultProjectId ? `The default GitLab Project ID is: ${config.defaultProjectId}. If the user doesn't specify a project, use this one.` : ''}
-Use the available tools to answer questions about pipelines, jobs, and sustainability.`;
-    const rawTools = {
-        ...editingTools,
-        ...fileTools,
-        ...gitlabTools,
-        ...measureTools,
-    };
-    const tools = Object.fromEntries(Object.entries(rawTools).map(([name, t]) => [
-        name,
-        {
-            ...t,
-            async execute(args, options) {
-                logger.info({ args, tool: name }, 'tool call');
-                try {
-                    const result = await t.execute(args, options);
-                    logger.info({ result, tool: name }, 'tool result');
-                    return result;
-                }
-                catch (error) {
-                    logger.warn({ error: String(error), tool: name }, 'tool error');
-                    throw error;
-                }
-            },
-        },
-    ]));
+    const projectId = context?.projectId || config.defaultProjectId;
+    const system = createSystemPrompt(Boolean(projectId));
+    const tools = createTools(projectId);
     const sanitized = sanitizeMessages(messages);
     if (sanitized.length === 0) {
         throw new Error('Please send a non-empty message.');

package/dist/lib/ai/prompt-library.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GitLab Duo Prompt Library
+ * Source: https://about.gitlab.com/gitlab-duo/prompt-library/
+ */
+export interface PromptTemplate {
+    category: string;
+    complexity?: 'Advanced' | 'Beginner' | 'Intermediate';
+    description: string;
+    tags?: string[];
+    title: string;
+    tool?: string;
+}
+export declare const PROMPT_LIBRARY: PromptTemplate[];