@gurulu/cli 0.4.2 → 0.4.4

package/dist/commands/identity.d.ts

@@ -1,5 +1,8 @@
 /**
  * Phase 19.5 W2 B8 — `gurulu identity decay|transfers|cdc-sources`.
+ *
+ * Sprint E SE-D — `gurulu identity identify|alias|merge` write surface
+ * (mirrors MCP `gurulu.identity.identify` / `.alias` / `.merge`).
  */
 export interface IdentityArgs {
     action?: string;
@@ -7,7 +10,20 @@ export interface IdentityArgs {
     direction?: string;
     status?: string;
     limit?: number;
+    site?: string;
+    userId?: string;
+    email?: string;
+    phone?: string;
+    traits?: string;
+    previousUserId?: string;
+    newUserId?: string;
+    canonicalId?: string;
+    duplicateId?: string;
+    yes?: boolean;
     json?: boolean;
     profile?: string;
+    file?: string;
+    format?: string;
+    resumeFrom?: number;
 }
 export declare function identityCommand(args: IdentityArgs): Promise<void>;

package/dist/commands/identity.js

@@ -1,11 +1,49 @@
 "use strict";
 /**
  * Phase 19.5 W2 B8 — `gurulu identity decay|transfers|cdc-sources`.
+ *
+ * Sprint E SE-D — `gurulu identity identify|alias|merge` write surface
+ * (mirrors MCP `gurulu.identity.identify` / `.alias` / `.merge`).
  */
+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.identityCommand = identityCommand;
 const api_client_1 = require("../api-client");
 const ui_1 = require("../utils/ui");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 async function identityCommand(args) {
     const action = args.action || '';
     switch (action) {
@@ -15,9 +53,17 @@ async function identityCommand(args) {
             return transfersCmd(args);
         case 'cdc-sources':
             return cdcSourcesCmd(args);
+        case 'identify':
+            return identifyCmd(args);
+        case 'alias':
+            return aliasCmd(args);
+        case 'merge':
+            return mergeCmd(args);
+        case 'bulk':
+            return bulkCmd(args);
         default:
             (0, ui_1.error)(`Unknown identity action: ${action}`);
-            (0, ui_1.info)('Usage: gurulu identity [decay stats|transfers list|cdc-sources list]');
+            (0, ui_1.info)('Usage: gurulu identity [decay stats|transfers list|cdc-sources list|identify|alias|merge|bulk]');
             process.exit(1);
     }
 }
@@ -76,6 +122,181 @@ async function transfersCmd(args) {
         ].join('\t') + '\n');
     }
 }
