homingo 0.1.0

package/dist/shard/analyzer.js

@@ -0,0 +1,146 @@
+/**
+ * Heuristic indicators of multi-intent descriptions:
+ * - Multiple semicolons suggest distinct responsibility sections
+ * - Many commas with conjunctions suggest a laundry list of capabilities
+ * - Descriptions over 1024 chars are likely trying to do too much
+ */
+const OVERLOAD_CHAR_THRESHOLD = 1024;
+const MULTI_INTENT_SEMICOLONS = 2;
+const MULTI_INTENT_CLAUSES = 4;
+export class ShardAnalyzer {
+    provider;
+    model;
+    constructor(options) {
+        this.provider = options.provider;
+        this.model = options.model;
+    }
+    /**
+     * Pure logic check — no API calls.
+     * Determines if a skill description is overloaded based on heuristics.
+     */
+    analyzeOverload(skill) {
+        const len = skill.description.length;
+        const reasons = [];
+        // Check character length
+        if (len > OVERLOAD_CHAR_THRESHOLD) {
+            reasons.push(`description is ${len} chars (threshold: ${OVERLOAD_CHAR_THRESHOLD})`);
+        }
+        // Count semicolons as intent separators
+        const semicolonCount = (skill.description.match(/;/g) || []).length;
+        if (semicolonCount >= MULTI_INTENT_SEMICOLONS) {
+            reasons.push(`${semicolonCount} semicolons suggest multiple distinct responsibilities`);
+        }
+        // Count independent clauses (sentences or clauses separated by periods/conjunctions)
+        const sentenceCount = skill.description
+            .split(/[.!]/)
+            .map((s) => s.trim())
+            .filter((s) => s.length > 20).length;
+        if (sentenceCount >= MULTI_INTENT_CLAUSES) {
+            reasons.push(`${sentenceCount} distinct clauses suggest scope overload`);
+        }
+        // Check for "and" + verb patterns suggesting multiple responsibilities
+        const andVerbPattern = /\band\s+(also\s+)?(handles?|processes?|manages?|generates?|creates?|analyzes?)/gi;
+        const andVerbMatches = skill.description.match(andVerbPattern) || [];
+        if (andVerbMatches.length >= 2) {
+            reasons.push(`multiple "and [verb]" patterns suggest combined responsibilities`);
+        }
+        const isOverloaded = reasons.length > 0;
+        return {
+            isOverloaded,
+            reason: isOverloaded ? reasons.join("; ") : "Description is within acceptable scope",
+            descriptionLength: len,
+        };
+    }
+    /**
+     * Uses the configured LLM to analyze the skill and generate a shard plan.
+     * Identifies distinct intents and proposes sub-skills + orchestrator.
+     */
+    async generateShardPlan(skill) {
+        const prompt = `You are an AI skill architect. A skill's description determines how an LLM router selects it. The following skill description is overloaded — it covers too many distinct intents, which causes routing confusion.
+
+SKILL TO SHARD:
+Name: "${skill.name}"
+Description: "${skill.description}"
+
+Analyze the description and:
+1. Identify the distinct intents/responsibilities (2-4 groups)
+2. Propose sub-skills, each focused on one intent group
+3. Generate an orchestrator skill that delegates to the sub-skills
+
+Naming convention:
+- Sub-skills: "${skill.name}-{intent-suffix}" (e.g., "${skill.name}-analysis", "${skill.name}-generation")
+- Orchestrator: "${skill.name}-orchestrator"
+
+Requirements for each sub-skill:
+- Description must be under 512 characters
+- Include 1-3 negative triggers ("Does NOT handle...")
+- Each sub-skill should be clearly distinct from the others
+
+Requirements for the orchestrator:
+- Description explains it delegates to the sub-skills
+- Lists what each sub-skill handles
+- Include negative triggers for tasks none of the sub-skills handle
+
+Return JSON only. No markdown fences, no preamble.
+{
+  "identifiedIntents": ["intent1 description", "intent2 description"],
+  "subSkills": [
+    {
+      "name": "skill-name-suffix",
+      "description": "focused description under 512 chars",
+      "intents": ["which intents this covers"],
+      "negativeTriggers": ["Does NOT handle X"]
+    }
+  ],
+  "orchestrator": {
+    "name": "skill-name-orchestrator",
+    "description": "orchestrator description",
+    "intents": ["delegates to sub-skills for all intents"],
+    "negativeTriggers": ["Does NOT handle X directly"]
+  }
+}`;
+        const { text } = await this.provider.createMessage({
+            model: this.model,
+            maxTokens: 2048,
+            messages: [{ role: "user", content: prompt }],
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Failed to parse shard plan response: ${text.slice(0, 200)}`);
+        }
+        // Validate response structure
+        if (!parsed.identifiedIntents ||
+            !parsed.subSkills ||
+            !parsed.orchestrator ||
+            parsed.subSkills.length < 2) {
+            throw new Error("Invalid shard plan: need at least 2 sub-skills");
+        }
+        const subSkills = parsed.subSkills.map((s) => ({
+            name: s.name,
+            description: s.description,
+            role: "sub-skill",
+            intents: s.intents,
+            negativeTriggers: s.negativeTriggers || [],
+        }));
+        const orchestrator = {
+            name: parsed.orchestrator.name,
+            description: parsed.orchestrator.description,
+            role: "orchestrator",
+            intents: parsed.orchestrator.intents,
+            negativeTriggers: parsed.orchestrator.negativeTriggers || [],
+        };
+        const overloadResult = this.analyzeOverload(skill);
+        return {
+            originalSkill: skill,
+            reason: overloadResult.reason,
+            descriptionLength: skill.description.length,
+            identifiedIntents: parsed.identifiedIntents,
+            subSkills,
+            orchestrator,
+        };
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/shard/analyzer.js.map

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

package/dist/shard/writer.d.ts

@@ -0,0 +1,11 @@
+import type { ShardPlan } from "../types.js";
+export interface WriteResult {
+    filesWritten: string[];
+}
+/**
+ * Writes shard plan to disk as SKILL.md files.
+ * Creates one directory per sub-skill + one for the orchestrator.
+ * Does NOT delete the original skill — the user does that manually.
+ */
+export declare function writeShardPlan(plan: ShardPlan, outputDir: string): WriteResult;
+//# sourceMappingURL=writer.d.ts.map

package/dist/shard/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/shard/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAc9E"}

package/dist/shard/writer.js

@@ -0,0 +1,53 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Writes shard plan to disk as SKILL.md files.
+ * Creates one directory per sub-skill + one for the orchestrator.
+ * Does NOT delete the original skill — the user does that manually.
+ */
+export function writeShardPlan(plan, outputDir) {
+    const filesWritten = [];
+    // Write each sub-skill
+    for (const subSkill of plan.subSkills) {
+        const filePath = writeSkillFile(subSkill, outputDir);
+        filesWritten.push(filePath);
+    }
+    // Write the orchestrator
+    const orchestratorPath = writeSkillFile(plan.orchestrator, outputDir);
+    filesWritten.push(orchestratorPath);
+    return { filesWritten };
+}
+function writeSkillFile(skill, outputDir) {
+    const skillDir = join(outputDir, skill.name);
+    mkdirSync(skillDir, { recursive: true });
+    const negativeTriggerLines = skill.negativeTriggers.length > 0
+        ? `\n${skill.negativeTriggers.map((t) => `- ${t}`).join("\n")}\n`
+        : "";
+    const roleLabel = skill.role === "orchestrator" ? "Orchestrator" : "Sub-skill";
+    const titleName = skill.name
+        .split("-")
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+    const content = `---
+name: ${skill.name}
+description: "${escapeYamlString(skill.description)}"
+---
+
+# ${titleName}
+
+${skill.description}
+
+## Role
+${roleLabel}
+
+## Intents
+${skill.intents.map((i) => `- ${i}`).join("\n")}
+${negativeTriggerLines ? `\n## Negative Triggers${negativeTriggerLines}` : ""}`;
+    const filePath = join(skillDir, "SKILL.md");
+    writeFileSync(filePath, content);
+    return filePath;
+}
+function escapeYamlString(str) {
+    return str.replace(/"/g, '\\"');
+}
+//# sourceMappingURL=writer.js.map

package/dist/shard/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/shard/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,SAAiB;IAC/D,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,uBAAuB;IACvB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,yBAAyB;IACzB,MAAM,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACtE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAEpC,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAmB,EAAE,SAAiB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,oBAAoB,GACxB,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC/B,CAAC,CAAC,KAAK,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACjE,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;SACzB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,OAAO,GAAG;QACV,KAAK,CAAC,IAAI;gBACF,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;;;IAG/C,SAAS;;EAEX,KAAK,CAAC,WAAW;;;EAGjB,SAAS;;;EAGT,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EAC7C,oBAAoB,CAAC,CAAC,CAAC,yBAAyB,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAE9E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC5C,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/skills/parser.d.ts

@@ -0,0 +1,3 @@
+import type { Skill } from "../types.js";
+export declare function parseSkills(skillsDir: string): Promise<Skill[]>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/skills/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAezC,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CA0CrE"}

package/dist/skills/parser.js

@@ -0,0 +1,48 @@
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { resolve, dirname, basename, join } from "node:path";
+import matter from "gray-matter";
+function findSkillFiles(dir) {
+    const results = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...findSkillFiles(fullPath));
+        }
+        else if (entry.name === "SKILL.md") {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+export async function parseSkills(skillsDir) {
+    const resolvedDir = resolve(skillsDir);
+    if (!existsSync(resolvedDir)) {
+        throw new Error(`Skills directory not found: ${resolvedDir}`);
+    }
+    const skillFiles = findSkillFiles(resolvedDir);
+    if (skillFiles.length === 0) {
+        throw new Error(`No SKILL.md files found in ${resolvedDir}\n` +
+            "Expected structure: <skills-dir>/<skill-name>/SKILL.md");
+    }
+    const skills = [];
+    const warnings = [];
+    for (const filePath of skillFiles) {
+        const raw = readFileSync(filePath, "utf-8");
+        const { data } = matter(raw);
+        const name = data.name || basename(dirname(filePath));
+        const description = data.description || "";
+        if (!description) {
+            warnings.push(`Warning: ${name} has no description (${filePath})`);
+        }
+        skills.push({
+            name,
+            description,
+            filePath,
+        });
+    }
+    if (warnings.length > 0) {
+        console.warn(warnings.join("\n"));
+    }
+    return skills;
+}
+//# sourceMappingURL=parser.js.map

package/dist/skills/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAE/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,IAAI;YAC3C,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE3C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,wBAAwB,QAAQ,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export interface Skill {
+    name: string;
+    description: string;
+    filePath: string;
+    examples?: string[];
+}
+export interface PromptGeneratorInput {
+    targetSkill: Skill;
+    competingSkill: Skill;
+    count: number;
+}
+export interface GeneratedPrompt {
+    id: string;
+    text: string;
+    expectedSkill: string;
+    targetPair: [string, string];
+    ambiguityReason: string;
+}
+export interface RoutingDecision {
+    promptId: string;
+    promptText: string;
+    selectedSkill: string;
+    expectedSkill: string;
+    isCorrect: boolean;
+    confidence: "high" | "medium" | "low";
+    reasoning: string;
+}
+export interface PairConflictReport {
+    skillA: string;
+    skillB: string;
+    promptsTested: number;
+    routingAccuracy: number;
+    severityLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    misroutes: RoutingDecision[];
+    fragileCorrects: RoutingDecision[];
+    topFailurePattern: string;
+    recommendedAction: string;
+}
+export interface FleetAuditReport {
+    generatedAt: string;
+    modelUsed: string;
+    totalSkills: number;
+    totalPairsTested: number;
+    estimatedFleetErrorRate: number;
+    criticalPairs: PairConflictReport[];
+    highPairs: PairConflictReport[];
+    mediumPairs: PairConflictReport[];
+    lowPairs: PairConflictReport[];
+    topFiveOffenders: string[];
+    exportPath: string;
+}
+export interface ShardedSkill {
+    name: string;
+    description: string;
+    role: "sub-skill" | "orchestrator";
+    intents: string[];
+    negativeTriggers: string[];
+}
+export interface ShardPlan {
+    originalSkill: Skill;
+    reason: string;
+    descriptionLength: number;
+    identifiedIntents: string[];
+    subSkills: ShardedSkill[];
+    orchestrator: ShardedSkill;
+}
+export interface HomingoConfig {
+    anthropicApiKey?: string;
+    openaiApiKey?: string;
+    model: string;
+    skillsDir: string;
+    shadowRouter: {
+        promptsPerPair: number;
+        minPrompts: number;
+        accuracyThreshold: number;
+        maxIterations: number;
+    };
+    output: {
+        reportDir: string;
+        format: "json" | "markdown" | "both";
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,2 @@
+export declare function pMap<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, concurrency: number): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/utils/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA,wBAAsB,IAAI,CAAC,CAAC,EAAE,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAed"}

package/dist/utils/concurrency.js

@@ -0,0 +1,14 @@
+export async function pMap(items, fn, concurrency) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < items.length) {
+            const index = nextIndex++;
+            results[index] = await fn(items[index], index);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,KAAU,EACV,EAA0C,EAC1C,WAAmB;IAEnB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,UAAU,MAAM;QACnB,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,7 @@
+export interface RetryOptions {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AA8BD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/utils/retry.js

@@ -0,0 +1,44 @@
+const DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        // Rate limits, overloaded, network errors
+        if (msg.includes("rate") || msg.includes("429") || msg.includes("overloaded"))
+            return true;
+        if (msg.includes("529") || msg.includes("500") || msg.includes("503"))
+            return true;
+        if (msg.includes("econnreset") || msg.includes("etimedout") || msg.includes("fetch failed"))
+            return true;
+    }
+    // Check for status code on Anthropic API errors
+    const err = error;
+    if (err.status === 429 || err.status === 529 || err.status === 500 || err.status === 503)
+        return true;
+    return false;
+}
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_RETRY, ...options };
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (attempt === opts.maxRetries || !isRetryable(error)) {
+                throw error;
+            }
+            const delay = Math.min(opts.baseDelayMs * Math.pow(2, attempt), opts.maxDelayMs);
+            const jitter = delay * (0.5 + Math.random() * 0.5);
+            await sleep(jitter);
+        }
+    }
+    // Unreachable, but satisfies TypeScript
+    throw new Error("Retry exhausted");
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAMA,MAAM,aAAa,GAAiB;IAClC,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,0CAA0C;QAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3F,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnF,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;YACzF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,MAAM,GAAG,GAAG,KAA4B,CAAC;IACzC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QACtF,OAAO,IAAI,CAAC;IAEd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAiC,EAAE;IAEnC,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IAE9C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACrC,CAAC"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "homingo",
+  "version": "0.1.0",
+  "description": "Homingo — the homing instinct for your AI skills. Detect, diagnose, and fix routing drift.",
+  "type": "module",
+  "license": "BUSL-1.1",
+  "author": "Ravi Y.",
+  "homepage": "https://github.com/homingo/homingo.github.io.git#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/homingo/homingo.github.io.git"
+  },
+  "bugs": {
+    "url": "https://github.com/homingo/homingo.github.io/issues"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "routing",
+    "drift",
+    "lint",
+    "audit",
+    "llm",
+    "cli",
+    "devtools"
+  ],
+  "bin": {
+    "homingo": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "husky",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@inquirer/prompts": "^8.3.0",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "dotenv": "^17.3.1",
+    "gray-matter": "^4.0.3",
+    "openai": "^6.27.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.13.0",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.3.3",
+    "prettier": "^3.8.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.57.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}