agentloom 0.1.5 → 0.1.6

package/dist/core/commands.js

@@ -1,16 +1,116 @@
 import fs from "node:fs";
 import path from "node:path";
-import { listMarkdownFiles, slugify } from "./fs.js";
+import TOML from "@iarna/toml";
+import matter from "gray-matter";
+import YAML from "yaml";
+import { isObject, listMarkdownFiles, slugify } from "./fs.js";
+import { ALL_PROVIDERS } from "../types.js";
 export function parseCommandsDir(commandsDir) {
     if (!fs.existsSync(commandsDir))
         return [];
     return listMarkdownFiles(commandsDir)
         .sort((a, b) => a.localeCompare(b))
-        .map((sourcePath) => ({
-        fileName: path.basename(sourcePath),
-        sourcePath,
-        content: fs.readFileSync(sourcePath, "utf8"),
-    }));
+        .map((sourcePath) => {
+        const content = fs.readFileSync(sourcePath, "utf8");
+        const fileName = path.basename(sourcePath);
+        const parsed = parseCommandContent(content);
+        return {
+            fileName,
+            sourcePath,
+            content,
+            body: parsed.body,
+            frontmatter: parsed.frontmatter,
+        };
+    });
+}
+export function parseCommandContent(content) {
+    const parsed = matter(content);
+    if (isObject(parsed.data) &&
+        Object.keys(parsed.data).length > 0) {
+        return {
+            body: parsed.content.trimStart(),
+            frontmatter: parsed.data,
+        };
+    }
+    return {
+        body: content,
+    };
+}
+export function getCommandProviderConfig(command, provider) {
+    if (!command.frontmatter)
+        return {};
+    const value = command.frontmatter[provider];
+    if (value === false)
+        return null;
+    if (isObject(value))
+        return value;
+    return {};
+}
+export function isCommandProviderEnabled(command, provider) {
+    return getCommandProviderConfig(command, provider) !== null;
+}
+export function renderCommandForProvider(command, provider) {
+    if (!isCommandProviderEnabled(command, provider)) {
+        return null;
+    }
+    const providerConfig = getCommandProviderConfig(command, provider);
+    if (providerConfig === null) {
+        return null;
+    }
+    const body = command.frontmatter ? command.body : command.content;
+    const normalizedBody = normalizeCommandArgumentsForProvider(body, provider);
+    const frontmatter = buildProviderCommandFrontmatter(command, providerConfig);
+    if (provider === "gemini") {
+        return buildGeminiCommandToml(frontmatter, normalizedBody);
+    }
+    if (Object.keys(frontmatter).length === 0) {
+        return normalizedBody;
+    }
+    const fm = YAML.stringify(frontmatter, { lineWidth: 0 }).trimEnd();
+    return `---\n${fm}\n---\n\n${normalizedBody.trimStart()}${normalizedBody.endsWith("\n") ? "" : "\n"}`;
+}
+function buildGeminiCommandToml(frontmatter, body) {
+    const payload = {
+        ...frontmatter,
+        prompt: body.endsWith("\n") ? body : `${body}\n`,
+    };
+    return TOML.stringify(payload);
+}
+function buildProviderCommandFrontmatter(command, providerConfig) {
+    return {
+        ...getSharedCommandMetadata(command.frontmatter),
+        ...providerConfig,
+    };
+}
+function getSharedCommandMetadata(frontmatter) {
+    if (!frontmatter)
+        return {};
+    const shared = {};
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (ALL_PROVIDERS.includes(key))
+            continue;
+        shared[key] = value;
+    }
+    return shared;
+}
+const COMMAND_ARGUMENT_PLACEHOLDER_BY_PROVIDER = {
+    copilot: "${input:args}",
+    gemini: "{{args}}",
+};
+export function normalizeCommandArgumentsForProvider(body, provider) {
+    const providerPlaceholder = COMMAND_ARGUMENT_PLACEHOLDER_BY_PROVIDER[provider];
+    if (!providerPlaceholder || providerPlaceholder === "$ARGUMENTS") {
+        return body;
+    }
+    return body.replace(/\$ARGUMENTS\b/g, providerPlaceholder);
+}
+export function normalizeCommandArgumentsForCanonical(body, provider) {
+    const providerPlaceholder = COMMAND_ARGUMENT_PLACEHOLDER_BY_PROVIDER[provider];
+    if (!providerPlaceholder || providerPlaceholder === "$ARGUMENTS") {
+        return body;
+    }
+    const escapedPlaceholder = providerPlaceholder.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return body.replace(new RegExp(escapedPlaceholder, "g"), "$ARGUMENTS");
 }
 export function stripCommandFileExtension(fileName) {
     const lower = fileName.toLowerCase();

package/dist/core/copy.js

@@ -8,7 +8,7 @@ Usage:
   agentloom <entity> <verb> [options]
 
 Aggregate commands:
-  add <source>               Import agents/commands/mcp/skills from a source
+  add <source>               Import agents/commands/mcp/rules/skills from a source
   init                       Bootstrap canonical files, migrate providers, then sync
   find <query>               Search remote + local entities
   update [source]            Refresh lockfile-managed imports
@@ -20,6 +20,7 @@ Entity commands:
   agent <add|list|delete|find|update|sync>
   command <add|list|delete|find|update|sync>
   mcp <add|list|delete|find|update|sync>
+  rule <add|list|delete|find|update|sync>
   skill <add|list|delete|find|update|sync>
 
 MCP manual server commands:
@@ -35,6 +36,8 @@ Common options:
   --agents <csv>             Agent selectors for add/delete
   --commands <csv>           Command selectors for add/delete
   --mcps <csv>               MCP selectors for add/delete
+  --rule <csv>               Alias for --rules
+  --rules <csv>              Rule selectors for add/delete
   --skills <csv>             Skill selectors for add/delete
   --selection-mode <mode>    Add mode: all (default) or custom
   --source <value>           Explicit source filter for update/delete
@@ -46,6 +49,7 @@ Examples:
   agentloom agent add farnoodma/agents --agents issue-creator
   agentloom command add farnoodma/agents --commands review
   agentloom mcp add farnoodma/agents --mcps browser
+  agentloom rule add farnoodma/agents --rules always-test
   agentloom skill add farnoodma/agents --skills pr-review
   agentloom update
   agentloom command update farnoodma/agents
@@ -58,7 +62,7 @@ export function getFindHelpText() {
 
 Usage:
   agentloom find <query>
-  agentloom <agent|command|mcp|skill> find <query>
+  agentloom <agent|command|mcp|rule|skill> find <query>
 
 Examples:
   agentloom find reviewer
@@ -70,7 +74,8 @@ export function getAddHelpText() {
 
 Source discovery:
   agents: .agents/agents -> agents
-  commands: .agents/commands -> commands -> prompts
+  commands: .agents/commands -> commands -> prompts -> (.github/prompts + .gemini/commands fallback)
+  rules: .agents/rules -> rules
   skills: .agents/skills -> skills -> root SKILL.md
 
 Usage:
@@ -82,6 +87,8 @@ Options:
   --agents <name>            Import selected agents (repeatable/csv)
   --commands <name>          Import selected commands (repeatable/csv)
   --mcps <name>              Import selected MCP servers (repeatable/csv)
+  --rule <name>              Alias for --rules
+  --rules <name>             Import selected rules (repeatable/csv)
   --skills <name>            Import selected skills (repeatable/csv)
   --selection-mode <mode>    all|sync-all (include future items) or custom (pin selection)
   --rename <name>            Rename imported item for single-item add flows
@@ -100,7 +107,7 @@ export function getUpdateHelpText() {
 
 Usage:
   agentloom update [source] [options]
-  agentloom <agent|command|mcp|skill> update [source] [options]
+  agentloom <agent|command|mcp|rule|skill> update [source] [options]
 
 Options:
   --source <value>           Explicit source filter
@@ -131,7 +138,7 @@ export function getSyncHelpText() {
 
 Usage:
   agentloom sync [options]
-  agentloom <agent|command|mcp|skill> sync [options]
+  agentloom <agent|command|mcp|rule|skill> sync [options]
 
 Options:
   --local | --global         Choose canonical scope (interactive prompts when omitted)

package/dist/core/importer.d.ts

@@ -20,6 +20,11 @@ export interface ImportOptions {
     requireMcp?: boolean;
     mcpSelectors?: string[];
     promptForMcp?: boolean;
+    importRules?: boolean;
+    requireRules?: boolean;
+    ruleSelectors?: string[];
+    promptForRules?: boolean;
+    ruleRenameMap?: Record<string, string>;
     importSkills?: boolean;
     requireSkills?: boolean;
     skillSelectors?: string[];
@@ -38,7 +43,12 @@ export interface ImportSummary {
     importedAgents: string[];
     importedCommands: string[];
     importedMcpServers: string[];
+    importedRules: string[];
     importedSkills: string[];
+    telemetryRules?: Array<{
+        name: string;
+        filePath: string;
+    }>;
     telemetrySkills?: Array<{
         name: string;
         filePath: string;