@a1st/aix 0.0.3

package/dist/commands/add/prompt.js

@@ -0,0 +1,196 @@
+import { Args, Flags } from '@oclif/core';
+import { resolve } from 'pathe';
+import { BaseCommand } from '../../base-command.js';
+import { installAfterAdd, formatInstallResults } from '../../lib/install-helper.js';
+import { buildGitHubUrl, buildProviderUrl, getLocalConfigPath, inferNameFromPath, isGenericGitUrl, isLocalPath, loadPrompt, parseGitHubBlobUrl, parseGitHubRepoUrl, parseGitShorthand, updateConfig, updateLocalConfig, } from '@a1st/aix-core';
+import { localFlag } from '../../flags/local.js';
+const PROMPT_EXTENSIONS = ['.md', '.prompt.md', '.txt'];
+/**
+ * Detect source type and parse into a structured prompt reference.
+ * Returns a string shorthand when possible, object when metadata is needed.
+ */
+function parseSource(source, refOverride) {
+    // Local file paths - return string shorthand
+    if (isLocalPath(source)) {
+        return {
+            value: source,
+            inferredName: inferNameFromPath(source, PROMPT_EXTENSIONS),
+        };
+    }
+    // GitHub web URL with /blob/branch/path
+    const ghBlob = parseGitHubBlobUrl(source);
+    if (ghBlob) {
+        return {
+            value: {
+                git: {
+                    url: buildGitHubUrl(ghBlob.owner, ghBlob.repo),
+                    ref: refOverride ?? ghBlob.ref,
+                    path: ghBlob.path,
+                },
+            },
+            inferredName: inferNameFromPath(ghBlob.path, PROMPT_EXTENSIONS),
+        };
+    }
+    // GitHub repo URL (no blob path)
+    const ghRepo = parseGitHubRepoUrl(source);
+    if (ghRepo) {
+        const gitRef = {
+            url: buildGitHubUrl(ghRepo.owner, ghRepo.repo),
+        };
+        if (refOverride) {
+            gitRef.ref = refOverride;
+        }
+        return {
+            value: { git: gitRef },
+            inferredName: ghRepo.repo,
+        };
+    }
+    // Git shorthand: github:user/repo/path#ref
+    const shorthand = parseGitShorthand(source);
+    if (shorthand) {
+        const gitUrl = buildProviderUrl(shorthand.provider, shorthand.user, shorthand.repo), effectiveRef = refOverride ?? shorthand.ref, gitRefObj = { url: gitUrl };
+        if (effectiveRef) {
+            gitRefObj.ref = effectiveRef;
+        }
+        if (shorthand.subpath) {
+            gitRefObj.path = shorthand.subpath;
+        }
+        return {
+            value: { git: gitRefObj },
+            inferredName: shorthand.subpath
+                ? inferNameFromPath(shorthand.subpath, PROMPT_EXTENSIONS)
+                : shorthand.repo,
+        };
+    }
+    // Generic https git URL - return string shorthand
+    if (isGenericGitUrl(source)) {
+        if (refOverride) {
+            return {
+                value: { git: { url: source, ref: refOverride } },
+                inferredName: inferNameFromPath(source.replace(/\.git$/, ''), PROMPT_EXTENSIONS),
+            };
+        }
+        return {
+            value: source,
+            inferredName: inferNameFromPath(source.replace(/\.git$/, ''), PROMPT_EXTENSIONS),
+        };
+    }
+    // Treat as inline prompt content
+    return {
+        value: { content: source },
+        inferredName: undefined,
+    };
+}
+export default class AddPrompt extends BaseCommand {
+    static description = 'Add a prompt/command to ai.json';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> ./prompts/review.md --name review',
+        '<%= config.bin %> <%= command.id %> https://github.com/org/prompts/blob/main/review.md --name review',
+        '<%= config.bin %> <%= command.id %> "Review code for issues" --name review',
+        '<%= config.bin %> <%= command.id %> github:myorg/prompts/code-review.md#main --name code-review',
+        '<%= config.bin %> <%= command.id %> ./review.md --name review -d "Code review checklist" -a "[file]"',
+        '<%= config.bin %> <%= command.id %> ./review.md --name review --no-install',
+    ];
+    static args = {
+        source: Args.string({
+            description: 'Prompt content, local file path, or git URL',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...localFlag,
+        name: Flags.string({
+            char: 'n',
+            description: 'Prompt name (inferred from source if not provided)',
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'Description shown in command picker',
+        }),
+        'argument-hint': Flags.string({
+            char: 'a',
+            description: 'Hint for arguments (e.g., "[file] [message]")',
+        }),
+        ref: Flags.string({
+            char: 'r',
+            description: 'Git ref (branch, tag, commit) - overrides ref in URL',
+        }),
+        'no-install': Flags.boolean({
+            description: 'Skip installing to editors after adding',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AddPrompt), loaded = await this.loadConfig(), parsed = parseSource(args.source, flags.ref), promptName = flags.name ?? parsed.inferredName;
+        if (!promptName) {
+            this.error('Could not infer prompt name from source. Please provide --name.');
+        }
+        // Build the prompt value
+        let promptValue = parsed.value;
+        // Add metadata if provided (convert string shorthand to object if needed)
+        if (flags.description || flags['argument-hint']) {
+            if (typeof promptValue === 'string') {
+                // Convert string shorthand to object form
+                promptValue = { path: promptValue };
+            }
+            if (flags.description) {
+                promptValue = { ...promptValue, description: flags.description };
+            }
+            if (flags['argument-hint']) {
+                promptValue = { ...promptValue, argumentHint: flags['argument-hint'] };
+            }
+        }
+        // Validate the source is accessible BEFORE updating ai.json
+        // This prevents adding broken references to the config
+        const basePath = loaded?.path ?? resolve(process.cwd(), 'ai.json');
+        try {
+            await loadPrompt(promptName, promptValue, basePath);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`Failed to load prompt: ${message}`);
+        }
+        // Determine target file based on --local flag
+        if (flags.local) {
+            const localPath = loaded ? getLocalConfigPath(loaded.path) : 'ai.local.json';
+            await updateLocalConfig(localPath, (config) => {
+                return {
+                    ...config,
+                    prompts: { ...config.prompts, [promptName]: promptValue },
+                };
+            });
+            this.output.success(`Added prompt "${promptName}" to ai.local.json`);
+        }
+        else {
+            if (!loaded) {
+                this.error('No ai.json found. Run `aix init` to create one, or use --local to write to ai.local.json.');
+            }
+            await updateConfig(loaded.path, (config) => {
+                return {
+                    ...config,
+                    prompts: { ...config.prompts, [promptName]: promptValue },
+                };
+            });
+            this.output.success(`Added prompt "${promptName}"`);
+            // Auto-install to configured editors unless --no-install
+            if (!flags['no-install']) {
+                const installResult = await installAfterAdd({
+                    configPath: loaded.path,
+                    scopes: ['editors'], // prompts are under editors scope
+                });
+                if (installResult.installed) {
+                    this.logInstallResults(formatInstallResults(installResult.results));
+                }
+            }
+        }
+        if (this.flags.json) {
+            this.output.json({
+                action: 'add',
+                type: 'prompt',
+                name: promptName,
+                value: promptValue,
+            });
+        }
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/add/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/commands/add/prompt.ts"],"names":[],"mappings":"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"}

package/dist/commands/add/rule.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AddRule extends BaseCommand<typeof AddRule> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        source: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        activation: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        globs: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ref: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private buildMetadata;
+}
+//# sourceMappingURL=rule.d.ts.map

package/dist/commands/add/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/commands/add/rule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAsHpD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW,CAAC,OAAO,OAAO,CAAC;IAC7D,OAAgB,WAAW,SAA2B;IAEtD,OAAgB,QAAQ,WAMtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;;;MA4BnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkF1B,OAAO,CAAC,aAAa;CAuBvB"}

package/dist/commands/add/rule.js

@@ -0,0 +1,207 @@
+import { Args, Flags } from '@oclif/core';
+import { resolve } from 'pathe';
+import { BaseCommand } from '../../base-command.js';
+import { installAfterAdd, formatInstallResults } from '../../lib/install-helper.js';
+import { buildGitHubUrl, buildProviderUrl, getLocalConfigPath, inferNameFromPath, isGenericGitUrl, isLocalPath, loadRule, parseGitHubRepoUrl, parseGitHubTreeUrl, parseGitShorthand, updateConfig, updateLocalConfig, } from '@a1st/aix-core';
+import { localFlag } from '../../flags/local.js';
+const RULE_EXTENSIONS = ['.md', '.txt'];
+/**
+ * Detect source type and parse into a structured rule reference.
+ * Returns a string shorthand when possible, object when metadata is needed.
+ */
+function parseSource(source, refOverride) {
+    // Local file paths - return string shorthand
+    if (isLocalPath(source)) {
+        return {
+            value: source,
+            inferredName: inferNameFromPath(source, RULE_EXTENSIONS),
+        };
+    }
+    // GitHub web URL with /tree/branch/path
+    const ghTree = parseGitHubTreeUrl(source);
+    if (ghTree) {
+        return {
+            value: {
+                git: {
+                    url: buildGitHubUrl(ghTree.owner, ghTree.repo),
+                    ref: refOverride ?? ghTree.ref,
+                    path: ghTree.subdir,
+                },
+            },
+            inferredName: inferNameFromPath(ghTree.subdir),
+        };
+    }
+    // GitHub repo URL (no tree path)
+    const ghRepo = parseGitHubRepoUrl(source);
+    if (ghRepo) {
+        const gitRef = {
+            url: buildGitHubUrl(ghRepo.owner, ghRepo.repo),
+        };
+        if (refOverride) {
+            gitRef.ref = refOverride;
+        }
+        return {
+            value: { git: gitRef },
+            inferredName: ghRepo.repo,
+        };
+    }
+    // Git shorthand: github:user/repo, github:user/repo/path#ref
+    const shorthand = parseGitShorthand(source);
+    if (shorthand) {
+        const gitUrl = buildProviderUrl(shorthand.provider, shorthand.user, shorthand.repo), effectiveRef = refOverride ?? shorthand.ref, gitRefObj = { url: gitUrl };
+        if (effectiveRef) {
+            gitRefObj.ref = effectiveRef;
+        }
+        if (shorthand.subpath) {
+            gitRefObj.path = shorthand.subpath;
+        }
+        return {
+            value: { git: gitRefObj },
+            inferredName: shorthand.subpath ? inferNameFromPath(shorthand.subpath) : shorthand.repo,
+        };
+    }
+    // Generic https git URL - return string shorthand
+    if (isGenericGitUrl(source)) {
+        if (refOverride) {
+            return {
+                value: { git: { url: source, ref: refOverride } },
+                inferredName: inferNameFromPath(source.replace(/\.git$/, '')),
+            };
+        }
+        return {
+            value: source,
+            inferredName: inferNameFromPath(source.replace(/\.git$/, '')),
+        };
+    }
+    // Treat as inline rule content
+    return {
+        value: { content: source },
+        inferredName: undefined,
+    };
+}
+export default class AddRule extends BaseCommand {
+    static description = 'Add a rule to ai.json';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> "Always use TypeScript for new files" --name typescript-rule',
+        '<%= config.bin %> <%= command.id %> ./rules/coding-standards.md --name coding-standards',
+        '<%= config.bin %> <%= command.id %> https://github.com/anthropics/skills/tree/main/skills/frontend-design --name frontend',
+        '<%= config.bin %> <%= command.id %> github:myorg/rules/typescript#main --name typescript',
+        '<%= config.bin %> <%= command.id %> "Always use TypeScript" --name ts-rule --no-install',
+    ];
+    static args = {
+        source: Args.string({
+            description: 'Rule content, local file path, or git URL',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...localFlag,
+        name: Flags.string({
+            char: 'n',
+            description: 'Rule name (inferred from source if not provided)',
+        }),
+        description: Flags.string({
+            char: 'd',
+            description: 'When the rule should apply (enables auto activation)',
+        }),
+        activation: Flags.string({
+            char: 'a',
+            description: 'Activation mode',
+            options: ['always', 'auto', 'glob', 'manual'],
+            default: 'always',
+        }),
+        globs: Flags.string({
+            char: 'g',
+            description: 'File patterns for glob activation (comma-separated)',
+        }),
+        ref: Flags.string({
+            char: 'r',
+            description: 'Git ref (branch, tag, commit) - overrides ref in URL',
+        }),
+        'no-install': Flags.boolean({
+            description: 'Skip installing to editors after adding',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AddRule), loaded = await this.loadConfig(), parsed = parseSource(args.source, flags.ref), ruleName = flags.name ?? parsed.inferredName;
+        if (!ruleName) {
+            this.error('Could not infer rule name from source. Please provide --name.');
+        }
+        // Build the rule value
+        let ruleValue = parsed.value;
+        // Add metadata if provided (convert string shorthand to object if needed)
+        if (flags.description || flags.activation !== 'always' || flags.globs) {
+            if (typeof ruleValue === 'string') {
+                // Convert string shorthand to object form
+                ruleValue = { path: ruleValue };
+            }
+            ruleValue = { ...ruleValue, ...this.buildMetadata(flags) };
+        }
+        // Validate the source is accessible BEFORE updating ai.json
+        // This prevents adding broken references to the config
+        const basePath = loaded?.path ?? resolve(process.cwd(), 'ai.json');
+        try {
+            await loadRule(ruleName, ruleValue, basePath);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`Failed to load rule: ${message}`);
+        }
+        // Determine target file based on --local flag
+        if (flags.local) {
+            const localPath = loaded ? getLocalConfigPath(loaded.path) : 'ai.local.json';
+            await updateLocalConfig(localPath, (config) => {
+                return {
+                    ...config,
+                    rules: { ...config.rules, [ruleName]: ruleValue },
+                };
+            });
+            this.output.success(`Added rule "${ruleName}" to ai.local.json`);
+        }
+        else {
+            if (!loaded) {
+                this.error('No ai.json found. Run `aix init` to create one, or use --local to write to ai.local.json.');
+            }
+            await updateConfig(loaded.path, (config) => {
+                return {
+                    ...config,
+                    rules: { ...config.rules, [ruleName]: ruleValue },
+                };
+            });
+            this.output.success(`Added rule "${ruleName}"`);
+            // Auto-install to configured editors unless --no-install
+            if (!flags['no-install']) {
+                const installResult = await installAfterAdd({
+                    configPath: loaded.path,
+                    scopes: ['rules'],
+                });
+                if (installResult.installed) {
+                    this.logInstallResults(formatInstallResults(installResult.results));
+                }
+            }
+        }
+        if (this.flags.json) {
+            this.output.json({
+                action: 'add',
+                type: 'rule',
+                name: ruleName,
+                value: ruleValue,
+            });
+        }
+    }
+    buildMetadata(flags) {
+        const metadata = {};
+        if (flags.description) {
+            metadata.description = flags.description;
+        }
+        if (flags.activation && flags.activation !== 'always') {
+            metadata.activation = flags.activation;
+        }
+        if (flags.globs) {
+            metadata.globs = flags.globs.split(',').map((g) => g.trim());
+        }
+        return metadata;
+    }
+}
+//# sourceMappingURL=rule.js.map

package/dist/commands/add/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/commands/add/rule.ts"],"names":[],"mappings":"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"}

package/dist/commands/add/skill.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AddSkill extends BaseCommand<typeof AddSkill> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        source: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ref: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/add/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/commands/add/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAoLpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW,CAAC,OAAO,QAAQ,CAAC;IAC/D,OAAgB,WAAW,SAA4B;IAEvD,OAAgB,QAAQ,WAOtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;MAcnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgE5B"}