faf-cli 4.5.0 → 5.0.0

package/dist/licensing/pro-gate.d.ts

@@ -0,0 +1,54 @@
+/**
+ * FAF Pro Gate — Zero-Friction License System for tri-sync
+ *
+ * Gates: faf ram, faf tri-sync, faf bi-sync --ram/--all
+ * Model: PHPStan Pro — 14-day free trial, no signup, no credit card.
+ *
+ * Flow:
+ *   User runs gated command
+ *     → checkProAccess()
+ *       → isLegacyDev()? → ALLOW
+ *       → hasLicense()? → verify sig → ALLOW
+ *       → hasTrial()? → verify sig → check expiry
+ *         → within 14 days? → ALLOW (hint days left)
+ *         → expired? → BLOCK (upgrade prompt)
+ *       → no trial? → startTrial() → ALLOW
+ */
+export interface TrialState {
+    startedAt: string;
+    expiresAt: string;
+    signature: string;
+}
+export interface LicenseState {
+    key: string;
+    activatedAt: string;
+    email?: string;
+    tier: string;
+    signature: string;
+}
+export type ProReason = 'licensed' | 'trial' | 'trial_expired' | 'no_trial' | 'legacy_dev';
+export interface ProStatus {
+    allowed: boolean;
+    reason: ProReason;
+    daysLeft?: number;
+    justStarted?: boolean;
+}
+export interface ActivationResult {
+    success: boolean;
+    message: string;
+}
+export declare function isLegacyDev(): boolean;
+export declare function startTrial(): TrialState;
+export declare function activateLicense(key: string): ActivationResult;
+export declare function checkProAccess(): ProStatus;
+export declare function gateProFeature(): boolean;
+export declare function getProStatus(): {
+    state: 'licensed' | 'trial' | 'trial_expired' | 'none' | 'legacy_dev';
+    daysLeft?: number;
+    key?: string;
+    tier?: string;
+    trialStarted?: string;
+    trialExpires?: string;
+    activatedAt?: string;
+};
+//# sourceMappingURL=pro-gate.d.ts.map

package/dist/licensing/pro-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pro-gate.d.ts","sourceRoot":"","sources":["../../src/licensing/pro-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA2BH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;AAE3F,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AA6CD,wBAAgB,WAAW,IAAI,OAAO,CAIrC;AAiBD,wBAAgB,UAAU,IAAI,UAAU,CAiBvC;AA0BD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAyB7D;AAMD,wBAAgB,cAAc,IAAI,SAAS,CAyB1C;AAMD,wBAAgB,cAAc,IAAI,OAAO,CAqBxC;AAMD,wBAAgB,YAAY,IAAI;IAC9B,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,MAAM,GAAG,YAAY,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAmCA"}

