@augmentcode/ag-redux-toolkit
Version:
Redux + Saga state management for Svelte apps — designed for AI agents. Includes runtime TypeScript source, AI skills, and reference documentation for robust, observable, high-performance state management.
120 lines (101 loc) • 4.04 kB
JavaScript
import { realpathSync } from "node:fs";
import { fileURLToPath, pathToFileURL } from "node:url";
import { cleanupSkillsFromProject } from "./cleanup-skills.mjs";
import { installIntentSkillGuidance, supportedSkillInstallTargets } from "./postinstall.mjs";
const binaryName = "ag-redux-toolkit";
function installSkillsCommandHelp() {
return [
"install-skills",
"install-skills:all",
...supportedSkillInstallTargets.filter((target) => target !== "all").map((target) => `install-skills:${target}`),
].join(", ");
}
function getSkillInstallTarget(command) {
if (command === "install-skills") return "all";
if (!command.startsWith("install-skills:")) return undefined;
const skillInstallTarget = command.slice("install-skills:".length);
return supportedSkillInstallTargets.includes(skillInstallTarget) ? skillInstallTarget : undefined;
}
export function helpText(name = binaryName) {
return `Usage:
${name} <command> [options]
Commands:
install-skills Copy all packaged AI skills into .agents/skills/ag-redux-toolkit/
install-skills:all Alias for install-skills
install-skills:core Copy root setup/core AI skills into .agents/skills/ag-redux-toolkit/
install-skills:react Copy root setup/core/react AI skills into .agents/skills/ag-redux-toolkit/
install-skills:svelte Copy root setup/core/svelte AI skills into .agents/skills/ag-redux-toolkit/
install-skills:streaming Copy root setup/core/streaming AI skills into .agents/skills/ag-redux-toolkit/
cleanup-skills Remove package-installed skills from .agents/skills/ag-redux-toolkit/
help Show this help text
Installed app invocation examples:
./node_modules/.bin/${name} help
npm exec -- ${name} cleanup-skills
npx ${name} install-skills
npx ${name} install-skills:react
Source checkout invocation:
node scripts/cli.mjs help
If npm package invocation is silent, verify the installed bin exists at
./node_modules/.bin/${name}; source checkouts are not linked automatically.
`;
}
export async function runCli(argv = process.argv.slice(2), options = {}) {
const {
cleanup = cleanupSkillsFromProject,
cwd = process.cwd,
install = installIntentSkillGuidance,
logger = console,
stderr = process.stderr,
stdout = process.stdout,
} = options;
const [command] = argv;
if (!command || command === "help" || command === "--help" || command === "-h") {
stdout.write(helpText());
return 0;
}
const skillInstallTarget = getSkillInstallTarget(command);
if (skillInstallTarget) {
try {
const installOptions = { projectRoot: cwd(), logger };
if (skillInstallTarget !== "all") installOptions.skillInstallTarget = skillInstallTarget;
install(installOptions);
} catch (error) {
logger.warn(`[ag-redux-toolkit] ${command} warning: ${error.message}`);
}
return 0;
}
if (command.startsWith("install-skills:")) {
stderr.write(`[ag-redux-toolkit] Unknown install-skills target: ${command.slice("install-skills:".length)}\n`);
stdout.write(`Supported install-skills commands: ${installSkillsCommandHelp()}\n\n`);
stdout.write(helpText());
return 1;
}
if (command === "cleanup-skills") {
try {
cleanup({ projectRoot: cwd(), logger });
} catch (error) {
logger.warn(`[ag-redux-toolkit] cleanup-skills warning: ${error.message}`);
}
return 0;
}
stderr.write(`[ag-redux-toolkit] Unknown command: ${command}\n\n`);
stdout.write(helpText());
return 1;
}
export function isCliEntrypoint(metaUrl = import.meta.url, argvPath = process.argv[1]) {
if (!argvPath) return false;
try {
return realpathSync(fileURLToPath(metaUrl)) === realpathSync(argvPath);
} catch {
return metaUrl === pathToFileURL(argvPath).href;
}
}
if (isCliEntrypoint()) {
try {
process.exit(await runCli());
} catch (error) {
console.error(`[ag-redux-toolkit] ${error instanceof Error ? error.message : String(error)}`);
process.exit(1);
}
}