@getfrontline/cli 1.0.0

package/dist/max/maxConfig.d.ts

@@ -0,0 +1,31 @@
+export interface MaxProfileConfig {
+    /**
+     * Per-user API key used as Bearer for Max REST calls and shared with the
+     * Frontline CLI store under the same profile name. This is the primary
+     * credential now that the browser SSO flow is paused.
+     */
+    apiKey?: string;
+    /**
+     * Firebase ID token produced by the (currently disabled) hosted login page.
+     * Kept optional so previously saved profiles keep working until the SSO
+     * flow is re-enabled.
+     */
+    idToken?: string;
+    /** Optional refresh token if the web app returns it. */
+    refreshToken?: string;
+    /**
+     * Optional override for Public API root (…/public/v1). Prefer storing baseUrl
+     * on the Frontline profile; this field is legacy / max-only override.
+     */
+    apiBaseUrl?: string;
+    /** Last used Max conversation (for `max "..."` default). */
+    lastConversationId?: number;
+}
+export declare function getMaxCurrentProfile(): string;
+export declare function setMaxCurrentProfile(name: string): void;
+export declare function getMaxProfile(name?: string): MaxProfileConfig | undefined;
+export declare function setMaxProfile(name: string, config: MaxProfileConfig): void;
+export declare function updateMaxProfile(name: string, patch: Partial<MaxProfileConfig>): void;
+export declare function deleteMaxProfile(name: string): void;
+export declare function getMaxConfigPath(): string;
+//# sourceMappingURL=maxConfig.d.ts.map

package/dist/max/maxConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxConfig.d.ts","sourceRoot":"","sources":["../../src/max/maxConfig.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAeD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAI1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAKrF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/max/maxConfig.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMaxCurrentProfile = getMaxCurrentProfile;
+exports.setMaxCurrentProfile = setMaxCurrentProfile;
+exports.getMaxProfile = getMaxProfile;
+exports.setMaxProfile = setMaxProfile;
+exports.updateMaxProfile = updateMaxProfile;
+exports.deleteMaxProfile = deleteMaxProfile;
+exports.getMaxConfigPath = getMaxConfigPath;
+const conf_1 = __importDefault(require("conf"));
+const store = new conf_1.default({
+    projectName: "max-cli",
+    defaults: {
+        currentProfile: "default",
+        profiles: {},
+    },
+});
+function getMaxCurrentProfile() {
+    return store.get("currentProfile");
+}
+function setMaxCurrentProfile(name) {
+    store.set("currentProfile", name);
+}
+function getMaxProfile(name) {
+    const profileName = name ?? getMaxCurrentProfile();
+    return store.get("profiles")[profileName];
+}
+function setMaxProfile(name, config) {
+    const profiles = store.get("profiles");
+    profiles[name] = config;
+    store.set("profiles", profiles);
+}
+function updateMaxProfile(name, patch) {
+    const profiles = store.get("profiles");
+    const existing = profiles[name];
+    profiles[name] = { ...(existing ?? {}), ...patch };
+    store.set("profiles", profiles);
+}
+function deleteMaxProfile(name) {
+    const profiles = store.get("profiles");
+    delete profiles[name];
+    store.set("profiles", profiles);
+}
+function getMaxConfigPath() {
+    return store.path;
+}
+//# sourceMappingURL=maxConfig.js.map

package/dist/max/maxConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxConfig.js","sourceRoot":"","sources":["../../src/max/maxConfig.ts"],"names":[],"mappings":";;;;;AAuCA,oDAEC;AAED,oDAEC;AAED,sCAGC;AAED,sCAIC;AAED,4CAKC;AAED,4CAIC;AAED,4CAEC;AAzED,gDAAwB;AA+BxB,MAAM,KAAK,GAAG,IAAI,cAAI,CAAe;IACjC,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE;QACN,cAAc,EAAE,SAAS;QACzB,QAAQ,EAAE,EAAE;KACf;CACJ,CAAC,CAAC;AAEH,SAAgB,oBAAoB;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAY;IAC7C,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,aAAa,CAAC,IAAa;IACvC,MAAM,WAAW,GAAG,IAAI,IAAI,oBAAoB,EAAE,CAAC;IACnD,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY,EAAE,MAAwB;IAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY,EAAE,KAAgC;IAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAK,EAAuB,CAAC,EAAE,GAAG,KAAK,EAAsB,CAAC;IAC7F,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,gBAAgB;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC;AACtB,CAAC"}

