@indigoai-us/hq-cli 5.115.1 → 5.115.3

package/dist/lib/onboarding/cli/prompts.js

@@ -0,0 +1,83 @@
+/**
+ * CLI prompt helpers for /onboard command (VLT-9 US-002; vendored from @indigoai-us/hq-onboarding).
+ *
+ * Provides typed prompt interfaces the slash command can call.
+ * These are library functions — the actual UX is in onboard.md.
+ */
+/**
+ * Format a progress event for CLI display.
+ */
+export function formatProgress(event, stepNumber, totalSteps) {
+    const statusIcon = {
+        pending: "○",
+        running: "◉",
+        done: "✓",
+        skipped: "→",
+        failed: "✗",
+    }[event.status];
+    const detail = event.detail ? ` — ${event.detail}` : "";
+    return `  ${statusIcon} Step ${stepNumber}/${totalSteps}: ${event.step}${detail}`;
+}
+/**
+ * Format the success summary box.
+ */
+export function formatSummary(result) {
+    const lines = [
+        "┌─────────────────────────────────────────────┐",
+        "│  HQ Onboarding Complete                     │",
+        "├─────────────────────────────────────────────┤",
+        `│  Company:  ${result.companySlug.padEnd(33)}│`,
+        `│  UID:      ${result.companyUid.padEnd(33)}│`,
+        `│  Person:   ${result.personUid.padEnd(33)}│`,
+        `│  Role:     ${result.role.padEnd(33)}│`,
+    ];
+    if (result.bucketName) {
+        lines.push(`│  Bucket:   ${result.bucketName.padEnd(33)}│`);
+    }
+    lines.push("├─────────────────────────────────────────────┤");
+    lines.push("│  Next steps:                                │");
+    if (result.role === "owner") {
+        lines.push("│    • Run /invite <email> to add team        │");
+        lines.push("│    • Run hq sync to push files              │");
+    }
+    else {
+        lines.push("│    • Run hq sync to pull latest files       │");
+    }
+    lines.push("└─────────────────────────────────────────────┘");
+    return lines.join("\n");
+}
+/**
+ * Format an error for CLI display with recovery hints.
+ */
+export function formatError(error, checkpointPath) {
+    const lines = [
+        `ERROR: ${error.message}`,
+        "",
+        `Checkpoint saved to: ${checkpointPath}`,
+        "To retry: /onboard --resume",
+    ];
+    return lines.join("\n");
+}
+/**
+ * Validate a company slug: lowercase, alphanumeric + hyphens, 3-40 chars.
+ */
+export function validateSlug(slug) {
+    if (slug.length < 3)
+        return "Slug must be at least 3 characters";
+    if (slug.length > 40)
+        return "Slug must be at most 40 characters";
+    if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(slug)) {
+        return "Slug must be lowercase alphanumeric with hyphens (e.g. 'my-company')";
+    }
+    return null;
+}
+/**
+ * Validate email format.
+ */
+export function validateEmail(email) {
+    if (!email.includes("@") || !email.includes(".")) {
+        return "Invalid email format";
+    }
+    return null;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/lib/onboarding/errors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Onboarding error classes (VLT-9 US-001; vendored from @indigoai-us/hq-onboarding).
+ *
+ * Each failure class maps to a distinct step in the onboarding flow,
+ * making it easy for the installer to show targeted recovery hints.
+ */
+export declare class OnboardingError extends Error {
+    readonly step: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, step: string, cause?: Error | undefined);
+}
+export declare class PersonCreationError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class CompanyCreationError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class ProvisioningError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class MembershipBootstrapError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class FirstSyncError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class InviteAcceptError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+export declare class StsVerifyError extends OnboardingError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/onboarding/errors.js