+async function identifyCmd(args) {
+    if (!args.site || !args.userId) {
+        (0, ui_1.error)('Usage: gurulu identity identify --site=<id> --user-id=<id> [--email=...] [--phone=...] [--traits=<json>]');
+        process.exit(1);
+    }
+    let traits;
+    if (args.traits) {
+        try {
+            traits = JSON.parse(args.traits);
+        }
+        catch {
+            (0, ui_1.error)('--traits must be valid JSON');
+            process.exit(1);
+        }
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/identify', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            userId: args.userId,
+            email: args.email,
+            phone: args.phone,
+            traits,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Identified ${args.userId}.`);
+    if (body.canonicalPersonId) {
+        process.stdout.write(`  canonicalPersonId: ${body.canonicalPersonId}\n`);
+    }
+}
+async function aliasCmd(args) {
+    if (!args.site || !args.previousUserId || !args.newUserId) {
+        (0, ui_1.error)('Usage: gurulu identity alias --site=<id> --previous-user-id=<anon> --new-user-id=<u123>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/alias', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            previousUserId: args.previousUserId,
+            newUserId: args.newUserId,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Aliased ${args.previousUserId} → ${args.newUserId}.`);
+}
+/**
+ * `gurulu identity bulk --site=<id> --file=<path> [--format=csv|json]
+ *  [--resume-from=<offset>]`.
+ *
+ * Streams a CSV or JSON file to `/api/ingest/v1/identify/bulk` for
+ * server-side fan-out. The endpoint chunks records server-side (500 per
+ * tx); we only enforce a 10 000-record max here as a friendly preflight.
+ *
+ * `--resume-from` is forwarded as the `x-resume-from` header so a partial
+ * import can pick up where it left off without reuploading the whole
+ * file.
+ */
+async function bulkCmd(args) {
+    if (!args.site || !args.file) {
+        (0, ui_1.error)('Usage: gurulu identity bulk --site=<id> --file=<path> [--format=csv|json] [--resume-from=<offset>]');
+        process.exit(1);
+    }
+    const filePath = path.resolve(args.file);
+    if (!fs.existsSync(filePath)) {
+        (0, ui_1.error)(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    // Auto-detect format from extension when --format is not supplied.
+    let format = (args.format || '').toLowerCase();
+    if (!format) {
+        const ext = path.extname(filePath).slice(1).toLowerCase();
+        format = ext === 'csv' ? 'csv' : 'json';
+    }
+    if (format !== 'csv' && format !== 'json') {
+        (0, ui_1.error)('--format must be csv or json');
+        process.exit(1);
+    }
+    const raw = fs.readFileSync(filePath, 'utf8');
+    let body;
+    let contentType;
+    if (format === 'csv') {
+        contentType = 'text/csv';
+        body = raw;
+    }
+    else {
+        contentType = 'application/json';
+        // Allow files that are either { records: [...] } or a bare array.
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            (0, ui_1.error)(`JSON file is invalid: ${err.message}`);
+            process.exit(1);
+        }
+        const records = Array.isArray(parsed)
+            ? parsed
+            : Array.isArray(parsed?.records)
+                ? parsed.records
+                : null;
+        if (!records) {
+            (0, ui_1.error)('JSON file must be an array or { records: [...] }');
+            process.exit(1);
+        }
+        body = JSON.stringify({ siteId: args.site, records });
+    }
+    const headers = { 'content-type': contentType };
+    if (args.resumeFrom && args.resumeFrom > 0) {
+        headers['x-resume-from'] = String(args.resumeFrom);
+    }
+    const url = `/api/ingest/v1/identify/bulk?site=${encodeURIComponent(args.site)}`;
+    let parsedBody;
+    try {
+        const res = await (0, api_client_1.cliApi)(url, {
+            profile: args.profile,
+            method: 'POST',
+            headers,
+            body,
+        });
+        const text = await res.text();
+        parsedBody = text ? JSON.parse(text) : {};
+        if (!res.ok) {
+            throw new api_client_1.CliApiError(res.status, parsedBody?.error || 'http_error', parsedBody?.message || `HTTP ${res.status}`, parsedBody);
+        }
+    }
+    catch (err) {
+        if (err instanceof api_client_1.CliApiError) {
+            (0, ui_1.error)(`Bulk import failed: ${err.code} (${err.message})`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    if (args.json) {
+        process.stdout.write(JSON.stringify(parsedBody, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Bulk identify done. processed=${parsedBody.processed ?? 0} succeeded=${parsedBody.succeeded ?? 0} failed=${parsedBody.failed ?? 0}`);
+    if (parsedBody.errors && parsedBody.errors.length > 0) {
+        const sample = parsedBody.errors.slice(0, 5);
+        (0, ui_1.info)(`First ${sample.length} error(s):`);
+        for (const e of sample) {
+            process.stdout.write(`  [${e.index}] ${e.message}\n`);
+        }
+    }
+}
+async function mergeCmd(args) {
+    if (!args.site || !args.canonicalId || !args.duplicateId) {
+        (0, ui_1.error)('Usage: gurulu identity merge --site=<id> --canonical-id=<winner> --duplicate-id=<loser>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/merge', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            canonicalId: args.canonicalId,
+            duplicateId: args.duplicateId,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Merged ${args.duplicateId} → ${args.canonicalId}.`);
+}
 async function cdcSourcesCmd(args) {
     if (args.sub && args.sub !== 'list') {
         (0, ui_1.error)(`Unknown identity cdc-sources sub: ${args.sub}`);

package/dist/commands/init.js

@@ -22,7 +22,7 @@ async function initCommand(args) {
     if (!args.framework && !args.noInteractive && framework === 'unknown') {
         console.log('');
         (0, ui_1.warn)('Could not auto-detect framework.');
-        const frameworks = ['nextjs-app', 'nextjs-pages', 'react-vite', 'react-cra', 'vue3', 'nuxt3', 'svelte', 'sveltekit', 'astro', 'express', 'nestjs', 'react-native', 'ios-swift', 'android-kotlin', 'flutter', 'html'];
+        const frameworks = ['nextjs-app', 'nextjs-pages', 'react-vite', 'react-cra', 'vue3', 'nuxt3', 'svelte', 'sveltekit', 'astro', 'express', 'fastify', 'hono', 'nestjs', 'react-native', 'ios-swift', 'android-kotlin', 'flutter', 'html'];
         const idx = await (0, ui_1.promptSelect)('  Select your framework: ', frameworks.map(f => (0, detect_1.getFrameworkDisplayName)(f)));
         framework = frameworks[idx];
         (0, ui_1.info)(`Using: ${(0, ui_1.bold)((0, detect_1.getFrameworkDisplayName)(framework))}`);

package/dist/commands/install.d.ts

@@ -46,7 +46,12 @@ export interface InstallArgs {
      * up with `// TODO: <prop>` placeholders. See Sprint A fix A2.
      */
     authToken?: string;
+    /** Sprint E1.5 — explicit workspace path inside an npm/pnpm/yarn workspace repo. */
+    workspace?: string;
+    /** FA-1 P0-2 — override the tracker tag asset URL (self-hosted ingest). */
+    scriptSrc?: string;
 }
+export declare function resolveWorkspaceRoot(repoRoot: string, args: InstallArgs, deps: InstallDeps): Promise<string>;
 export interface IntentPreSeedResult {
     ok: boolean;
     proposalId?: string;
@@ -143,7 +148,7 @@ export interface InstallSummary {
     framework: string | null;
     planDiff: string;
     filesChanged: number;
-    packageManager: 'pnpm' | 'yarn' | 'npm' | null;
+    packageManager: 'pnpm' | 'yarn' | 'npm' | 'bun' | null;
     packageInstalled: boolean;
     envKeysWritten: string[];
     ingestOk: boolean | null;
@@ -151,6 +156,8 @@ export interface InstallSummary {
     verify: VerifyResult | null;
     rolledBack: boolean;
     errors: string[];
+    partiallyInstalled?: boolean;
+    installedComponents?: string[];
     intent?: {
         skipped: boolean;
         dryRun: boolean;
@@ -184,13 +191,14 @@ export interface InstallSummary {
  * or as a bundled package; falls back to GURULU_SCRIPTS_DIR env override).
  */
 export declare function resolveScriptsDir(startDir?: string): string;
-export declare function detectPackageManager(repoRoot: string): 'pnpm' | 'yarn' | 'npm';
-export declare function packageInstallArgs(pm: 'pnpm' | 'yarn' | 'npm'): string[];
+export declare function detectPackageManager(repoRoot: string): 'pnpm' | 'yarn' | 'npm' | 'bun';
+export declare function packageInstallArgs(pm: 'pnpm' | 'yarn' | 'npm' | 'bun'): string[];
 export interface EnvMergeResult {
     file: string;
     added: string[];
     skipped: string[];
 }
+export declare function parseEnvFile(text: string): Set<string>;
 export declare function mergeEnvFile(repoRoot: string, framework: string, vars: Record<string, string>): EnvMergeResult;
 export declare function createDefaultDeps(scriptsDir: string): InstallDeps;
 export declare function runInstallFlow(args: InstallArgs, deps: InstallDeps, scriptsDir: string): Promise<InstallSummary>;
@@ -212,6 +220,15 @@ export interface AuthenticatedInstallDeps {
     /** Phase 18.6 — intent analyze + pre-seed integrations. */
     intent?: IntentProposalDeps;
 }
+export declare function isTelemetryDisabled(): boolean;
+/**
+ * First-run consent prompt. Persists the decision so we never re-ask.
+ * No-op when telemetry is already disabled, when a decision is already
+ * recorded, or in non-interactive (`--yes` / `--no-interactive`) mode.
+ */
+export declare function maybePromptTelemetryConsent(ask: (q: string) => Promise<string>, args?: {
+    yes?: boolean;
+}): Promise<void>;
 export declare function repoHashOf(repoRoot: string, remoteUrl?: string | null): string;
 export declare function pickSite(sites: AuthenticatedInstallDeps['sites'], target?: string): {
     id: string;
@@ -237,5 +254,6 @@ export declare function emitInstallTelemetry(deps: AuthenticatedInstallDeps, pay
     ok: boolean;
     quotaExceeded: boolean;
 }>;
+export declare function detectCiEnv(env?: NodeJS.ProcessEnv): boolean;
 export declare function runAuthenticatedInstallFlow(args: InstallArgs, authDeps: AuthenticatedInstallDeps, installDeps: InstallDeps, scriptsDir: string): Promise<InstallSummary>;
 export declare function installCommand(args: InstallArgs): Promise<void>;