ai-cmd 1.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,79 @@
+export type RiskLevel = "low" | "medium" | "high";
+export type OperatingSystem = "linux" | "macos" | "wsl" | "unix" | "unsupported";
+export type ShellType = "bash" | "zsh" | "sh" | "unknown";
+export type ServiceManager = "systemctl" | "service" | "rc-service" | "launchctl" | "unknown";
+export type ProviderName = "openai";
+export interface PlatformContext {
+    os: OperatingSystem;
+    shell: ShellType;
+    serviceManager: ServiceManager;
+    cwd: string;
+    cwdName: string;
+}
+export interface ProviderCommandPayload {
+    command: string;
+    explanation: string;
+    platformNotes?: string[];
+    assumptions?: string[];
+}
+export interface ConversationTurn {
+    question: string;
+    command: string;
+    explanation: string;
+}
+export interface CommandSuggestion extends ProviderCommandPayload {
+    question: string;
+    risk: RiskLevel;
+    platform: PlatformContext;
+}
+export interface AppConfig {
+    provider: ProviderName;
+    model: string;
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+}
+export interface GenerateObjectRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    schemaName: string;
+    schemaDescription: string;
+    jsonSchema: Record<string, unknown>;
+    temperature?: number;
+}
+export interface ProviderTextResponse {
+    provider: string;
+    model: string;
+    rawText: string;
+}
+export interface AIProvider {
+    readonly name: ProviderName;
+    generateObject(input: GenerateObjectRequest): Promise<ProviderTextResponse>;
+}
+export interface GenerateCommandOptions {
+    question: string;
+    platform: PlatformContext;
+    provider: AIProvider;
+    explainRequested?: boolean;
+    history?: ConversationTurn[];
+}
+export interface OutputOptions {
+    color: boolean;
+    explain: boolean;
+    json: boolean;
+}
+export interface CliOptions {
+    exec: boolean;
+    yes: boolean;
+    explain: boolean;
+    json: boolean;
+    version: boolean;
+    shell?: Exclude<ShellType, "unknown">;
+    noColor: boolean;
+    debug: boolean;
+    copy: boolean;
+}
+export interface PromptAdapter {
+    confirm(message: string, initial?: boolean): Promise<boolean>;
+    text(message: string): Promise<string>;
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/branding.d.ts

@@ -0,0 +1,6 @@
+export declare const APP_NAME = "AI-CMD";
+export declare const APP_VERSION = "1.0.1";
+export declare const BRAND_NAME = "Ottili ONE";
+export declare const BRAND_URL = "ottili.one";
+export declare function formatVersionBanner(): string;
+export declare function formatReplBanner(): string;

package/dist/utils/branding.js

@@ -0,0 +1,11 @@
+export const APP_NAME = "AI-CMD";
+export const APP_VERSION = "1.0.1";
+export const BRAND_NAME = "Ottili ONE";
+export const BRAND_URL = "ottili.one";
+export function formatVersionBanner() {
+    return [APP_NAME, `v. ${APP_VERSION}`, `Powered by ${BRAND_NAME}`, BRAND_URL].join("\n");
+}
+export function formatReplBanner() {
+    return `${APP_NAME} | Powered by ${BRAND_NAME} | ${BRAND_URL}`;
+}
+//# sourceMappingURL=branding.js.map

package/dist/utils/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/utils/branding.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AAEtC,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,QAAQ,EAAE,MAAM,WAAW,EAAE,EAAE,cAAc,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC,IAAI,CAChF,IAAI,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,QAAQ,iBAAiB,UAAU,MAAM,SAAS,EAAE,CAAC;AACjE,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class AiCmdError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, cause?: unknown);
+}
+export declare class ConfigurationError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ProviderError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ResponseValidationError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ExecutionPolicyError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ExecutionError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ClipboardError extends AiCmdError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class UserCancelledError extends AiCmdError {
+    constructor(message?: string);
+}
+export declare function getErrorMessage(error: unknown, debug?: boolean): string;

package/dist/utils/errors.js

