refactor session scaffold pathing and template context

Author: maomao274

.changeset/heavy-shoes-report.md

@@ -8,14 +8,6 @@ In local development, run `bun run dev` from the repo root. Turborepo will run
 the TUI and daemon together, and the TUI will wait for the foreground daemon
 instead of spawning a detached background process.
 
-## Scaffold a workspace
-
-From the `apps/tui` directory, run:
-
-```bash
-bun run src/cli.ts init /path/to/project
-```
-
 ## Advanced daemon control
 
 ```bash

apps/tui/README.md

@@ -9,7 +9,6 @@ import {
 	waitUntilReady,
 } from "@techatnyu/ralphd";
 import { runTui } from "./index";
-import { bootstrapRalphWorkspace } from "./scaffold";
 
 async function requireDaemon(): Promise<void> {
 	const running = await daemon.isDaemonRunning();
@@ -37,22 +36,6 @@ const cli = new Crust("ralph")
 	.run(async () => {
 		await runTui();
 	})
-	.command("init", (cmd) =>
-		cmd
-			.meta({ description: "Create a Ralph workspace for a project" })
-			.args([
-				{
-					name: "directory",
-					type: "string",
-					required: true,
-					description: "Project directory where .ralph will be created",
-				},
-			])
-			.run(async ({ args }) => {
-				await bootstrapRalphWorkspace(args.directory);
-				console.log(`Created Ralph workspace in ${args.directory}/.ralph`);
-			}),
-	)
 	.command("daemon", (daemonCommand) =>
 		daemonCommand
 			.meta({ description: "Manage the background daemon" })

apps/tui/src/cli.ts

@@ -1,17 +1,56 @@
-import { basename, resolve } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
 import { scaffold } from "@crustjs/create";
+import { resolveDaemonPaths } from "@techatnyu/ralphd";
 
-export async function bootstrapRalphWorkspace(
-	projectDirectory: string,
-): Promise<void> {
-	const absoluteProjectDirectory = resolve(projectDirectory);
-	const projectName = basename(absoluteProjectDirectory);
+export interface SessionScaffoldOptions {
+	instanceId: string;
+	sessionId: string;
+	ralphHome?: string;
+}
+
+function assertValidSegment(value: string, label: string): void {
+	if (!value.trim()) {
+		throw new Error(`${label} is required`);
+	}
+
+	if (value.includes("/") || value.includes("\\")) {
+		throw new Error(`${label} must not contain path separators`);
+	}
+}
+
+export function resolveSessionScaffoldPath(
+	options: SessionScaffoldOptions,
+): string {
+	assertValidSegment(options.instanceId, "instanceId");
+	assertValidSegment(options.sessionId, "sessionId");
+
+	const ralphHome =
+		options.ralphHome ?? resolveDaemonPaths(process.env).ralphHome;
+
+	return join(
+		ralphHome,
+		"sessions",
+		options.instanceId,
+		options.sessionId,
+	);
+}
+
+export async function bootstrapSessionScaffold(
+	options: SessionScaffoldOptions,
+): Promise<string> {
+	const sessionPath = resolveSessionScaffoldPath(options);
+
+	await mkdir(sessionPath, { recursive: true });
 
 	await scaffold({
 		template: new URL("../templates/ralph-workspace", import.meta.url),
-		dest: resolve(absoluteProjectDirectory, ".ralph"),
+		dest: sessionPath,
 		context: {
-			projectName,
+			instanceId: options.instanceId,
+			sessionId: options.sessionId,
 		},
 	});
-}
+
+	return sessionPath;
+}

apps/tui/src/scaffold.ts

@@ -1,2 +1 @@
-# {{projectName}}
-<!-- The high-level project specification. Captures what you're building and why — goals, scope, tech stack choices, and architectural decisions. Implementation details (concrete tasks, exact thresholds, file-level structure) belong in prd.json and the codebase itself. A good spec is stable and rarely needs updating as the project evolves. -->
+# Instance {{instanceId}} Session {{sessionId}}

apps/tui/templates/ralph-workspace/SPEC.md

@@ -1,9 +1,10 @@
 export { DaemonClient, daemon } from "./client";
+export { RALPH_HOME, resolveDaemonPaths } from "./env";
 export {
 	ensureDaemonRunning,
 	runForegroundDaemon,
 	startDetached,
 	stopDaemon,
 	waitUntilReady,
 } from "./launcher";
-export type * from "./protocol";
+export type * from "./protocol";