package/dist/max/ui/banner.d.ts

@@ -0,0 +1,3 @@
+export declare function printFrontlineLogo(): Promise<void>;
+export declare function printMaxWelcome(): Promise<void>;
+//# sourceMappingURL=banner.d.ts.map

package/dist/max/ui/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/max/ui/banner.ts"],"names":[],"mappings":"AAsEA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBxD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAOrD"}

package/dist/max/ui/banner.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printFrontlineLogo = printFrontlineLogo;
+exports.printMaxWelcome = printMaxWelcome;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// eslint-disable-next-line @typescript-eslint/consistent-type-imports
+const package_json_1 = __importDefault(require("../../../package.json"));
+function getCandidateLogoPaths() {
+    const fromEnv = process.env.MAX_CLI_LOGO_PATH?.trim() ||
+        process.env.FRONTLINE_CLI_LOGO_PATH?.trim() ||
+        process.env.FRONTLINE_LOGO_PATH?.trim();
+    const candidates = [];
+    if (fromEnv)
+        candidates.push(fromEnv);
+    // Bundled: packages/cli/assets/logo3.png (published via package.json "files")
+    // __dirname = dist/max/ui → three levels up = package root.
+    candidates.push(path_1.default.join(__dirname, "..", "..", "..", "assets", "logo3.png"));
+    candidates.push(path_1.default.join(process.cwd(), "assets", "logo3.png"));
+    return candidates;
+}
+function resolveBundledLogoPath() {
+    for (const p of getCandidateLogoPaths()) {
+        try {
+            if (fs_1.default.existsSync(p))
+                return p;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+/** Text fallback when PNG inline rendering is not supported (typical on Windows conhost / PowerShell). */
+function printAsciiLogo() {
+    // Fallback banner (matches the Frontline mark in plain text terminals).
+    // Keep as a single template literal to preserve spacing.
+    const art = `                                                                                  
+                        @@@@@@@@@@@@@@@@@@@@@@            
+                     @@@@@@@@@@@@@@@@@@@@@@@@             
+                   @@@@@@@@@@@@@@@@@@@@@@@@@@             
+                  @@@@@@@@@@@@@@@@@@@@@@@@@@              
+                 @@@@@@@@@@@@@@@@@@@@@@@@@@@              
+                                                          
+                                                          
+                   @@@@@@@@@@@@@@@@@@                     
+                @@@@@@@@@@@@@@@@@@@@@                     
+               @@@@@@@@@@@@@@@@@@@@@                      
+              @@@@@@@@@@@@@@@@@@@@@@                      
+              @@@@@@@@@@@@@@@@@@@@@                       
+             @@@@@@@@@@                                   
+             @@@@@@@@@                                                                                                                                                                                                   
+`;
+    console.log(chalk_1.default.white(art));
+}
+async function tryRenderPngLogo(logoPath) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const terminalImage = require("terminal-image");
+        const buf = fs_1.default.readFileSync(logoPath);
+        const out = await terminalImage.buffer(buf, { width: 28 });
+        if (typeof out === "string" && out.trim().length > 0)
+            return out;
+    }
+    catch {
+        // Unsupported terminal or render failure — use ASCII below.
+    }
+    return null;
+}
+async function printFrontlineLogo() {
+    const logoPath = resolveBundledLogoPath();
+    let rendered = false;
+    if (logoPath) {
+        const png = await tryRenderPngLogo(logoPath);
+        if (png) {
+            console.log(png);
+            rendered = true;
+        }
+    }
+    if (!rendered) {
+        // Always show a visible “logo” on terminals that cannot render PNG (most Windows defaults).
+        printAsciiLogo();
+    }
+}
+async function printMaxWelcome() {
+    await printFrontlineLogo();
+    console.log(chalk_1.default.bold.white("Welcome to Max CLI"));
+    console.log(chalk_1.default.gray(`Version: ${package_json_1.default.version}`));
+    console.log(chalk_1.default.gray("Sign in to chat with Max from your terminal."));
+    console.log();
+}
+//# sourceMappingURL=banner.js.map

package/dist/max/ui/banner.js.map

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

package/dist/max.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=max.d.ts.map

package/dist/max.d.ts.map

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

package/dist/max.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const login_1 = require("./max/commands/auth/login");
+const logout_1 = require("./max/commands/auth/logout");
+const whoami_1 = require("./max/commands/auth/whoami");
+const send_1 = require("./max/commands/chat/send");
+const repl_1 = require("./max/commands/chat/repl");
+const output_1 = require("./lib/output");
+const maxConfig_1 = require("./max/maxConfig");
+const helpEpilog_1 = require("./lib/helpEpilog");
+const conversations_1 = require("./max/commands/conversations");
+const pkg = require("../package.json");
+const program = new commander_1.Command();
+program
+    .name("max")
+    .description("Max CLI — authenticate with a per-user API key (shared with the Frontline CLI) and call Max on the Public API (/public/v1/max/...). Base URL from env, profile, or --base-url.")
+    .version(pkg.version ?? "0.0.0")
+    .addHelpText("after", `\n${helpEpilog_1.MAX_CLI_EPILOG}\n`);
+const authCmd = new commander_1.Command("auth").description("Max session: save per-user API key, clear credentials, show current profile");
+authCmd.addCommand(login_1.maxLoginCommand);
+authCmd.addCommand(logout_1.maxLogoutCommand);
+authCmd.addCommand(whoami_1.maxWhoamiCommand);
+program.addCommand(authCmd);
+const chatCmd = new commander_1.Command("chat")
+    .description("Send messages to Max on the Public API (Bearer = per-user API key; base URL from env, profile, or --base-url — see `max --help`)")
+    .addHelpText("after", `\nAuth: max auth login <api-key>. URL: see \`max --help\` (REST).\n`)
+    .action(async () => {
+    // Default behavior: interactive mode
+    await repl_1.maxChatReplCommand.parseAsync(process.argv, { from: "user" });
+});
+chatCmd.addCommand(send_1.maxSendCommand);
+chatCmd.addCommand(repl_1.maxChatReplCommand);
+program.addCommand(chatCmd);
+program.addCommand(conversations_1.maxConversationsCommand);
+program
+    .command("config-path")
+    .description("Print where Max CLI stores its config")
+    .action(() => {
+    console.log((0, maxConfig_1.getMaxConfigPath)());
+});
+// Root default action: `max "Hello"` or `max --new "Hello"`
+program
+    .argument("[message...]", "Message to send to Max")
+    .option("--new", "Start a new conversation")
+    .option("--conversation <id>", "Conversation id to use")
+    .option("--profile <name>", helpEpilog_1.MAX_PROFILE_OPTION)
+    .option("--base-url <url>", helpEpilog_1.MAX_BASE_URL_OPTION)
+    .option("--api-base-url <url>", "Deprecated alias for --base-url (Public API root)")
+    .option("--api-key <key>", "Override per-user API key for this run")
+    .option("--pretty", "Print assistant message from `data` instead of one-line JSON")
+    .option("--json", "Print only the POST response JSON (no polling)")
+    .option("--debug", "Show debug information")
+    .option("--no-wait", "Do not poll for assistant reply")
+    .option("--timeout <seconds>", "Polling timeout in seconds", "60")
+    .action(async (messageParts, options) => {
+    if (!messageParts || messageParts.length === 0) {
+        program.help();
+        return;
+    }
+    await (0, send_1.runMaxSend)(messageParts, {
+        new: Boolean(options.new),
+        conversation: options.conversation ? String(options.conversation) : undefined,
+        profile: options.profile ? String(options.profile) : undefined,
+        baseUrl: options.baseUrl ? String(options.baseUrl) : undefined,
+        apiBaseUrl: options.apiBaseUrl ? String(options.apiBaseUrl) : undefined,
+        apiKey: options.apiKey ? String(options.apiKey) : undefined,
+        json: Boolean(options.json),
+        pretty: Boolean(options.pretty),
+        debug: Boolean(options.debug),
+        wait: options.wait !== false,
+        timeout: options.timeout ? String(options.timeout) : undefined,
+        chatMode: false,
+    });
+});
+program.exitOverride();
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message !== "(outputHelp)") {
+            const code = err.code;
+            if (code === "commander.helpDisplayed" || code === "commander.version") {
+                return;
+            }
+            (0, output_1.printError)(err.message);
+            process.exitCode = 1;
+        }
+    }
+}
+main();
+//# sourceMappingURL=max.js.map