@@ -0,0 +1,59 @@
+/**
+ * Onboarding error classes (VLT-9 US-001; vendored from @indigoai-us/hq-onboarding).
+ *
+ * Each failure class maps to a distinct step in the onboarding flow,
+ * making it easy for the installer to show targeted recovery hints.
+ */
+export class OnboardingError extends Error {
+    step;
+    cause;
+    constructor(message, step, cause) {
+        super(message);
+        this.step = step;
+        this.cause = cause;
+        this.name = "OnboardingError";
+    }
+}
+export class PersonCreationError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "create-person", cause);
+        this.name = "PersonCreationError";
+    }
+}
+export class CompanyCreationError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "create-company", cause);
+        this.name = "CompanyCreationError";
+    }
+}
+export class ProvisioningError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "provision-bucket", cause);
+        this.name = "ProvisioningError";
+    }
+}
+export class MembershipBootstrapError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "bootstrap-membership", cause);
+        this.name = "MembershipBootstrapError";
+    }
+}
+export class FirstSyncError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "first-sync", cause);
+        this.name = "FirstSyncError";
+    }
+}
+export class InviteAcceptError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "accept-invite", cause);
+        this.name = "InviteAcceptError";
+    }
+}
+export class StsVerifyError extends OnboardingError {
+    constructor(message, cause) {
+        super(message, "verify-sts", cause);
+        this.name = "StsVerifyError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/onboarding/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Onboarding orchestrator (formerly the npm package `@indigoai-us/hq-onboarding`,
+ * vendored into hq-cli in 2026-09 because nobody owned the package and its
+ * company-create step no longer matched the vault-service's authorization).
+ *
+ * Composes entities, bucket provisioning, STS, sync, membership, and
+ * invite/accept into create-company and join-company flows with
+ * checkpoint/resume.
+ */
+export { createCompanyFlow, joinCompanyFlow, resumeOnboarding, onboardingContract, } from "./orchestrator.js";
+export { readCheckpoint, writeCheckpoint, deleteCheckpoint, getCheckpointPath, isStepComplete, } from "./checkpoint.js";
+export { OnboardingError, PersonCreationError, CompanyCreationError, ProvisioningError, MembershipBootstrapError, FirstSyncError, InviteAcceptError, StsVerifyError, } from "./errors.js";
+export type { OnboardingInput, CreateCompanyInput, JoinCompanyInput, OnboardingConfig, OnboardingResult, OnboardingProgress, OnboardingStep, StepStatus, ProgressCallback, OnboardingCheckpoint, DesktopInstallerContract, HqConfig, } from "./types.js";
+export { runOnboardCli } from "./cli/onboard.js";
+export type { OnboardCliOptions, OnboardCliResult } from "./cli/onboard.js";
+export { formatProgress, formatSummary, formatError, validateSlug, validateEmail } from "./cli/prompts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/onboarding/index.js

@@ -0,0 +1,16 @@
+/**
+ * Onboarding orchestrator (formerly the npm package `@indigoai-us/hq-onboarding`,
+ * vendored into hq-cli in 2026-09 because nobody owned the package and its
+ * company-create step no longer matched the vault-service's authorization).
+ *
+ * Composes entities, bucket provisioning, STS, sync, membership, and
+ * invite/accept into create-company and join-company flows with
+ * checkpoint/resume.
+ */
+export { createCompanyFlow, joinCompanyFlow, resumeOnboarding, onboardingContract, } from "./orchestrator.js";
+export { readCheckpoint, writeCheckpoint, deleteCheckpoint, getCheckpointPath, isStepComplete, } from "./checkpoint.js";
+export { OnboardingError, PersonCreationError, CompanyCreationError, ProvisioningError, MembershipBootstrapError, FirstSyncError, InviteAcceptError, StsVerifyError, } from "./errors.js";
+// CLI
+export { runOnboardCli } from "./cli/onboard.js";
+export { formatProgress, formatSummary, formatError, validateSlug, validateEmail } from "./cli/prompts.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/onboarding/orchestrator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Onboarding orchestrator (VLT-9 US-001; vendored from @indigoai-us/hq-onboarding).
+ *
+ * Composes VLT-1 (entities), VLT-2 (bucket provisioning), VLT-3 (STS),
+ * VLT-5 (sync), VLT-6 (membership), and VLT-7 (invite/accept) into two
+ * end-to-end flows:
+ *
+ *   createCompanyFlow — founder creates a new company + vault
+ *   joinCompanyFlow   — invitee accepts an invite and syncs
+ *
+ * Each step is idempotent via checkpoint/resume. Progress events are
+ * emitted via callback for the installer UI.
+ */
+import type { CreateCompanyInput, JoinCompanyInput, OnboardingConfig, OnboardingResult, ProgressCallback, DesktopInstallerContract } from "./types.js";
+/**
+ * Create-company flow for founders.
+ *
+ * Steps:
+ *   1. Create person entity
+ *   2. Create company entity (the vault-service makes the caller its owner)
+ *   3. Provision bucket + KMS via vault-service
+ *   4. Bootstrap owner membership (library-direct, bypasses handler auth)
+ *   5. Verify STS vend works end-to-end
+ *   6. Write .hq/config.json
+ */
+export declare function createCompanyFlow(input: CreateCompanyInput, config: OnboardingConfig, onProgress?: ProgressCallback): Promise<OnboardingResult>;
+/**
+ * Join-company flow for invitees.
+ *
+ * Steps:
+ *   1. Parse invite token
+ *   2. Create person entity (if not already registered)
+ *   3. Accept invite
+ *   4. Verify STS vend
+ *   5. First sync to pull initial vault contents
+ *   6. Write .hq/config.json
+ */
+export declare function joinCompanyFlow(input: JoinCompanyInput, config: OnboardingConfig, onProgress?: ProgressCallback): Promise<OnboardingResult>;
+/**
+ * Resume an interrupted onboarding flow from checkpoint.
+ */
+export declare function resumeOnboarding(config: OnboardingConfig, onProgress?: ProgressCallback): Promise<OnboardingResult>;
+/**
+ * Desktop installer contract implementation.
+ */
+export declare const onboardingContract: DesktopInstallerContract;
+//# sourceMappingURL=orchestrator.d.ts.map