@getjack/jack 0.1.28 → 0.1.30

package/src/commands/new.ts

@@ -2,11 +2,17 @@ import { getPreferredLaunchAgent, launchAgent, scanAgents, updateAgent } from ".
 import { debug } from "../lib/debug.ts";
 import { getErrorDetails } from "../lib/errors.ts";
 import { isIntentPhrase } from "../lib/intent.ts";
-import { output, spinner } from "../lib/output.ts";
+import { createReporter, output } from "../lib/output.ts";
 import { createProject } from "../lib/project-operations.ts";
+import {
+	detectShell,
+	getRcFilePath,
+	isInstalled as isShellIntegrationInstalled,
+} from "../lib/shell-integration.ts";
 
 export default async function newProject(
 	nameOrPhrase?: string,
+	pathArg?: string,
 	options: {
 		template?: string;
 		intent?: string;
@@ -51,20 +57,11 @@ export default async function newProject(
 		result = await createProject(projectName, {
 			template: options.template,
 			intent: intentPhrase,
-			reporter: {
-				start: output.start,
-				stop: output.stop,
-				spinner,
-				info: output.info,
-				warn: output.warn,
-				error: output.error,
-				success: output.success,
-				box: output.box,
-				celebrate: output.celebrate,
-			},
+			reporter: createReporter(),
 			interactive: !isCi,
 			managed: options.managed,
 			byo: options.byo,
+			targetDir: pathArg || undefined,
 		});
 	} catch (error) {
 		const details = getErrorDetails(error);
@@ -96,63 +93,60 @@ export default async function newProject(
 		return;
 	}
 
-	console.error("");
-	output.info(`Project: ${result.targetDir}`);
-
-	// Skip agent section entirely if --no-open or env var
+	// Skip next steps if --no-open or env var
 	if (options.noOpen || process.env.JACK_NO_OPEN === "1") {
 		return;
 	}
 
-	// Skip in CI mode
+	// Check if shell integration is installed
+	const shell = detectShell();
+	const rcFile = getRcFilePath(shell);
+	const hasShellIntegration = rcFile ? isShellIntegrationInstalled(rcFile) : false;
+
 	if (!process.stdout.isTTY || isCi) {
+		console.error("");
+		console.error(`cd ${result.targetDir}`);
 		return;
 	}
 
-	// Get preferred agent
-	let preferred = await getPreferredLaunchAgent();
-
-	// If no preferred agent, scan and auto-enable detected agents
-	if (!preferred) {
-		const detectionResult = await scanAgents();
-
-		if (detectionResult.detected.length > 0) {
-			// Auto-enable newly detected agents
-			for (const { id, path, launch } of detectionResult.detected) {
-				await updateAgent(id, {
-					active: true,
-					path,
-					detectedAt: new Date().toISOString(),
-					launch,
-				});
+	// Auto-open if --open flag (requires agent detection)
+	if (options.open) {
+		let preferred = await getPreferredLaunchAgent();
+
+		if (!preferred) {
+			const detectionResult = await scanAgents();
+			if (detectionResult.detected.length > 0) {
+				for (const { id, path, launch } of detectionResult.detected) {
+					await updateAgent(id, {
+						active: true,
+						path,
+						detectedAt: new Date().toISOString(),
+						launch,
+					});
+				}
+				preferred = await getPreferredLaunchAgent();
 			}
-			// Use the first detected agent as preferred
-			preferred = await getPreferredLaunchAgent();
 		}
-	}
 
-	// Auto-open if --open flag
-	if (options.open && preferred) {
-		const launchResult = await launchAgent(preferred.launch, result.targetDir, {
-			projectName: result.projectName,
-			url: result.workerUrl,
-		});
-		if (!launchResult.success) {
-			output.warn(`Failed to launch ${preferred.definition.name}`);
-			if (launchResult.command?.length) {
-				output.info(`Run manually: ${launchResult.command.join(" ")}`);
+		if (preferred) {
+			const launchResult = await launchAgent(preferred.launch, result.targetDir, {
+				projectName: result.projectName,
+				url: result.workerUrl,
+			});
+			if (!launchResult.success) {
+				output.warn(`Failed to launch ${preferred.definition.name}`);
+				if (launchResult.command?.length) {
+					output.info(`Run manually: ${launchResult.command.join(" ")}`);
+				}
 			}
+			return;
 		}
-		return;
 	}
 
-	// Default: show next steps (no prompt)
-	if (preferred) {
-		console.error("");
-		output.info(`Next: cd ${result.targetDir} && ${preferred.launch.command}`);
+	console.error("");
+	if (hasShellIntegration) {
+		output.success(`Ready in ${result.projectName}`);
 	} else {
-		console.error("");
-		output.info("No AI agents detected");
-		output.info("Install Claude Code or Codex, then run: jack agents scan");
+		console.error(`cd ${result.targetDir}`);
 	}
 }

package/src/commands/projects.ts

@@ -1,11 +1,13 @@
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { resolve } from "node:path";
+import { fuzzyFilter } from "../lib/fuzzy.ts";
 import { promptSelect } from "../lib/hooks.ts";
 import { error, info, item, output as outputSpinner, success, warn } from "../lib/output.ts";
 import {
 	type ProjectListItem,
 	STATUS_ICONS,
+	type SortOrder,
 	buildTagColorMap,
 	colors,
 	filterByStatus,
@@ -16,6 +18,7 @@ import {
 	formatTagsInline,
 	groupProjects,
 	sortByUpdated,
+	sortItems,
 	toListItems,
 } from "../lib/project-list.ts";
 import { cleanupStaleProjects, scanStaleProjects } from "../lib/project-operations.ts";
@@ -63,9 +66,18 @@ export default async function projects(subcommand?: string, args: string[] = [])
 }
 
 /**
- * Extract a flag value from args (e.g., --status live -> "live")
+ * Extract a flag value from args (e.g., --status live -> "live" or --sort=name -> "name")
  */
 function extractFlagValue(args: string[], flag: string): string | null {
+	// Check for --flag=value syntax
+	const prefix = `${flag}=`;
+	for (const arg of args) {
+		if (arg.startsWith(prefix)) {
+			return arg.slice(prefix.length) || null;
+		}
+	}
+
+	// Check for --flag value syntax
 	const idx = args.indexOf(flag);
 	if (idx !== -1 && idx + 1 < args.length) {
 		return args[idx + 1] ?? null;
@@ -99,6 +111,20 @@ async function listProjects(args: string[]): Promise<void> {
 	const localOnly = args.includes("--local");
 	const cloudOnly = args.includes("--cloud");
 
+	// Parse --sort flag (default: updated)
+	const sortFlag = extractFlagValue(args, "--sort");
+	const sortOrder: SortOrder = sortFlag === "name" || sortFlag === "created" ? sortFlag : "updated";
+
+	// Extract positional filter (first arg that's not a flag or flag value)
+	const flagsWithValues = ["--status", "--tag", "--sort"];
+	const nameFilter = args.find((arg, idx) => {
+		if (arg.startsWith("--") || arg.startsWith("-")) return false;
+		// Check if previous arg was a flag that takes a value
+		const prevArg = args[idx - 1];
+		if (prevArg && flagsWithValues.includes(prevArg)) return false;
+		return true;
+	});
+
 	// Fetch all projects from registry and control plane
 	outputSpinner.start("Loading projects...");
 	const projects: ResolvedProject[] = await listAllProjects();
@@ -107,7 +133,18 @@ async function listProjects(args: string[]): Promise<void> {
 	// Convert to list items
 	let items = toListItems(projects);
 
-	// Apply filters
+	// Apply fuzzy name filter first (uses updatedAt for tiebreaker via sort stability)
+	if (nameFilter) {
+		// Sort by updatedAt descending before fuzzy filter so tiebreaker favors recent
+		items.sort((a, b) => {
+			const aTime = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+			const bTime = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+			return bTime - aTime;
+		});
+		items = fuzzyFilter(nameFilter, items, (item) => item.name);
+	}
+
+	// Apply other filters
 	if (statusFilter) items = filterByStatus(items, statusFilter);
 	if (localOnly) items = items.filter((i) => i.isLocal);
 	if (cloudOnly) items = items.filter((i) => i.isCloudOnly);
@@ -128,6 +165,9 @@ async function listProjects(args: string[]): Promise<void> {
 		return;
 	}
 
+	// Apply sorting
+	items = sortItems(items, sortOrder);
+
 	// JSON output to stdout (pipeable)
 	if (jsonOutput) {
 		console.log(JSON.stringify(items, null, 2));
@@ -146,8 +186,10 @@ async function listProjects(args: string[]): Promise<void> {
 
 /**
  * Render the grouped view (default)
+ * Note: items are already sorted by the caller
  */
 function renderGroupedView(items: ProjectListItem[]): void {
+	// Group projects while preserving the sort order within each group
 	const groups = groupProjects(items);
 	const total = items.length;
 	const CLOUD_LIMIT = 5;
@@ -173,13 +215,11 @@ function renderGroupedView(items: ProjectListItem[]): void {
 		console.error(formatLocalSection(groups.local, { tagColorMap }));
 	}
 
-	// Section 3: Cloud-only (show last N by updatedAt)
+	// Section 3: Cloud-only (show first N from already-sorted list)
 	if (groups.cloudOnly.length > 0) {
-		const sorted = sortByUpdated(groups.cloudOnly);
-
 		console.error("");
 		console.error(
-			formatCloudSection(sorted, {
+			formatCloudSection(groups.cloudOnly, {
 				limit: CLOUD_LIMIT,
 				total: groups.cloudOnly.length,
 				tagColorMap,
@@ -200,13 +240,16 @@ function renderGroupedView(items: ProjectListItem[]): void {
 
 /**
  * Render flat table (for --all mode)
+ * Note: items are already sorted by the caller
  */
 function renderFlatTable(items: ProjectListItem[]): void {
-	// Sort: errors first, then by name
+	// Keep errors at the top while preserving relative order within each group
 	const sorted = [...items].sort((a, b) => {
-		if (a.status === "error" && b.status !== "error") return -1;
-		if (a.status !== "error" && b.status === "error") return 1;
-		return a.name.localeCompare(b.name);
+		const aIsError = a.status === "error" || a.status === "auth-expired";
+		const bIsError = b.status === "error" || b.status === "auth-expired";
+		if (aIsError && !bIsError) return -1;
+		if (!aIsError && bIsError) return 1;
+		return 0; // Preserve existing sort order
 	});
 
 	// Build consistent tag color map

package/src/commands/secrets.ts

@@ -7,10 +7,10 @@
  */
 
 import { password as passwordPrompt } from "@clack/prompts";
-import { isCancel } from "../lib/hooks.ts";
 import { $ } from "bun";
 import { getControlApiUrl } from "../lib/control-plane.ts";
 import { JackError, JackErrorCode } from "../lib/errors.ts";
+import { isCancel } from "../lib/hooks.ts";
 import { error, info, output, success, warn } from "../lib/output.ts";
 import { type LocalProjectLink, readProjectLink } from "../lib/project-link.ts";
 import { getProjectNameFromDir } from "../lib/storage/index.ts";
@@ -25,6 +25,10 @@ export default async function secrets(
 	options: SecretsOptions = {},
 ): Promise<void> {
 	if (!subcommand) {
+		return await listSecrets(options);
+	}
+
+	if (subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
 		return showHelp();
 	}
 

package/src/commands/services.ts

@@ -438,7 +438,10 @@ async function dbDelete(options: ServiceOptions): Promise<void> {
 
 	// Confirm deletion
 	const { promptSelect } = await import("../lib/hooks.ts");
-	const choice = await promptSelect(["Yes, delete", "No, cancel"], `Delete database '${dbInfo.name}'?`);
+	const choice = await promptSelect(
+		["Yes, delete", "No, cancel"],
+		`Delete database '${dbInfo.name}'?`,
+	);
 
 	if (choice !== 0) {
 		info("Cancelled");
@@ -989,7 +992,11 @@ async function storageInfo(args: string[], options: ServiceOptions): Promise<voi
 
 		if (!bucketInfo) {
 			console.error("");
-			error(bucketName ? `Bucket "${bucketName}" not found` : "No storage buckets found for this project");
+			error(
+				bucketName
+					? `Bucket "${bucketName}" not found`
+					: "No storage buckets found for this project",
+			);
 			info("Create one with: jack services storage create");
 			console.error("");
 			return;
@@ -999,7 +1006,9 @@ async function storageInfo(args: string[], options: ServiceOptions): Promise<voi
 		success(`Bucket: ${bucketInfo.name}`);
 		console.error("");
 		item(`Binding: ${bucketInfo.binding}`);
-		item(`Source: ${bucketInfo.source === "control-plane" ? "managed (jack cloud)" : "BYO (wrangler)"}`);
+		item(
+			`Source: ${bucketInfo.source === "control-plane" ? "managed (jack cloud)" : "BYO (wrangler)"}`,
+		);
 		console.error("");
 	} catch (err) {
 		outputSpinner.stop();
@@ -1137,7 +1146,10 @@ async function storageDelete(args: string[], options: ServiceOptions): Promise<v
 
 	// Confirm deletion
 	const { promptSelect } = await import("../lib/hooks.ts");
-	const choice = await promptSelect(["Yes, delete", "No, cancel"], `Delete bucket '${bucketName}'?`);
+	const choice = await promptSelect(
+		["Yes, delete", "No, cancel"],
+		`Delete bucket '${bucketName}'?`,
+	);
 
 	if (choice !== 0) {
 		info("Cancelled");

package/src/commands/shell-init.ts

@@ -0,0 +1,43 @@
+/**
+ * shell-init command - output shell integration code
+ *
+ * Usage: jack shell-init
+ *
+ * Outputs shell code to stdout. Users can:
+ * - eval "$(jack shell-init)" for temporary use
+ * - Run `jack init` to install permanently (recommended)
+ */
+
+import {
+	detectShell,
+	getRcFileName,
+	getRcFilePath,
+	getShellCode,
+	getShellFileDisplayPath,
+	getSourceLine,
+} from "../lib/shell-integration.ts";
+
+export default async function shellInit(): Promise<void> {
+	const code = getShellCode();
+
+	// If piped (eval), output raw code only
+	if (!process.stdout.isTTY) {
+		console.log(code);
+		return;
+	}
+
+	// Interactive: show instructions
+	const shell = detectShell();
+	const rcFile = getRcFilePath(shell);
+	const rcName = rcFile ? getRcFileName(rcFile) : ".bashrc or .zshrc";
+
+	console.log("# Shell integration for jack");
+	console.log("#");
+	console.log("# Option 1 (recommended): Run 'jack init' to install automatically");
+	console.log("#");
+	console.log(`# Option 2: Add this line to your ~/${rcName}:`);
+	console.log(`#   ${getSourceLine().split("\n")[1]}`);
+	console.log(`#   Then create ${getShellFileDisplayPath()} with:`);
+	console.log("#");
+	console.log(code);
+}

package/src/commands/ship.ts

@@ -1,5 +1,5 @@
 import { getErrorDetails } from "../lib/errors.ts";
-import { output, spinner } from "../lib/output.ts";
+import { createReporter, output } from "../lib/output.ts";
 import { deployProject } from "../lib/project-operations.ts";
 
 export default async function ship(
@@ -9,16 +9,7 @@ export default async function ship(
 	try {
 		const result = await deployProject({
 			projectPath: process.cwd(),
-			reporter: {
-				start: output.start,
-				stop: output.stop,
-				spinner,
-				info: output.info,
-				warn: output.warn,
-				error: output.error,
-				success: output.success,
-				box: output.box,
-			},
+			reporter: createReporter(),
 			interactive: !isCi,
 			includeSecrets: !options.dryRun,
 			includeSync: !options.dryRun,