@@ -0,0 +1,59 @@
+export class AiCmdError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause ? { cause } : undefined);
+        this.name = this.constructor.name;
+        this.code = code;
+    }
+}
+export class ConfigurationError extends AiCmdError {
+    constructor(message, cause) {
+        super("CONFIG_ERROR", message, cause);
+    }
+}
+export class ProviderError extends AiCmdError {
+    constructor(message, cause) {
+        super("PROVIDER_ERROR", message, cause);
+    }
+}
+export class ResponseValidationError extends AiCmdError {
+    constructor(message, cause) {
+        super("RESPONSE_VALIDATION_ERROR", message, cause);
+    }
+}
+export class ExecutionPolicyError extends AiCmdError {
+    constructor(message, cause) {
+        super("EXECUTION_POLICY_ERROR", message, cause);
+    }
+}
+export class ExecutionError extends AiCmdError {
+    constructor(message, cause) {
+        super("EXECUTION_ERROR", message, cause);
+    }
+}
+export class ClipboardError extends AiCmdError {
+    constructor(message, cause) {
+        super("CLIPBOARD_ERROR", message, cause);
+    }
+}
+export class UserCancelledError extends AiCmdError {
+    constructor(message = "Operation cancelled by user.") {
+        super("USER_CANCELLED", message);
+    }
+}
+export function getErrorMessage(error, debug = false) {
+    if (error instanceof AiCmdError) {
+        if (debug && error.cause) {
+            return `${error.message}\nCause: ${String(error.cause)}`;
+        }
+        return error.message;
+    }
+    if (error instanceof Error) {
+        if (debug && error.stack) {
+            return error.stack;
+        }
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IAEtB,YAAmB,IAAY,EAAE,OAAe,EAAE,KAAe;QAC/D,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,2BAA2B,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,wBAAwB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAmB,OAAe,EAAE,KAAe;QACjD,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAmB,OAAO,GAAG,8BAA8B;QACzD,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,KAAK,GAAG,KAAK;IAC3D,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,KAAK,CAAC,OAAO,YAAY,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,5 @@
+export declare class Logger {
+    private readonly enabled;
+    constructor(enabled: boolean);
+    debug(message: string, data?: unknown): void;
+}

package/dist/utils/logger.js

@@ -0,0 +1,14 @@
+export class Logger {
+    enabled;
+    constructor(enabled) {
+        this.enabled = enabled;
+    }
+    debug(message, data) {
+        if (!this.enabled) {
+            return;
+        }
+        const payload = data === undefined ? "" : ` ${JSON.stringify(data, null, 2)}`;
+        process.stderr.write(`[debug] ${message}${payload}\n`);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,MAAM;IACmB;IAApC,YAAoC,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD,KAAK,CAAC,OAAe,EAAE,IAAc;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GACX,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,GAAG,OAAO,IAAI,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/utils/strings.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeText(value: string): string;
+export declare function normalizeOptionalList(values: string[] | undefined): string[] | undefined;
+export declare function stripMarkdownCodeFence(input: string): string;
+export declare function extractFirstJsonObject(input: string): string;
+export declare function hasMultipleCommandLines(command: string): boolean;

package/dist/utils/strings.js

@@ -0,0 +1,30 @@
+export function normalizeText(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+export function normalizeOptionalList(values) {
+    if (!values || values.length === 0) {
+        return undefined;
+    }
+    const items = values
+        .map((value) => normalizeText(value))
+        .filter((value, index, array) => value.length > 0 && array.indexOf(value) === index);
+    return items.length > 0 ? items : undefined;
+}
+export function stripMarkdownCodeFence(input) {
+    return input
+        .replace(/^```(?:json)?\s*/i, "")
+        .replace(/\s*```$/i, "")
+        .trim();
+}
+export function extractFirstJsonObject(input) {
+    const start = input.indexOf("{");
+    const end = input.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start) {
+        return input.trim();
+    }
+    return input.slice(start, end + 1).trim();
+}
+export function hasMultipleCommandLines(command) {
+    return command.split(/\r?\n/).filter((line) => line.trim().length > 0).length > 1;
+}
+//# sourceMappingURL=strings.js.map

package/dist/utils/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA4B;IAE5B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM;SACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IAEvF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,KAAK;SACT,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACpF,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "ai-cmd",
+  "version": "1.0.1",
+  "description": "Natural-language shell command generation with safe execution for Unix-like terminals.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ottili ONE",
+  "homepage": "https://github.com/Ottili-ONE/ai-cmd",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ottili-ONE/ai-cmd.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Ottili-ONE/ai-cmd/issues"
+  },
+  "keywords": [
+    "cli",
+    "shell",
+    "terminal",
+    "ai",
+    "commands",
+    "developer-tools"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "ai": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx src/cli/index.ts",
+    "lint": "eslint .",
+    "format": "prettier --check .",
+    "format:write": "prettier --write .",
+    "test": "node ./scripts/run-vitest.mjs",
+    "test:watch": "vitest",
+    "publish:variants": "node ./scripts/publish-variants.mjs"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "clipboardy": "^4.0.0",
+    "commander": "^13.1.0",
+    "execa": "^9.5.2",
+    "jsonrepair": "^3.13.0",
+    "prompts": "^2.4.2",
+    "shell-quote": "^1.8.3",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.23.0",
+    "@types/node": "^22.13.13",
+    "@types/prompts": "^2.4.9",
+    "@types/shell-quote": "^1.7.5",
+    "eslint": "^9.23.0",
+    "globals": "^16.0.0",
+    "prettier": "^3.5.3",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.28.0",
+    "vitest": "^3.0.9"
+  }
+}