jfl 0.1.0 → 0.2.0

package/dist/commands/migrate-services.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * Migrate services from references/ to service manager
+ *
+ * @purpose Migrate GTM workspaces from references-based services to service manager
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import * as readline from 'readline';
+import chalk from 'chalk';
+export async function migrateServices(gtmPath) {
+    const cwd = gtmPath || process.cwd();
+    const referencesDir = path.join(cwd, 'references');
+    console.log(chalk.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.cyan('  JFL Service Migration'));
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    // Check if references/ exists
+    if (!fs.existsSync(referencesDir)) {
+        console.log(chalk.yellow('⚠  No references/ directory found'));
+        return;
+    }
+    // Find service repos (directories with .git)
+    const services = [];
+    const entries = fs.readdirSync(referencesDir);
+    for (const entry of entries) {
+        const entryPath = path.join(referencesDir, entry);
+        const stat = fs.statSync(entryPath);
+        if (stat.isDirectory() && fs.existsSync(path.join(entryPath, '.git'))) {
+            // Get git remote URL
+            let gitUrl;
+            try {
+                gitUrl = execSync('git remote get-url origin', {
+                    cwd: entryPath,
+                    encoding: 'utf-8',
+                }).trim();
+            }
+            catch (e) {
+                // No remote
+            }
+            services.push({
+                name: entry,
+                path: entryPath,
+                gitUrl,
+            });
+        }
+    }
+    if (services.length === 0) {
+        console.log(chalk.green('✓ No services found in references/'));
+        console.log(chalk.dim('  references/ is ready for reference material only\n'));
+        return;
+    }
+    console.log(chalk.yellow(`Found ${services.length} service(s) to migrate:\n`));
+    for (const service of services) {
+        console.log(chalk.dim(`  • ${service.name}`));
+        if (service.gitUrl) {
+            console.log(chalk.dim(`    ${service.gitUrl}`));
+        }
+    }
+    console.log('');
+    // Ask for confirmation
+    console.log(chalk.yellow('This will:'));
+    console.log(chalk.dim('  1. Register each service with the service manager'));
+    console.log(chalk.dim('  2. Remove service from references/'));
+    console.log(chalk.dim('  3. Update CLAUDE.md with service manager instructions'));
+    console.log(chalk.dim('  4. Add references/ to .gitignore\n'));
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question(chalk.cyan('Proceed? [y/N]: '), resolve);
+    });
+    rl.close();
+    if (!answer.match(/^[Yy]/)) {
+        console.log(chalk.dim('\nMigration cancelled\n'));
+        return;
+    }
+    console.log('');
+    // Migrate each service
+    for (const service of services) {
+        console.log(chalk.cyan(`→ Migrating ${service.name}...`));
+        // 1. Register with service manager
+        if (service.gitUrl) {
+            try {
+                execSync(`jfl service add ${service.name} ${service.gitUrl}`, {
+                    cwd,
+                    stdio: 'inherit',
+                });
+                console.log(chalk.green(`  ✓ Registered with service manager`));
+            }
+            catch (e) {
+                console.log(chalk.yellow(`  ⚠ Failed to register (may need manual setup)`));
+            }
+        }
+        // 2. Remove from references/
+        try {
+            execSync(`rm -rf "${service.path}"`, { cwd });
+            console.log(chalk.green(`  ✓ Removed from references/`));
+        }
+        catch (e) {
+            console.log(chalk.red(`  ✗ Failed to remove`));
+        }
+        console.log('');
+    }
+    // 3. Update CLAUDE.md
+    const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+    if (fs.existsSync(claudeMdPath)) {
+        console.log(chalk.cyan('→ Updating CLAUDE.md...'));
+        let claudeMd = fs.readFileSync(claudeMdPath, 'utf-8');
+        // Add service manager section if not present
+        if (!claudeMd.includes('## Service Manager')) {
+            const serviceManagerSection = `
+## Service Manager
+
+Services are managed via the JFL service manager, not as submodules in references/.
+
+### Available Services
+
+List services:
+\`\`\`bash
+jfl service list
+\`\`\`
+
+Get service code:
+\`\`\`bash
+jfl service get <service-name>
+# Code is cloned to .jfl/services/<service-name>/
+\`\`\`
+
+Update service:
+\`\`\`bash
+jfl service update <service-name>
+\`\`\`
+
+### References Directory
+
+The \`references/\` directory is for reference material only (docs, examples, inspiration).
+**DO NOT** put service code or dependencies in references/.
+
+`;
+            // Insert before "## Remember" or at the end
+            if (claudeMd.includes('## Remember')) {
+                claudeMd = claudeMd.replace('## Remember', serviceManagerSection + '## Remember');
+            }
+            else {
+                claudeMd += serviceManagerSection;
+            }
+            fs.writeFileSync(claudeMdPath, claudeMd);
+            console.log(chalk.green('  ✓ Added service manager section'));
+        }
+        else {
+            console.log(chalk.dim('  • Service manager section already exists'));
+        }
+        console.log('');
+    }
+    // 4. Update .gitignore
+    const gitignorePath = path.join(cwd, '.gitignore');
+    console.log(chalk.cyan('→ Updating .gitignore...'));
+    let gitignore = '';
+    if (fs.existsSync(gitignorePath)) {
+        gitignore = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+    if (!gitignore.includes('references/')) {
+        gitignore += '\n# Reference material (local only)\nreferences/\n';
+        fs.writeFileSync(gitignorePath, gitignore);
+        console.log(chalk.green('  ✓ Added references/ to .gitignore'));
+    }
+    else {
+        console.log(chalk.dim('  • references/ already in .gitignore'));
+    }
+    console.log('');
+    console.log(chalk.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.green('✓ Migration complete\n'));
+    console.log(chalk.dim('Next steps:'));
+    console.log(chalk.dim('  1. Review CLAUDE.md updates'));
+    console.log(chalk.dim('  2. Test service access: jfl service list'));
+    console.log(chalk.dim('  3. Commit changes'));
+    console.log(chalk.dim('  4. Use references/ for reference material only\n'));
+}
+// Exported for CLI use - no standalone entry point needed (called via commander)
+//# sourceMappingURL=migrate-services.js.map

package/dist/commands/migrate-services.js.map

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

package/dist/commands/onboard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Onboard Command
+ *
+ * Onboard a service repo as a service agent in the GTM ecosystem
+ *
+ * Usage:
+ *   jfl onboard <path|url>
+ *   jfl onboard /Users/user/code/myservice
+ *   jfl onboard git@github.com:user/repo.git
+ *
+ * @purpose Onboard services with full agent infrastructure
+ */
+import { type ServiceMetadata } from "../lib/service-detector.js";
+export interface OnboardOptions {
+    name?: string;
+    type?: ServiceMetadata["type"];
+    description?: string;
+    skipGit?: boolean;
+}
+/**
+ * Main onboard command
+ */
+export declare function onboardCommand(pathOrUrl: string, options?: OnboardOptions): Promise<void>;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/commands/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAA;AASnC,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAmXD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAkaf"}