package/dist/max.js.map

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

package/dist/scripts/postinstall.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export declare function copySkills(options?: {
+    force?: boolean;
+}): {
+    copied: string[];
+    skipped: string[];
+};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/scripts/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../src/scripts/postinstall.ts"],"names":[],"mappings":";AAiEA,wBAAgB,UAAU,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB,CA+BA"}

package/dist/scripts/postinstall.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copySkills = copySkills;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const SKILL_DIRS = [
+    // Public API: high-level Frontline Public API workflows (agents, workflows, billing, raw GET)
+    "frontline-agents",
+    "frontline-workflows",
+    "frontline-billing",
+    "frontline-api",
+    // Max CLI: Firebase-authenticated chat / admin REST
+    "max-chat",
+    "max-auth",
+    // Table / Object CRUD: data modelling, records, fields, relations, aggregations
+    "auth-and-profiles",
+    "crm-setup",
+    "crud-operations",
+    "pipeline-setup",
+    "schema-design",
+    "resource-creation",
+    "record-type-management",
+    "relations",
+    "filter-and-query",
+    "files",
+    "notes-and-tasks",
+    "export-and-delete",
+    "aggregations",
+];
+function getClaudeBaseDir() {
+    return process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+}
+function isClaudeInPath() {
+    try {
+        (0, child_process_1.execFileSync)("claude", ["--version"], {
+            timeout: 5000,
+            stdio: "ignore",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isClaudeDirPresent() {
+    try {
+        return fs.statSync(getClaudeBaseDir()).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function detectClaudeCode() {
+    return isClaudeInPath() || isClaudeDirPresent();
+}
+function getSkillsSourceDir() {
+    // __dirname = dist/scripts/ at runtime, skills are copied to dist/skills/
+    return path.resolve(__dirname, "..", "skills");
+}
+function copySkills(options = {}) {
+    const sourceBase = getSkillsSourceDir();
+    const targetBase = path.join(getClaudeBaseDir(), "skills");
+    const copied = [];
+    const skipped = [];
+    for (const skillDir of SKILL_DIRS) {
+        const src = path.join(sourceBase, skillDir, "SKILL.md");
+        const destDir = path.join(targetBase, skillDir);
+        const dest = path.join(destDir, "SKILL.md");
+        if (!fs.existsSync(src)) {
+            skipped.push(skillDir);
+            continue;
+        }
+        if (!options.force && fs.existsSync(dest)) {
+            const content = fs.readFileSync(dest, "utf-8").trim();
+            if (content.length > 0) {
+                skipped.push(skillDir);
+                continue;
+            }
+        }
+        fs.mkdirSync(destDir, { recursive: true });
+        fs.copyFileSync(src, dest);
+        copied.push(skillDir);
+    }
+    return { copied, skipped };
+}
+function main() {
+    if (!detectClaudeCode()) {
+        console.log("\n@frontline/cli: Claude Code not detected.\n" +
+            'Run "frontline setup --claude-skills" to install skills manually.\n');
+        return;
+    }
+    try {
+        const { copied, skipped } = copySkills();
+        if (copied.length > 0) {
+            console.log(`\n@frontline/cli: Installed ${copied.length} Claude Code skill(s) to ${path.join(getClaudeBaseDir(), "skills")}/`);
+            for (const s of copied)
+                console.log(`  + ${s}`);
+        }
+        if (skipped.length > 0) {
+            console.log(`  Skipped ${skipped.length} (already present): ${skipped.join(", ")}`);
+        }
+        if (copied.length > 0 || skipped.length > 0) {
+            console.log('  Use "frontline setup --claude-skills --force" to overwrite existing skills.\n');
+        }
+    }
+    catch (err) {
+        console.warn(`@frontline/cli: Could not install Claude Code skills: ${err instanceof Error ? err.message : err}`);
+    }
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=postinstall.js.map

package/dist/scripts/postinstall.js.map

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

package/dist/skills/aggregations/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: aggregations
+description: >
+    How to create, update, delete, and compute aggregations on views
+    using the Frontline CLI. Aggregations are summary statistics 
+    (SUM, AVERAGE, COUNT_FILLED, etc.) attached to view columns.
+allowed-tools: Bash(frontline:*)
+---
+
+# Aggregations
+
+Aggregations are summary statistics attached to a view's columns. They compute
+values like SUM, AVERAGE, COUNT_FILLED, MIN, MAX across all rows matching the
+current view's filters.
+
+## Available Operations
+
+| Operation        | Applies To     | Description               |
+| ---------------- | -------------- | ------------------------- |
+| `COUNT_EMPTY`    | Any column     | Count of empty/null cells |
+| `COUNT_FILLED`   | Any column     | Count of non-empty cells  |
+| `PERCENT_EMPTY`  | Any column     | % of empty cells          |
+| `PERCENT_FILLED` | Any column     | % of non-empty cells      |
+| `SUM`            | Number columns | Sum of all values         |
+| `AVERAGE`        | Number columns | Average of all values     |
+| `MIN`            | Number/Date    | Minimum value             |
+| `MAX`            | Number/Date    | Maximum value             |
+
+## Prerequisites
+
+You need a **view ID** and a **column ID**. Get both from:
+
+```bash
+# Get object/table detail (includes views with their IDs)
+frontline object get <object>
+
+# Get fields (includes column IDs)
+frontline object field list <object>
+```
+
+## List Aggregations
+
+```bash
+frontline object aggregation list <object> <view-id>
+frontline table aggregation list <table> <view-id>
+```
+
+## Create an Aggregation
+
+```bash
+# SUM on a number column
+frontline object aggregation create <object> <view-id> \
+  --data '{"columnId": 5, "operation": "SUM"}'
+
+# COUNT_FILLED on any column
+frontline object aggregation create <object> <view-id> \
+  --data '{"columnId": 3, "operation": "COUNT_FILLED"}'
+
+# COUNT_FILLED scoped to a specific tag (option) ID — useful in kanban views
+frontline object aggregation create <object> <view-id> \
+  --data '{"columnId": 8, "operation": "COUNT_FILLED", "tagId": 12}'
+```
+
+## Update an Aggregation
+
+Change the operation of an existing aggregation:
+
+```bash
+frontline object aggregation update <object> <view-id> <agg-id> \
+  --data '{"operation": "AVERAGE"}'
+```
+
+## Delete an Aggregation
+
+```bash
+frontline object aggregation delete <object> <view-id> <agg-id>
+```
+
+## Compute Aggregation Values
+
+Compute the actual numeric results for all aggregations on a view.
+Optionally filter with a query or search:
+
+```bash
+# Compute all aggregations
+frontline object aggregation compute <object> <view-id>
+
+# Compute with a filter
+frontline object aggregation compute <object> <view-id> \
+  --query '{"path":"[Status]","operator":"containsAny","value":[3]}'
+
+# Compute for a specific column only
+frontline object aggregation compute <object> <view-id> --column-id 5
+```
+
+---
+
+## Typical Workflow
+
+```bash
+# 1. Identify the view and columns
+frontline object get sor__deals
+# → view ID = 1
+frontline object field list sor__deals
+# → Amount column ID = 5, Status column ID = 8
+
+# 2. Add aggregations
+frontline object aggregation create sor__deals 1 \
+  --data '{"columnId": 5, "operation": "SUM"}'
+frontline object aggregation create sor__deals 1 \
+  --data '{"columnId": 5, "operation": "AVERAGE"}'
+frontline object aggregation create sor__deals 1 \
+  --data '{"columnId": 8, "operation": "COUNT_FILLED"}'
+
+# 3. Compute results
+frontline object aggregation compute sor__deals 1
+# → { aggregations: [{ columnId: 5, operation: "SUM", value: 1250000 }, ...] }
+
+# 4. Compute only for "Won" deals
+frontline object aggregation compute sor__deals 1 \
+  --query '{"path":"[Status]","operator":"containsAny","value":[3]}'
+```