package/dist/licensing/pro-gate.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * FAF Pro Gate — Zero-Friction License System for tri-sync
+ *
+ * Gates: faf ram, faf tri-sync, faf bi-sync --ram/--all
+ * Model: PHPStan Pro — 14-day free trial, no signup, no credit card.
+ *
+ * Flow:
+ *   User runs gated command
+ *     → checkProAccess()
+ *       → isLegacyDev()? → ALLOW
+ *       → hasLicense()? → verify sig → ALLOW
+ *       → hasTrial()? → verify sig → check expiry
+ *         → within 14 days? → ALLOW (hint days left)
+ *         → expired? → BLOCK (upgrade prompt)
+ *       → no trial? → startTrial() → ALLOW
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLegacyDev = isLegacyDev;
+exports.startTrial = startTrial;
+exports.activateLicense = activateLicense;
+exports.checkProAccess = checkProAccess;
+exports.gateProFeature = gateProFeature;
+exports.getProStatus = getProStatus;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const crypto_1 = __importDefault(require("crypto"));
+const license_messages_1 = require("./license-messages");
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const FAF_DIR = path_1.default.join(os_1.default.homedir(), '.faf');
+const TRIAL_PATH = path_1.default.join(FAF_DIR, 'trial.json');
+const LICENSE_PATH = path_1.default.join(FAF_DIR, 'license.json');
+const LEGACY_LICENSE_PATH = path_1.default.join(FAF_DIR, 'turbo-license.json');
+// ---------------------------------------------------------------------------
+// HMAC Signing (v1 — honest-user guard, not DRM)
+// ---------------------------------------------------------------------------
+const HMAC_SECRET = 'faf-pro-v1-honest-user';
+function sign(payload) {
+    return crypto_1.default.createHmac('sha256', HMAC_SECRET).update(payload).digest('hex');
+}
+function verify(payload, signature) {
+    return sign(payload) === signature;
+}
+// ---------------------------------------------------------------------------
+// File helpers (sync for <10ms)
+// ---------------------------------------------------------------------------
+function ensureFafDir() {
+    if (!fs_1.default.existsSync(FAF_DIR)) {
+        fs_1.default.mkdirSync(FAF_DIR, { recursive: true });
+    }
+}
+function readJSON(filePath) {
+    try {
+        if (!fs_1.default.existsSync(filePath)) {
+            return null;
+        }
+        const raw = fs_1.default.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function writeJSON(filePath, data) {
+    ensureFafDir();
+    fs_1.default.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+// ---------------------------------------------------------------------------
+// Legacy dev check
+// ---------------------------------------------------------------------------
+function isLegacyDev() {
+    const legacy = readJSON(LEGACY_LICENSE_PATH);
+    if (!legacy || !legacy.key) {
+        return false;
+    }
+    return legacy.key.startsWith('FAF-DEV0-');
+}
+// ---------------------------------------------------------------------------
+// Trial management
+// ---------------------------------------------------------------------------
+function readTrial() {
+    const trial = readJSON(TRIAL_PATH);
+    if (!trial) {
+        return null;
+    }
+    // Verify integrity
+    const payload = `${trial.startedAt}:${trial.expiresAt}`;
+    if (!verify(payload, trial.signature)) {
+        return null;
+    }
+    return trial;
+}
+function startTrial() {
+    const now = new Date();
+    const expires = new Date(now);
+    expires.setDate(expires.getDate() + 14);
+    const startedAt = now.toISOString();
+    const expiresAt = expires.toISOString();
+    const payload = `${startedAt}:${expiresAt}`;
+    const trial = {
+        startedAt,
+        expiresAt,
+        signature: sign(payload),
+    };
+    writeJSON(TRIAL_PATH, trial);
+    return trial;
+}
+function trialDaysLeft(trial) {
+    const now = Date.now();
+    const expires = new Date(trial.expiresAt).getTime();
+    const msLeft = expires - now;
+    return Math.max(0, Math.ceil(msLeft / (1000 * 60 * 60 * 24)));
+}
+// ---------------------------------------------------------------------------
+// License management
+// ---------------------------------------------------------------------------
+const LICENSE_KEY_REGEX = /^FAF-PRO-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+function readLicense() {
+    const license = readJSON(LICENSE_PATH);
+    if (!license) {
+        return null;
+    }
+    // Verify integrity
+    const payload = `${license.key}:${license.activatedAt}`;
+    if (!verify(payload, license.signature)) {
+        return null;
+    }
+    return license;
+}
+function activateLicense(key) {
+    const trimmed = key.trim().toUpperCase();
+    if (!LICENSE_KEY_REGEX.test(trimmed)) {
+        return { success: false, message: license_messages_1.MESSAGES.invalidKey };
+    }
+    // Check if already licensed
+    const existing = readLicense();
+    if (existing) {
+        return { success: false, message: license_messages_1.MESSAGES.alreadyLicensed };
+    }
+    const activatedAt = new Date().toISOString();
+    const payload = `${trimmed}:${activatedAt}`;
+    const license = {
+        key: trimmed,
+        activatedAt,
+        tier: 'pro',
+        signature: sign(payload),
+    };
+    writeJSON(LICENSE_PATH, license);
+    return { success: true, message: license_messages_1.MESSAGES.licenseActivated };
+}
+// ---------------------------------------------------------------------------
+// Core gate check
+// ---------------------------------------------------------------------------
+function checkProAccess() {
+    // 1. Legacy dev — always allowed
+    if (isLegacyDev()) {
+        return { allowed: true, reason: 'legacy_dev' };
+    }
+    // 2. Active license
+    const license = readLicense();
+    if (license) {
+        return { allowed: true, reason: 'licensed' };
+    }
+    // 3. Active trial
+    const trial = readTrial();
+    if (trial) {
+        const days = trialDaysLeft(trial);
+        if (days > 0) {
+            return { allowed: true, reason: 'trial', daysLeft: days };
+        }
+        return { allowed: false, reason: 'trial_expired', daysLeft: 0 };
+    }
+    // 4. No trial yet — start one automatically
+    startTrial();
+    return { allowed: true, reason: 'trial', daysLeft: 14, justStarted: true };
+}
+// ---------------------------------------------------------------------------
+// Gate wrapper — call before any Pro feature
+// ---------------------------------------------------------------------------
+function gateProFeature() {
+    const status = checkProAccess();
+    if (!status.allowed) {
+        if (status.reason === 'trial_expired') {
+            (0, license_messages_1.showTrialExpired)();
+        }
+        return false;
+    }
+    // Show contextual messages
+    if (status.reason === 'trial' && status.justStarted) {
+        (0, license_messages_1.showTrialStarted)();
+    }
+    else if (status.reason === 'trial') {
+        (0, license_messages_1.showTrialReminder)(status.daysLeft);
+    }
+    else if (status.reason === 'licensed') {
+        (0, license_messages_1.showLicenseActive)();
+    }
+    // legacy_dev — silent pass
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Status helpers (for `faf pro` command)
+// ---------------------------------------------------------------------------
+function getProStatus() {
+    if (isLegacyDev()) {
+        return { state: 'legacy_dev' };
+    }
+    const license = readLicense();
+    if (license) {
+        return {
+            state: 'licensed',
+            key: license.key,
+            tier: license.tier,
+            activatedAt: license.activatedAt,
+        };
+    }
+    const trial = readTrial();
+    if (trial) {
+        const days = trialDaysLeft(trial);
+        if (days > 0) {
+            return {
+                state: 'trial',
+                daysLeft: days,
+                trialStarted: trial.startedAt,
+                trialExpires: trial.expiresAt,
+            };
+        }
+        return {
+            state: 'trial_expired',
+            daysLeft: 0,
+            trialStarted: trial.startedAt,
+            trialExpires: trial.expiresAt,
+        };
+    }
+    return { state: 'none' };
+}
+//# sourceMappingURL=pro-gate.js.map

package/dist/licensing/pro-gate.js.map

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

package/dist/utils/memory-parser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * MEMORY.md Parser — Claude Code Auto-Memory Interop
+ *
+ * Bidirectional interoperability between FAF and Claude Code's
+ * auto-memory system (~/.claude/projects/<id>/memory/MEMORY.md).
+ *
+ * Key difference from other targets: MEMORY.md lives OUTSIDE the
+ * project root, has a 200-line auto-load ceiling, and must MERGE
+ * (not overwrite) to preserve Claude's own notes.
+ *
+ * Path convention:
+ *   ~/.claude/projects/<project-id>/memory/MEMORY.md
+ *   project-id = absolute path with / replaced by -
+ *   e.g. /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+export interface MemoryMdSection {
+    title: string;
+    content: string;
+}
+export interface MemoryMdFile {
+    fafSection: string | null;
+    claudeNotes: string;
+    totalLines: number;
+}
+export interface MemoryImportResult {
+    success: boolean;
+    warnings: string[];
+    harvested: {
+        patterns: string[];
+        conventions: string[];
+        keyFiles: string[];
+        notes: string[];
+    };
+}
+export interface MemoryExportResult {
+    success: boolean;
+    filePath: string;
+    linesWritten: number;
+    warnings: string[];
+    merged: boolean;
+}
+/**
+ * Compute Claude Code project ID from an absolute path.
+ * Convention: /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+export declare function computeProjectId(projectPath: string): string;
+/**
+ * Get the git repository root for a directory.
+ * Returns null if not in a git repo.
+ */
+export declare function getGitRoot(cwd?: string): string | null;
+/**
+ * Resolve the memory directory for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/
+ */
+export declare function resolveMemoryDir(projectPath: string): string;
+/**
+ * Resolve the full MEMORY.md path for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/MEMORY.md
+ */
+export declare function resolveMemoryPath(projectPath: string): string;
+/**
+ * Parse MEMORY.md into our section and Claude's notes.
+ */
+export declare function parseMemoryMd(content: string): MemoryMdFile;
+/**
+ * Export .faf data to MEMORY.md.
+ * Merge mode (default): replace only our section, preserve Claude's notes.
+ * Force mode: overwrite entire file.
+ */
+export declare function memoryExport(fafContent: any, outputPath: string, options?: {
+    merge?: boolean;
+}): Promise<MemoryExportResult>;
+/**
+ * Import/harvest Claude's notes from MEMORY.md into structured data.
+ * Conservative: only extracts clearly structured entries.
+ */
+export declare function memoryImport(memoryPath: string): Promise<MemoryImportResult>;
+/**
+ * Detect MEMORY.md at Claude's expected path for this project.
+ * Returns the path if found, null otherwise.
+ */
+export declare function detectMemoryMd(projectPath: string): Promise<string | null>;
+/**
+ * Get memory status for display.
+ */
+export declare function getMemoryStatus(projectPath: string): Promise<{
+    exists: boolean;
+    path: string;
+    totalLines: number;
+    fafSectionLines: number;
+    claudeNotesLines: number;
+    hasFafSection: boolean;
+}>;
+//# sourceMappingURL=memory-parser.d.ts.map

package/dist/utils/memory-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-parser.d.ts","sourceRoot":"","sources":["../../src/utils/memory-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA6B3D;AA4GD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAsD7B;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmElF;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAwBD"}