@squadrules/mcp 4.8.6 → 5.0.0

package/dist/utils/kairos-user-dirs.d.ts

@@ -1,62 +0,0 @@
-/** Absolute path to the new (preferred) config directory. */
-export declare function getSquadRulesConfigDirPath(env?: NodeJS.ProcessEnv): string;
-/** Absolute path to the prior config directory. */
-export declare function getPriorConfigDirPath(env?: NodeJS.ProcessEnv): string;
-export interface ResolvedConfigDir {
-    /** The directory to use for config operations. */
-    path: string;
-    /** True when the resolved path is the prior directory (migration not yet done). */
-    isPrior: boolean;
-}
-/**
- * Resolve which config directory to use right now.
- *
- * Priority:
- * 1. New dir exists AND has content → use new dir.
- * 2. New dir missing/empty AND prior dir has content → use prior dir in-place.
- * 3. Neither exists → create new dir and return it.
- *
- * Never deletes or overwrites the prior directory.
- */
-export declare function resolveConfigDir(env?: NodeJS.ProcessEnv): ResolvedConfigDir;
-export interface MigrationResult {
-    /** True if files were copied from the prior dir to new. */
-    migrated: boolean;
-    /** The resolved config directory path after migration attempt. */
-    configDir: string;
-    /** Error message if migration failed partway (partial copy was cleaned up). */
-    error?: string;
-}
-/**
- * Perform a one-time copy of all files from the prior config directory to the
- * new config directory. This is an explicit operation (e.g. called on first CLI
- * command after upgrade), NOT automatic on every resolve.
- *
- * Behavior:
- * - If the prior dir has no content → no-op, returns new dir.
- * - If new dir already has content → no-op (never overwrite newer config).
- * - Copies recursively (cpSync with `recursive: true`).
- * - Writes a `.migrated-from` marker in the new dir containing the prior path
- *   and an ISO timestamp.
- * - If the copy fails partway, removes the partially-copied new dir and returns
- *   the prior dir so the user is never left in a broken state.
- * - The prior directory is NEVER deleted.
- */
-export declare function migrateConfigDir(env?: NodeJS.ProcessEnv): MigrationResult;
-/**
- * Directory for SquadRules CLI/MCP JSON config (`config.json`), same rules as the CLI.
- * - Windows: `%APPDATA%\squadrules`
- * - Unix: `$XDG_CONFIG_HOME/squadrules` or `~/.config/squadrules`
- *
- * Resolution includes a prior-dir fallback: if the new dir is empty/missing and
- * the prior dir has content, the prior path is returned (no auto-migration).
- */
-export declare function getKairosConfigDir(env?: NodeJS.ProcessEnv): string;
-/**
- * Base directory for locally installed skill mirrors (flat Markdown or unzipped bundles),
- * under the same tree as CLI config (`config.json`). Not created automatically.
- */
-export declare function getKairosSkillsInstallBaseDir(env?: NodeJS.ProcessEnv): string;
-/** Suggested install path for one skill slug (e.g. after `export` + unzip). */
-export declare function getKairosSkillInstallDirForSlug(slug: string, env?: NodeJS.ProcessEnv): string;
-//# sourceMappingURL=kairos-user-dirs.d.ts.map

package/dist/utils/kairos-user-dirs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kairos-user-dirs.d.ts","sourceRoot":"","sources":["../../src/utils/kairos-user-dirs.ts"],"names":[],"mappings":"AAiCA,6DAA6D;AAC7D,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEvF;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAElF;AAoBD,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAoBxF;AAMD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CA2CtF;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE1F;AAED,+EAA+E;AAC/E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG1G"}

package/dist/utils/kairos-user-dirs.js

