jaz-cli 2.6.0 → 2.8.0

package/dist/jobs/year-end.js

@@ -0,0 +1,153 @@
+/**
+ * Year-end close blueprint generator.
+ * Builds on quarter-end phases with additional annual review and audit steps.
+ * Supports standalone (full) and incremental (annual extras only) modes.
+ */
+import { parseYearPeriod } from './validate.js';
+import { generateQuarterEndBlueprint } from './quarter-end.js';
+import { buildSummary } from './types.js';
+/**
+ * Build the annual extras phase (Phase 8).
+ * Year-end only steps: final depreciation, true-ups, dividends, retained
+ * earnings rollover, full-year GST reconciliation, audit prep, and final lock.
+ */
+function buildAnnualExtrasPhase(startDate, endDate, startOrder) {
+    let order = startOrder;
+    const step = (partial) => ({
+        order: ++order,
+        ...partial,
+    });
+    return {
+        name: 'Phase 8: Annual Extras',
+        description: 'Year-end specific adjustments, filings, and audit preparation.',
+        steps: [
+            step({
+                description: 'Final depreciation run for all fixed assets',
+                category: 'verify',
+                recipeRef: 'declining-balance',
+                calcCommand: 'jaz calc depreciation',
+                verification: 'NBV per register matches GL balances',
+                notes: 'Reconcile fixed asset register to general ledger',
+            }),
+            step({
+                description: 'Year-end true-ups (leave, bonus, provisions)',
+                category: 'adjust',
+                recipeRef: 'employee-accruals',
+                notes: 'True-up leave accrual to actual entitlement, bonus accrual to board-approved pool, and provision estimates to year-end reassessment',
+            }),
+            step({
+                description: 'Dividend declaration and payment',
+                category: 'adjust',
+                recipeRef: 'dividend',
+                conditional: 'If declaring dividends',
+                notes: 'Requires board resolution. Record declaration (DR Retained Earnings, CR Dividends Payable) then payment separately.',
+            }),
+            step({
+                description: 'Retained earnings rollover verification',
+                category: 'verify',
+                notes: 'Platform-managed. Verify via equity movement report that opening retained earnings equals prior year closing balance plus current year net income.',
+            }),
+            step({
+                description: 'Final GST/VAT reconciliation for the full year',
+                category: 'verify',
+                apiCall: 'POST /generate-reports/vat-ledger',
+                apiBody: { startDate, endDate },
+                verification: 'Full-year VAT ledger reconciles to quarterly filings',
+                notes: 'Sum of quarterly GST submissions should match full-year ledger totals',
+            }),
+            step({
+                description: 'Audit preparation and documentation',
+                category: 'export',
+                notes: 'See audit-prep job for full detail. Prepare trial balance, aged schedules, bank confirmations, and supporting journals for auditor.',
+            }),
+            step({
+                description: `Set final lock date to ${endDate}`,
+                category: 'lock',
+                notes: `Lock the full financial year by setting the accounting lock date to ${endDate}. No further postings to this year after lock.`,
+            }),
+        ],
+    };
+}
+/**
+ * Build the annual verification phase (Phase 9).
+ * Full-year financial reports for board and statutory filing.
+ */
+function buildAnnualVerificationPhase(startDate, endDate, label, startOrder) {
+    let order = startOrder;
+    const step = (partial) => ({
+        order: ++order,
+        ...partial,
+    });
+    return {
+        name: 'Phase 9: Annual Verification',
+        description: `Full-year financial report review for ${label}.`,
+        steps: [
+            step({
+                description: `Review trial balance for ${label}`,
+                category: 'report',
+                apiCall: 'POST /generate-reports/trial-balance',
+                apiBody: { startDate, endDate },
+                verification: 'Total debits equal total credits',
+            }),
+            step({
+                description: `Generate P&L for ${label}`,
+                category: 'report',
+                apiCall: 'POST /generate-reports/profit-and-loss',
+                apiBody: { primarySnapshotDate: endDate, secondarySnapshotDate: startDate },
+            }),
+            step({
+                description: `Generate balance sheet as at ${endDate}`,
+                category: 'report',
+                apiCall: 'POST /generate-reports/balance-sheet',
+                apiBody: { primarySnapshotDate: endDate },
+                verification: 'Assets = Liabilities + Equity',
+            }),
+        ],
+    };
+}
+/**
+ * Generate a year-end close blueprint.
+ *
+ * @param opts.period       Year in YYYY format (e.g. "2025")
+ * @param opts.currency     Optional base currency code (e.g. "SGD")
+ * @param opts.incremental  If true, generate only the annual extras (skip quarter/month phases)
+ */
+export function generateYearEndBlueprint(opts) {
+    const parsed = parseYearPeriod(opts.period);
+    const mode = opts.incremental ? 'incremental' : 'standalone';
+    const phases = [];
+    if (!opts.incremental) {
+        // Standalone: include quarter-end phases for each of the 4 quarters
+        for (const quarter of parsed.quarters) {
+            const qBp = generateQuarterEndBlueprint({
+                period: `${parsed.year}-Q${quarter.quarter}`,
+                currency: opts.currency,
+                incremental: false,
+            });
+            // Prefix each phase name with the quarter label for clarity
+            for (const phase of qBp.phases) {
+                if (!phase.name.startsWith(quarter.label)) {
+                    phase.name = `${quarter.label} — ${phase.name}`;
+                }
+                phases.push(phase);
+            }
+        }
+    }
+    // Count the highest step order from existing phases
+    const maxOrder = phases.reduce((max, phase) => phase.steps.reduce((m, s) => Math.max(m, s.order), max), 0);
+    // Add annual extras (Phase 8)
+    const extras = buildAnnualExtrasPhase(parsed.startDate, parsed.endDate, maxOrder);
+    phases.push(extras);
+    // Add annual verification (Phase 9)
+    const lastExtraOrder = extras.steps.reduce((max, s) => Math.max(max, s.order), 0);
+    const verification = buildAnnualVerificationPhase(parsed.startDate, parsed.endDate, parsed.label, lastExtraOrder);
+    phases.push(verification);
+    return {
+        jobType: 'year-end-close',
+        period: parsed.label,
+        currency: opts.currency ?? 'SGD',
+        mode,
+        phases,
+        summary: buildSummary(phases),
+    };
+}

