@girardmedia/bootspring 2.0.21 → 2.0.22

package/src/cli/legal.ts

@@ -0,0 +1,495 @@
+/**
+ * Bootspring Legal Command
+ * Legal documents and compliance tools
+ *
+ * @package bootspring
+ * @command legal
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Type interfaces for JS modules
+interface Colors {
+  reset: string;
+  bold: string;
+  dim: string;
+  cyan: string;
+  green: string;
+  yellow: string;
+  red: string;
+}
+
+interface PrintModule {
+  error(msg: string): void;
+  dim(msg: string): void;
+  warning(msg: string): void;
+  success(msg: string): void;
+}
+
+interface Spinner {
+  start(): Spinner;
+  stop(): void;
+  succeed(text: string): void;
+  fail(text: string): void;
+}
+
+interface UtilsModule {
+  COLORS: Colors;
+  print: PrintModule;
+  createSpinner(text: string): Spinner;
+}
+
+interface AuthModule {
+  isAuthenticated(): boolean;
+}
+
+interface ApiModule {
+  getTemplate(category: string, templateFile: string): Promise<TemplateResponse>;
+}
+
+interface TemplateResponse {
+  content: string;
+  error?: string | undefined;
+  message?: string | undefined;
+}
+
+interface FetchTemplateResult {
+  content?: string | undefined;
+  error?: string | undefined;
+  message?: string | undefined;
+}
+
+interface Template {
+  name: string;
+  file: string;
+  output: string;
+  description: string;
+}
+
+interface FailedTemplate {
+  name: string;
+  error: string;
+}
+
+interface ProjectConfig {
+  projectName?: string | undefined;
+  name?: string | undefined;
+  domain?: string | undefined;
+}
+
+const utils = require('../core/utils') as UtilsModule;
+const api = require('../core/api-client') as ApiModule;
+const auth = require('../core/auth') as AuthModule;
+
+/**
+ * Output directory for legal docs
+ */
+const OUTPUT_DIR = 'legal';
+
+/**
+ * Available legal templates
+ */
+const TEMPLATES: Record<string, Template> = {
+  terms: {
+    name: 'Terms of Service',
+    file: 'terms-of-service.md',
+    output: 'TERMS_OF_SERVICE.md',
+    description: 'Website/app terms of service template'
+  },
+  privacy: {
+    name: 'Privacy Policy',
+    file: 'privacy-policy.md',
+    output: 'PRIVACY_POLICY.md',
+    description: 'Privacy policy with GDPR/CCPA considerations'
+  },
+  gdpr: {
+    name: 'GDPR Compliance Checklist',
+    file: 'gdpr-checklist.md',
+    output: 'GDPR_CHECKLIST.md',
+    description: 'GDPR compliance requirements checklist'
+  }
+};
+
+/**
+ * Get project config if available
+ */
+function getProjectConfig(): ProjectConfig {
+  const configPath = path.join(process.cwd(), 'bootspring.config.js');
+  if (fs.existsSync(configPath)) {
+    try {
+      return require(configPath) as ProjectConfig;
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+/**
+ * Replace template variables
+ */
+function processTemplate(content: string, config: ProjectConfig): string {
+  const projectName = config.projectName || config.name || path.basename(process.cwd());
+  const date = new Date().toISOString().split('T')[0] || '';
+
+  return content
+    .replace(/\{\{PROJECT_NAME\}\}/g, projectName)
+    .replace(/\{\{DATE\}\}/g, date)
+    .replace(/\{\{DOMAIN\}\}/g, config.domain || 'example.com');
+}
+
+/**
+ * Fetch template content from API
+ */
+async function fetchTemplate(templateFile: string): Promise<FetchTemplateResult> {
+  if (!auth.isAuthenticated()) {
+    return { error: 'auth_required' };
+  }
+
+  try {
+    const response = await api.getTemplate('legal', templateFile);
+    return response;
+  } catch (error) {
+    const err = error as { status?: number; message?: string };
+    if (err.status === 401) {
+      return { error: 'auth_required' };
+    }
+    if (err.status === 403) {
+      return { error: 'upgrade_required' };
+    }
+    return { error: 'network_error', message: err.message };
+  }
+}
+
+/**
+ * Initialize legal docs
+ */
+async function legalInit(): Promise<void> {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Legal Documents${utils.COLORS.reset}
+${utils.COLORS.dim}Initialize legal documents and compliance checklists${utils.COLORS.reset}
+`);
+
+  // Check authentication
+  if (!auth.isAuthenticated()) {
+    utils.print.error('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  const config = getProjectConfig();
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+
+  // Create output directory
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  const created: string[] = [];
+  const skipped: string[] = [];
+  const failed: FailedTemplate[] = [];
+
+  const spinner = utils.createSpinner('Loading templates...');
+  spinner.start();
+
+  // Create all legal templates
+  for (const [_key, template] of Object.entries(TEMPLATES)) {
+    const outputPath = path.join(outputDir, template.output);
+
+    if (fs.existsSync(outputPath)) {
+      skipped.push(template.name);
+      continue;
+    }
+
+    const result = await fetchTemplate(template.file);
+
+    if (result.error) {
+      failed.push({ name: template.name, error: result.error });
+      continue;
+    }
+
+    if (result.content) {
+      const processed = processTemplate(result.content, config);
+      fs.writeFileSync(outputPath, processed);
+      created.push(template.name);
+    }
+  }
+
+  spinner.stop();
+
+  if (created.length > 0) {
+    console.log(`${utils.COLORS.bold}Created:${utils.COLORS.reset}`);
+    for (const name of created) {
+      console.log(`  ${utils.COLORS.green}✓${utils.COLORS.reset} ${name}`);
+    }
+    console.log();
+  }
+
+  if (skipped.length > 0) {
+    console.log(`${utils.COLORS.bold}Skipped (already exist):${utils.COLORS.reset}`);
+    for (const name of skipped) {
+      console.log(`  ${utils.COLORS.dim}●${utils.COLORS.reset} ${name}`);
+    }
+    console.log();
+  }
+
+  if (failed.length > 0) {
+    console.log(`${utils.COLORS.bold}Failed:${utils.COLORS.reset}`);
+    for (const { name, error } of failed) {
+      console.log(`  ${utils.COLORS.red}✗${utils.COLORS.reset} ${name} (${error})`);
+    }
+    console.log();
+  }
+
+  console.log(`${utils.COLORS.yellow}${utils.COLORS.bold}⚠ Disclaimer${utils.COLORS.reset}`);
+  console.log(`${utils.COLORS.dim}These templates are for guidance only. Consult a lawyer for your specific needs.${utils.COLORS.reset}`);
+
+  console.log(`\n${utils.COLORS.bold}Next Steps:${utils.COLORS.reset}`);
+  console.log('  1. Edit templates with your company information');
+  console.log(`  2. Run ${utils.COLORS.cyan}bootspring agent invoke legal-expert${utils.COLORS.reset} for guidance`);
+  console.log('  3. Have documents reviewed by legal counsel');
+}
+
+/**
+ * Create a specific legal document
+ */
+async function legalCreate(templateKey: string): Promise<void> {
+  const template = TEMPLATES[templateKey];
+
+  if (!template) {
+    utils.print.error(`Unknown template: ${templateKey}`);
+    console.log(`\nAvailable templates: ${Object.keys(TEMPLATES).join(', ')}`);
+    return;
+  }
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ ${template.name}${utils.COLORS.reset}
+${utils.COLORS.dim}${template.description}${utils.COLORS.reset}
+`);
+
+  // Check authentication
+  if (!auth.isAuthenticated()) {
+    utils.print.error('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  const config = getProjectConfig();
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+  const outputPath = path.join(outputDir, template.output);
+
+  // Create output directory
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  if (fs.existsSync(outputPath)) {
+    utils.print.warning(`File already exists: ${OUTPUT_DIR}/${template.output}`);
+    console.log(`Edit it directly or use ${utils.COLORS.cyan}bootspring legal show ${templateKey}${utils.COLORS.reset}`);
+    return;
+  }
+
+  const spinner = utils.createSpinner('Loading template...');
+  spinner.start();
+
+  const result = await fetchTemplate(template.file);
+
+  if (result.error === 'auth_required') {
+    spinner.fail('Authentication required');
+    console.log(`${utils.COLORS.dim}Run: bootspring auth login${utils.COLORS.reset}`);
+    return;
+  }
+
+  if (result.error === 'upgrade_required') {
+    spinner.fail('Upgrade required');
+    console.log(`${utils.COLORS.dim}This template requires a Pro subscription.${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}Run: bootspring billing upgrade${utils.COLORS.reset}`);
+    return;
+  }
+
+  if (result.error) {
+    spinner.fail('Failed to load template');
+    console.log(`${utils.COLORS.dim}${result.message || 'Check your internet connection.'}${utils.COLORS.reset}`);
+    return;
+  }
+
+  spinner.succeed('Template loaded');
+
+  if (result.content) {
+    const processed = processTemplate(result.content, config);
+    fs.writeFileSync(outputPath, processed);
+  }
+
+  utils.print.success(`Created ${template.name}`);
+  console.log(`\nFile: ${utils.COLORS.cyan}${OUTPUT_DIR}/${template.output}${utils.COLORS.reset}`);
+
+  console.log(`\n${utils.COLORS.yellow}${utils.COLORS.bold}⚠ Disclaimer${utils.COLORS.reset}`);
+  console.log(`${utils.COLORS.dim}This template is for guidance only. Consult a lawyer.${utils.COLORS.reset}`);
+}
+
+/**
+ * Show status of legal documents
+ */
+function legalStatus(): void {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Legal Documents Status${utils.COLORS.reset}
+`);
+
+  const outputDir = path.join(process.cwd(), OUTPUT_DIR);
+  let found = 0;
+  const total = Object.keys(TEMPLATES).length;
+
+  for (const [key, template] of Object.entries(TEMPLATES)) {
+    const outputPath = path.join(outputDir, template.output);
+    const exists = fs.existsSync(outputPath);
+
+    if (exists) {
+      found++;
+      const stats = fs.statSync(outputPath);
+      const modified = stats.mtime.toISOString().split('T')[0] || '';
+      const size = Math.round(stats.size / 1024);
+
+      console.log(`  ${utils.COLORS.green}✓${utils.COLORS.reset} ${template.name}`);
+      console.log(`    ${utils.COLORS.dim}${OUTPUT_DIR}/${template.output} (${size}KB, modified ${modified})${utils.COLORS.reset}`);
+    } else {
+      console.log(`  ${utils.COLORS.yellow}○${utils.COLORS.reset} ${template.name}`);
+      console.log(`    ${utils.COLORS.dim}Not created - run: bootspring legal ${key}${utils.COLORS.reset}`);
+    }
+  }
+
+  console.log();
+  console.log(`${utils.COLORS.bold}Progress:${utils.COLORS.reset} ${found}/${total} documents created`);
+
+  if (found < total) {
+    console.log(`\n${utils.COLORS.bold}Create Missing:${utils.COLORS.reset}`);
+    console.log(`  ${utils.COLORS.cyan}bootspring legal init${utils.COLORS.reset} - Create all documents`);
+  }
+}
+
+/**
+ * Show a legal document
+ */
+function legalShow(templateKey: string): void {
+  const template = TEMPLATES[templateKey];
+
+  if (!template) {
+    utils.print.error(`Unknown template: ${templateKey}`);
+    console.log(`\nAvailable templates: ${Object.keys(TEMPLATES).join(', ')}`);
+    return;
+  }
+
+  const outputPath = path.join(process.cwd(), OUTPUT_DIR, template.output);
+
+  if (!fs.existsSync(outputPath)) {
+    utils.print.warning(`${template.name} not created yet`);
+    console.log(`\nRun: ${utils.COLORS.cyan}bootspring legal ${templateKey}${utils.COLORS.reset}`);
+    return;
+  }
+
+  const content = fs.readFileSync(outputPath, 'utf-8');
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ ${template.name}${utils.COLORS.reset}
+${utils.COLORS.dim}${OUTPUT_DIR}/${template.output}${utils.COLORS.reset}
+`);
+
+  // Show first 50 lines as preview
+  const lines = content.split('\n').slice(0, 50);
+  console.log(lines.join('\n'));
+
+  if (content.split('\n').length > 50) {
+    console.log(`\n${utils.COLORS.dim}... (${content.split('\n').length - 50} more lines)${utils.COLORS.reset}`);
+    console.log(`${utils.COLORS.dim}Open the full file to see more${utils.COLORS.reset}`);
+  }
+}
+
+/**
+ * Show help
+ */
+function showHelp(): void {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Legal${utils.COLORS.reset}
+${utils.COLORS.dim}Legal documents and compliance tools${utils.COLORS.reset}
+
+${utils.COLORS.bold}Usage:${utils.COLORS.reset}
+  bootspring legal <command> [options]
+
+${utils.COLORS.bold}Commands:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}init${utils.COLORS.reset}           Initialize all legal documents
+  ${utils.COLORS.cyan}terms${utils.COLORS.reset}          Create terms of service
+  ${utils.COLORS.cyan}privacy${utils.COLORS.reset}        Create privacy policy
+  ${utils.COLORS.cyan}gdpr${utils.COLORS.reset}           Create GDPR compliance checklist
+  ${utils.COLORS.cyan}status${utils.COLORS.reset}         Show status of legal documents
+  ${utils.COLORS.cyan}show${utils.COLORS.reset} <type>    Preview a legal document
+
+${utils.COLORS.bold}Examples:${utils.COLORS.reset}
+  bootspring legal init            # Create all legal docs
+  bootspring legal terms           # Create terms of service
+  bootspring legal privacy         # Create privacy policy
+  bootspring legal gdpr            # Create GDPR checklist
+  bootspring legal status          # Check progress
+  bootspring legal show terms      # Preview terms of service
+
+${utils.COLORS.bold}Related Agent:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}legal-expert${utils.COLORS.reset}   Contracts, compliance, and legal guidance
+
+${utils.COLORS.yellow}${utils.COLORS.bold}Disclaimer:${utils.COLORS.reset}
+${utils.COLORS.dim}These templates are for guidance only. Always consult with a qualified
+attorney for your specific legal needs and jurisdiction.${utils.COLORS.reset}
+`);
+}
+
+/**
+ * Run legal command
+ */
+export async function run(args: string[]): Promise<void> {
+  const subcommand = args[0] || 'help';
+
+  switch (subcommand) {
+    case 'init':
+      await legalInit();
+      break;
+
+    case 'terms':
+    case 'tos':
+      await legalCreate('terms');
+      break;
+
+    case 'privacy':
+      await legalCreate('privacy');
+      break;
+
+    case 'gdpr':
+      await legalCreate('gdpr');
+      break;
+
+    case 'status':
+      legalStatus();
+      break;
+
+    case 'show':
+      if (!args[1]) {
+        utils.print.error('Please specify a document type');
+        console.log(`Usage: ${utils.COLORS.cyan}bootspring legal show <terms|privacy|gdpr>${utils.COLORS.reset}`);
+        return;
+      }
+      legalShow(args[1]);
+      break;
+
+    case 'help':
+    case '-h':
+    case '--help':
+      showHelp();
+      break;
+
+    default:
+      // Check if it's a template name
+      if (TEMPLATES[subcommand]) {
+        await legalCreate(subcommand);
+      } else {
+        utils.print.error(`Unknown subcommand: ${subcommand}`);
+        showHelp();
+      }
+  }
+}