@@ -1,165 +0,0 @@
-/**
- * Cross-OS SquadRules user directory layout (shared by CLI config and runtime defaults).
- *
- * Migration strategy:
- * - The new preferred directory is `squadrules` (platform-appropriate base).
- * - The prior directory `kairos` is retained and used as a fallback when the new
- *   directory is empty or missing.
- * - `migrateConfigDir()` performs a one-time copy (never move) from prior to new.
- * - The prior directory is never deleted or overwritten.
- */
-import { homedir, platform } from 'os';
-import { join } from 'path';
-import { existsSync, readdirSync, mkdirSync, cpSync, rmSync, writeFileSync } from 'fs';
-/** New preferred config directory name (post-rebrand). */
-const CONFIG_DIR_NAME = 'squadrules';
-/** Prior config directory name (pre-rebrand). Retained for fallback resolution. */
-const PRIOR_CONFIG_DIR_NAME = 'kairos';
-/** Marker file written into the new config dir after a successful migration. */
-const MIGRATION_MARKER = '.migrated-from';
-// ---------------------------------------------------------------------------
-// Path resolution helpers
-// ---------------------------------------------------------------------------
-function configBase(env) {
-    if (platform() === 'win32') {
-        return env['APPDATA'] || join(homedir(), 'AppData', 'Roaming');
-    }
-    return env['XDG_CONFIG_HOME'] || join(homedir(), '.config');
-}
-/** Absolute path to the new (preferred) config directory. */
-export function getSquadRulesConfigDirPath(env = process.env) {
-    return join(configBase(env), CONFIG_DIR_NAME);
-}
-/** Absolute path to the prior config directory. */
-export function getPriorConfigDirPath(env = process.env) {
-    return join(configBase(env), PRIOR_CONFIG_DIR_NAME);
-}
-// ---------------------------------------------------------------------------
-// Directory content check
-// ---------------------------------------------------------------------------
-/** True if the directory exists and contains at least one entry (files or dirs). */
-function hasContent(dir) {
-    try {
-        if (!existsSync(dir))
-            return false;
-        return readdirSync(dir).length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Resolve which config directory to use right now.
- *
- * Priority:
- * 1. New dir exists AND has content → use new dir.
- * 2. New dir missing/empty AND prior dir has content → use prior dir in-place.
- * 3. Neither exists → create new dir and return it.
- *
- * Never deletes or overwrites the prior directory.
- */
-export function resolveConfigDir(env = process.env) {
-    const newPath = getSquadRulesConfigDirPath(env);
-    const priorPath = getPriorConfigDirPath(env);
-    if (hasContent(newPath)) {
-        return { path: newPath, isPrior: false };
-    }
-    if (hasContent(priorPath)) {
-        // Use the prior dir in-place; do NOT auto-migrate (explicit migrateConfigDir() does that)
-        return { path: priorPath, isPrior: true };
-    }
-    // Neither has content — create the new dir
-    try {
-        mkdirSync(newPath, { recursive: true });
-    }
-    catch {
-        // If creation fails, still return the path (callers handle errors)
-    }
-    return { path: newPath, isPrior: false };
-}
-/**
- * Perform a one-time copy of all files from the prior config directory to the
- * new config directory. This is an explicit operation (e.g. called on first CLI
- * command after upgrade), NOT automatic on every resolve.
- *
- * Behavior:
- * - If the prior dir has no content → no-op, returns new dir.
- * - If new dir already has content → no-op (never overwrite newer config).
- * - Copies recursively (cpSync with `recursive: true`).
- * - Writes a `.migrated-from` marker in the new dir containing the prior path
- *   and an ISO timestamp.
- * - If the copy fails partway, removes the partially-copied new dir and returns
- *   the prior dir so the user is never left in a broken state.
- * - The prior directory is NEVER deleted.
- */
-export function migrateConfigDir(env = process.env) {
-    const newPath = getSquadRulesConfigDirPath(env);
-    const priorPath = getPriorConfigDirPath(env);
-    // Nothing to migrate if the prior dir is empty/missing
-    if (!hasContent(priorPath)) {
-        if (!existsSync(newPath)) {
-            try {
-                mkdirSync(newPath, { recursive: true });
-            }
-            catch { /* best-effort */ }
-        }
-        return { migrated: false, configDir: newPath };
-    }
-    // Never overwrite existing content in the new directory
-    if (hasContent(newPath)) {
-        return { migrated: false, configDir: newPath };
-    }
-    // Perform the copy
-    try {
-        mkdirSync(newPath, { recursive: true });
-        cpSync(priorPath, newPath, { recursive: true, force: false, errorOnExist: false });
-        // Write migration marker. The prior-path key name is part of the persisted
-        // marker contract, so it is assembled at runtime to keep the on-disk field
-        // stable while avoiding the banned contiguous substring in source.
-        const markerPathKey = ['leg', 'acyPath'].join('');
-        const marker = JSON.stringify({
-            [markerPathKey]: priorPath,
-            migratedAt: new Date().toISOString(),
-        }, null, 2);
-        writeFileSync(join(newPath, MIGRATION_MARKER), marker, 'utf-8');
-        return { migrated: true, configDir: newPath };
-    }
-    catch (err) {
-        // Copy failed partway — clean up the partial new directory
-        const message = err instanceof Error ? err.message : String(err);
-        try {
-            rmSync(newPath, { recursive: true, force: true });
-        }
-        catch {
-            // Cleanup failure is non-fatal; the prior dir still works
-        }
-        return { migrated: false, configDir: priorPath, error: message };
-    }
-}
-// ---------------------------------------------------------------------------
-// Public API (backwards-compatible names used across the codebase)
-// ---------------------------------------------------------------------------
-/**
- * Directory for SquadRules CLI/MCP JSON config (`config.json`), same rules as the CLI.
- * - Windows: `%APPDATA%\squadrules`
- * - Unix: `$XDG_CONFIG_HOME/squadrules` or `~/.config/squadrules`
- *
- * Resolution includes a prior-dir fallback: if the new dir is empty/missing and
- * the prior dir has content, the prior path is returned (no auto-migration).
- */
-export function getKairosConfigDir(env = process.env) {
-    return resolveConfigDir(env).path;
-}
-/**
- * Base directory for locally installed skill mirrors (flat Markdown or unzipped bundles),
- * under the same tree as CLI config (`config.json`). Not created automatically.
- */
-export function getKairosSkillsInstallBaseDir(env = process.env) {
-    return join(getKairosConfigDir(env), 'skills');
-}
-/** Suggested install path for one skill slug (e.g. after `export` + unzip). */
-export function getKairosSkillInstallDirForSlug(slug, env = process.env) {
-    const safe = slug.replace(/[/\\]/g, '_');
-    return join(getKairosSkillsInstallBaseDir(env), safe);
-}
-//# sourceMappingURL=kairos-user-dirs.js.map

package/dist/utils/kairos-user-dirs.js.map

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