package/dist/types/index.js

@@ -1,6 +1,7 @@
-export const SKILL_TYPES = ['api', 'conversion', 'transaction-recipes', 'all'];
+export const SKILL_TYPES = ['api', 'conversion', 'transaction-recipes', 'jobs', 'all'];
 export const SKILL_DESCRIPTIONS = {
     api: 'Jaz/Juan REST API reference — 55 rules, endpoint catalog, error catalog, field mapping',
     conversion: 'Data conversion pipeline — Xero, QuickBooks, Sage, Excel migration to Jaz',
     'transaction-recipes': 'Complex accounting recipes — prepaid, deferred revenue, loans, IFRS 16, depreciation',
+    jobs: 'Accounting job blueprints — month/quarter/year-end close + 7 ad-hoc operational workflows',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaz-cli",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "CLI to install Jaz AI skills for Claude Code",
   "type": "module",
   "bin": {
@@ -13,6 +13,8 @@
   "scripts": {
     "build": "tsc && node --input-type=module -e \"import{readFileSync,writeFileSync}from'fs';const c=readFileSync('dist/index.js','utf8');if(!c.startsWith('#!')){writeFileSync('dist/index.js','#!/usr/bin/env node\\n'+c)}\"",
     "dev": "node --loader ts-node/esm src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -45,6 +47,7 @@
   "devDependencies": {
     "@types/node": "^22.10.1",
     "@types/prompts": "^2.4.9",
-    "typescript": "^5.7.2"
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
   }
 }