jaz-cli 2.3.0 → 2.6.0

package/dist/commands/calc.js

@@ -0,0 +1,252 @@
+import chalk from 'chalk';
+import { calculateLoan } from '../calc/loan.js';
+import { calculateLease } from '../calc/lease.js';
+import { calculateDepreciation } from '../calc/depreciation.js';
+import { calculatePrepaidExpense, calculateDeferredRevenue } from '../calc/amortization.js';
+import { calculateFxReval } from '../calc/fx-reval.js';
+import { calculateEcl } from '../calc/ecl.js';
+import { calculateProvision } from '../calc/provision.js';
+import { calculateFixedDeposit } from '../calc/fixed-deposit.js';
+import { calculateAssetDisposal } from '../calc/asset-disposal.js';
+import { printResult, printJson } from '../calc/format.js';
+import { CalcValidationError } from '../calc/validate.js';
+/** Wrap calc action with validation error handling. */
+function calcAction(fn) {
+    return (opts) => {
+        try {
+            fn(opts);
+        }
+        catch (err) {
+            if (err instanceof CalcValidationError) {
+                console.error(chalk.red(`Error: ${err.message}`));
+                process.exit(1);
+            }
+            throw err;
+        }
+    };
+}
+export function registerCalcCommand(program) {
+    const calc = program
+        .command('calc')
+        .description('Financial calculators — loan, lease, depreciation, prepaid-expense, deferred-revenue, fx-reval, ecl, provision, fixed-deposit, asset-disposal');
+    // ── jaz calc loan ──────────────────────────────────────────────
+    calc
+        .command('loan')
+        .description('Loan amortization schedule')
+        .requiredOption('--principal <amount>', 'Loan principal', parseFloat)
+        .requiredOption('--rate <percent>', 'Annual interest rate (%)', parseFloat)
+        .requiredOption('--term <months>', 'Loan term in months', parseInt)
+        .option('--start-date <date>', 'Start date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateLoan({
+            principal: opts.principal,
+            annualRate: opts.rate,
+            termMonths: opts.term,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc lease ─────────────────────────────────────────────
+    calc
+        .command('lease')
+        .description('IFRS 16 lease schedule (liability unwinding + ROU depreciation). Add --useful-life for hire purchase.')
+        .requiredOption('--payment <amount>', 'Monthly lease payment', parseFloat)
+        .requiredOption('--term <months>', 'Lease term in months', parseInt)
+        .requiredOption('--rate <percent>', 'Incremental borrowing rate (%)', parseFloat)
+        .option('--useful-life <months>', 'Asset useful life in months (hire purchase: depreciate over useful life, not term)', parseInt)
+        .option('--start-date <date>', 'Lease commencement date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateLease({
+            monthlyPayment: opts.payment,
+            termMonths: opts.term,
+            annualRate: opts.rate,
+            usefulLifeMonths: opts.usefulLife,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc depreciation ──────────────────────────────────────
+    calc
+        .command('depreciation')
+        .description('Depreciation schedule (straight-line, double declining, or 150% declining)')
+        .requiredOption('--cost <amount>', 'Asset cost', parseFloat)
+        .requiredOption('--salvage <amount>', 'Salvage value', parseFloat)
+        .requiredOption('--life <years>', 'Useful life in years', parseInt)
+        .option('--method <method>', 'Method: sl, ddb (default), or 150db', 'ddb')
+        .option('--frequency <freq>', 'Frequency: annual (default) or monthly', 'annual')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateDepreciation({
+            cost: opts.cost,
+            salvageValue: opts.salvage,
+            usefulLifeYears: opts.life,
+            method: opts.method,
+            frequency: opts.frequency,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc prepaid-expense ──────────────────────────────────
+    calc
+        .command('prepaid-expense')
+        .description('Prepaid expense recognition schedule (e.g. insurance, rent, subscriptions)')
+        .requiredOption('--amount <amount>', 'Total prepaid amount', parseFloat)
+        .requiredOption('--periods <count>', 'Number of recognition periods', parseInt)
+        .option('--frequency <freq>', 'Frequency: monthly (default) or quarterly', 'monthly')
+        .option('--start-date <date>', 'Start date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculatePrepaidExpense({
+            amount: opts.amount,
+            periods: opts.periods,
+            frequency: opts.frequency,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc deferred-revenue ───────────────────────────────────
+    calc
+        .command('deferred-revenue')
+        .description('Deferred revenue recognition schedule (e.g. annual contracts, retainers)')
+        .requiredOption('--amount <amount>', 'Total deferred amount', parseFloat)
+        .requiredOption('--periods <count>', 'Number of recognition periods', parseInt)
+        .option('--frequency <freq>', 'Frequency: monthly (default) or quarterly', 'monthly')
+        .option('--start-date <date>', 'Start date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateDeferredRevenue({
+            amount: opts.amount,
+            periods: opts.periods,
+            frequency: opts.frequency,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc fx-reval ───────────────────────────────────────────
+    calc
+        .command('fx-reval')
+        .description('FX revaluation — unrealized gain/loss on non-AR/AP foreign currency balances (IAS 21)')
+        .requiredOption('--amount <amount>', 'Foreign currency amount outstanding', parseFloat)
+        .requiredOption('--book-rate <rate>', 'Original booking exchange rate', parseFloat)
+        .requiredOption('--closing-rate <rate>', 'Period-end closing exchange rate', parseFloat)
+        .option('--currency <code>', 'Foreign currency code (e.g. USD)', 'USD')
+        .option('--base-currency <code>', 'Base (functional) currency code (e.g. SGD)', 'SGD')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateFxReval({
+            amount: opts.amount,
+            bookRate: opts.bookRate,
+            closingRate: opts.closingRate,
+            currency: opts.currency,
+            baseCurrency: opts.baseCurrency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc ecl ────────────────────────────────────────────────
+    calc
+        .command('ecl')
+        .description('Expected credit loss provision matrix (IFRS 9 simplified approach)')
+        .requiredOption('--current <amount>', 'Current (not overdue) receivables balance', parseFloat)
+        .requiredOption('--30d <amount>', '1-30 days overdue balance', parseFloat)
+        .requiredOption('--60d <amount>', '31-60 days overdue balance', parseFloat)
+        .requiredOption('--90d <amount>', '61-90 days overdue balance', parseFloat)
+        .requiredOption('--120d <amount>', '91+ days overdue balance', parseFloat)
+        .requiredOption('--rates <rates>', 'Loss rates per bucket (comma-separated %)', (v) => v.split(',').map(Number))
+        .option('--existing-provision <amount>', 'Existing provision balance', parseFloat, 0)
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const rates = opts.rates;
+        const result = calculateEcl({
+            buckets: [
+                { name: 'Current', balance: opts.current, rate: rates[0] },
+                { name: '1-30 days', balance: opts['30d'], rate: rates[1] },
+                { name: '31-60 days', balance: opts['60d'], rate: rates[2] },
+                { name: '61-90 days', balance: opts['90d'], rate: rates[3] },
+                { name: '91+ days', balance: opts['120d'], rate: rates[4] },
+            ],
+            existingProvision: opts.existingProvision,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc provision ──────────────────────────────────────────
+    calc
+        .command('provision')
+        .description('IAS 37 provision PV measurement + discount unwinding schedule')
+        .requiredOption('--amount <amount>', 'Estimated future cash outflow', parseFloat)
+        .requiredOption('--rate <percent>', 'Discount rate (%)', parseFloat)
+        .requiredOption('--term <months>', 'Months until expected settlement', parseInt)
+        .option('--start-date <date>', 'Recognition date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateProvision({
+            amount: opts.amount,
+            annualRate: opts.rate,
+            termMonths: opts.term,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc fixed-deposit ────────────────────────────────────
+    calc
+        .command('fixed-deposit')
+        .description('Fixed deposit interest accrual schedule (IFRS 9 amortized cost)')
+        .requiredOption('--principal <amount>', 'Deposit principal', parseFloat)
+        .requiredOption('--rate <percent>', 'Annual interest rate (%)', parseFloat)
+        .requiredOption('--term <months>', 'Term in months', parseInt)
+        .option('--compound <method>', 'Compounding: none (default), monthly, quarterly, annually', 'none')
+        .option('--start-date <date>', 'Placement date (YYYY-MM-DD)')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateFixedDeposit({
+            principal: opts.principal,
+            annualRate: opts.rate,
+            termMonths: opts.term,
+            compounding: opts.compound,
+            startDate: opts.startDate,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+    // ── jaz calc asset-disposal ───────────────────────────────────
+    calc
+        .command('asset-disposal')
+        .description('Fixed asset disposal — gain/loss calculation (IAS 16)')
+        .requiredOption('--cost <amount>', 'Original asset cost', parseFloat)
+        .requiredOption('--salvage <amount>', 'Salvage value', parseFloat)
+        .requiredOption('--life <years>', 'Useful life in years', parseInt)
+        .requiredOption('--acquired <date>', 'Acquisition date (YYYY-MM-DD)')
+        .requiredOption('--disposed <date>', 'Disposal date (YYYY-MM-DD)')
+        .requiredOption('--proceeds <amount>', 'Disposal proceeds (0 for scrap)', parseFloat)
+        .option('--method <method>', 'Depreciation method: sl (default), ddb, 150db', 'sl')
+        .option('--currency <code>', 'Currency code (e.g. SGD, USD)')
+        .option('--json', 'Output as JSON')
+        .action(calcAction((opts) => {
+        const result = calculateAssetDisposal({
+            cost: opts.cost,
+            salvageValue: opts.salvage,
+            usefulLifeYears: opts.life,
+            acquisitionDate: opts.acquired,
+            disposalDate: opts.disposed,
+            proceeds: opts.proceeds,
+            method: opts.method,
+            currency: opts.currency,
+        });
+        opts.json ? printJson(result) : printResult(result);
+    }));
+}

package/dist/index.js

@@ -6,6 +6,7 @@ import { dirname, join } from 'path';
 import { initCommand } from './commands/init.js';
 import { versionsCommand } from './commands/versions.js';
 import { updateCommand } from './commands/update.js';
+import { registerCalcCommand } from './commands/calc.js';
 import { SKILL_TYPES } from './types/index.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -49,4 +50,5 @@ program
         skill: options.skill,
     });
 });
+registerCalcCommand(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-cli",
-  "version": "2.3.0",
+  "version": "2.6.0",
   "description": "CLI to install Jaz AI skills for Claude Code",
   "type": "module",
   "bin": {
@@ -36,8 +36,9 @@
   "author": "Jaz Engineering <api-support@jaz.ai>",
   "license": "MIT",
   "dependencies": {
-    "commander": "^12.1.0",
     "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "financial": "^0.2.4",
     "ora": "^8.1.1",
     "prompts": "^2.4.2"
   },