@firatcand/roster 0.4.0 → 1.0.0

package/bin/roster.js

@@ -141,6 +141,19 @@ function missingScaffoldError(scaffoldPath) {
 		exitCode: 1
 	});
 }
+function v04WorkspaceDetectedError(paths) {
+	const list = paths.map((p) => `    - ${p}`).join("\n");
+	return new RosterError({
+		header: `${chalk.red.bold("roster:")} detected v0.4 workspace`,
+		body: [
+			"  v1.0 is a breaking change with no automatic migration.",
+			"  Found:",
+			list
+		].join("\n"),
+		remedy: "  Re-scaffold in a fresh directory; see docs/CHANGELOG.md#v1.0.0.",
+		exitCode: 2
+	});
+}
 function userCancelledInit() {
 	return new RosterError({
 		header: `${chalk.dim("roster:")} cancelled`,
@@ -747,8 +760,6 @@ function isValidIanaTimezone(tz) {
 	}
 }
 const kebabString = (label) => z.string().min(1, { message: `${label}: required` }).refine((s) => KEBAB_RE$1.test(s), { message: `${label}: must be kebab-case (lowercase letters, digits, hyphens)` });
-const PROJECT_SLUG_RE = /^_?[a-z0-9]+(-[a-z0-9]+)*$/;
-const projectString = (label) => z.string().min(1, { message: `${label}: required` }).refine((s) => PROJECT_SLUG_RE.test(s), { message: `${label}: must be kebab-case (optionally prefixed with '_' for scaffold templates)` });
 const cronString = z.string().min(1, { message: "cron: required" }).transform((s) => s.trim()).superRefine((expr, ctx) => {
 	const result = validateCronExpression(expr);
 	if (!result.ok) ctx.addIssue({
@@ -769,11 +780,10 @@ const subscriptionAttestationSchema = z.object({
 	env_policy: z.literal("cleared"),
 	codex_home: z.string().min(1, { message: "subscription_attestation.codex_home: required" })
 }).strict();
-const scheduleEntrySchema = z.object({
+const scheduleEntryShape = z.object({
 	name: kebabString("name"),
 	agent: kebabString("agent"),
 	plan: kebabString("plan"),
-	project: projectString("project"),
 	cron: cronString,
 	tool: z.enum(TOOL_VALUES, { error: (issue) => {
 		const base = `tool: must be one of ${TOOL_VALUES.map((v) => `'${v}'`).join(" | ")}`;
@@ -815,6 +825,17 @@ const scheduleEntrySchema = z.object({
 		message: "capture_events: requires install_mode=via-cron (ui-handoff routes through the Codex app; no wrapper to redirect stdout)"
 	});
 });
+const scheduleEntrySchema = z.preprocess((raw, ctx) => {
+	if (raw !== null && typeof raw === "object" && "project" in raw) {
+		ctx.addIssue({
+			code: "custom",
+			path: ["project"],
+			message: "v0.4 schedule entry detected — see CHANGELOG#breaking-v1"
+		});
+		return z.NEVER;
+	}
+	return raw;
+}, scheduleEntryShape);
 const scheduleFileSchema = z.object({
 	version: z.number().int({ message: "version: must be an integer" }).refine((n) => n === 1, { message: `version: unsupported schema version (expected 1)` }),
 	schedules: z.array(scheduleEntrySchema)
@@ -1010,7 +1031,6 @@ function parseInstall(rest) {
 	let toolRaw;
 	let viaRaw;
 	let name;
-	let project;
 	let dryRun = false;
 	let cloudRoutine = false;
 	let json = false;
@@ -1088,21 +1108,11 @@ function parseInstall(rest) {
 				message: "flag --name specified more than once"
 			};
 			name = arg.slice(7);
-		} else if (arg === "--project") {
-			const r = consumeValue("--project", project, rest[i + 1]);
-			if (!r.ok) return {
-				kind: "err",
-				message: r.message
-			};
-			project = r.value;
-			i++;
-		} else if (arg.startsWith("--project=")) {
-			if (project !== void 0) return {
-				kind: "err",
-				message: "flag --project specified more than once"
-			};
-			project = arg.slice(10);
-		} else if (arg === "--cwd") {
+		} else if (arg === "--project" || arg.startsWith("--project=")) return {
+			kind: "err",
+			message: "--project removed in v1.0 — see CHANGELOG"
+		};
+		else if (arg === "--cwd") {
 			const r = consumeValue("--cwd", cwd, rest[i + 1]);
 			if (!r.ok) return {
 				kind: "err",
@@ -1168,7 +1178,6 @@ function parseInstall(rest) {
 		functionName,
 		agent,
 		plan,
-		project: project ?? "_demo",
 		cron,
 		tool: toolRaw,
 		via,
@@ -1950,7 +1959,6 @@ function renderFailedExitItem(args) {
 		`function: ${schedule.functionName}`,
 		`agent: ${schedule.entry.agent}`,
 		`plan: ${schedule.entry.plan}`,
-		`project: ${schedule.entry.project}`,
 		`cron: '${schedule.entry.cron}'`,
 		`exit_code: ${code}`,
 		`exit_path: ${exit.exitPath}`,
@@ -1988,7 +1996,6 @@ function renderStaleItem(args) {
 		`function: ${schedule.functionName}`,
 		`agent: ${schedule.entry.agent}`,
 		`plan: ${schedule.entry.plan}`,
-		`project: ${schedule.entry.project}`,
 		`cron: '${schedule.entry.cron}'`,
 		`expected_before: '${expectedBeforeUtc}'`,
 		`last_run: '${lastRun?.timestamp ?? ""}'`,
@@ -2471,6 +2478,14 @@ const FORGE_MARKERS = [
 	"spec/PRD.md",
 	"plans/phases.yaml"
 ];
+const V04_SCAN_SKIP = new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"coverage",
+	"lib",
+	"bin"
+]);
 const TEMPLATE_SUFFIX_RE = /\.template(\.[^.]+)?$/;
 function readTemplate(name) {
 	return readFileSync(join(ROSTER_ROOT, "templates", name), "utf8");
@@ -2481,6 +2496,35 @@ function substitute(template, vars) {
 function detectForgeMarkers(cwd) {
 	return FORGE_MARKERS.filter((m) => existsSync(join(cwd, m)));
 }
+function detectV04Workspace(cwd) {
+	const hits = [];
+	if (existsSync(join(cwd, "projects"))) hits.push("projects/");
+	let topEntries;
+	try {
+		topEntries = readdirSync(cwd, { withFileTypes: true });
+	} catch {
+		return hits;
+	}
+	for (const top of topEntries) {
+		if (!top.isDirectory()) continue;
+		if (top.name.startsWith(".")) continue;
+		if (V04_SCAN_SKIP.has(top.name)) continue;
+		const topPath = join(cwd, top.name);
+		if (existsSync(join(topPath, "projects"))) hits.push(`${top.name}/projects/`);
+		let subEntries;
+		try {
+			subEntries = readdirSync(topPath, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+		for (const sub of subEntries) {
+			if (!sub.isDirectory()) continue;
+			if (sub.name.startsWith(".")) continue;
+			if (existsSync(join(topPath, sub.name, "projects"))) hits.push(`${top.name}/${sub.name}/projects/`);
+		}
+	}
+	return hits;
+}
 function entryAtPath(path) {
 	try {
 		return {
@@ -2576,6 +2620,8 @@ async function executeInit(opts) {
 	const info = (msg) => {
 		if (!silent) logger.log(msg);
 	};
+	const v04Hits = detectV04Workspace(opts.cwd);
+	if (v04Hits.length > 0) throw v04WorkspaceDetectedError(v04Hits);
 	const forgeMarkers = detectForgeMarkers(opts.cwd);
 	const contextMdPath = join(opts.cwd, "CONTEXT.md");
 	const claudeMdPath = join(opts.cwd, "CLAUDE.md");
@@ -2621,7 +2667,10 @@ async function executeInit(opts) {
 	const warnings = [];
 	const scaffoldSrc = join(ROSTER_ROOT, "templates", "scaffold");
 	if (!existsSync(scaffoldSrc)) throw missingScaffoldError(scaffoldSrc);
-	const scaffoldFiles = walkScaffold(scaffoldSrc, opts.cwd, { PROJECT_NAME: projectName });
+	const scaffoldFiles = walkScaffold(scaffoldSrc, opts.cwd, {
+		PROJECT_NAME: projectName,
+		DISPLAY_NAME: projectName
+	});
 	filesWritten.push(...scaffoldFiles);
 	if (isMigration && migrate) {
 		const existingClaudeMd = readFileSync(claudeMdPath, "utf8");
@@ -3101,6 +3150,90 @@ function validateSchedulesInCwd(cwd) {
 	};
 }
 //#endregion
+//#region src/lib/dotenv-parse.ts
+const KEY_RE = /^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*/;
+function parseEnvFile(content) {
+	const out = /* @__PURE__ */ new Map();
+	if (content.charCodeAt(0) === 65279) content = content.slice(1);
+	for (const rawLine of content.split(/\r?\n/)) {
+		const trimmed = rawLine.replace(/^\s+/, "");
+		if (trimmed.length === 0 || trimmed.startsWith("#")) continue;
+		const candidate = trimmed.startsWith("export ") ? trimmed.slice(7).replace(/^\s+/, "") : trimmed;
+		const m = candidate.match(KEY_RE);
+		if (m === null) continue;
+		const key = m[1];
+		const parsed = parseValue(candidate.slice(m[0].length));
+		if (parsed === null) continue;
+		out.set(key, parsed);
+	}
+	return out;
+}
+function parseEnvKeys(content) {
+	return Array.from(parseEnvFile(content).keys());
+}
+function parseValue(src) {
+	if (src.length === 0) return "";
+	const first = src.charAt(0);
+	if (first === "\"") return parseDoubleQuoted(src);
+	if (first === "'") return parseSingleQuoted(src);
+	return parseUnquoted(src);
+}
+function parseDoubleQuoted(src) {
+	let i = 1;
+	let out = "";
+	while (i < src.length) {
+		const c = src.charAt(i);
+		if (c === "\\" && i + 1 < src.length) {
+			const next = src.charAt(i + 1);
+			switch (next) {
+				case "n":
+					out += "\n";
+					break;
+				case "r":
+					out += "\r";
+					break;
+				case "t":
+					out += "	";
+					break;
+				case "\"":
+					out += "\"";
+					break;
+				case "\\":
+					out += "\\";
+					break;
+				default:
+					out += "\\" + next;
+					break;
+			}
+			i += 2;
+			continue;
+		}
+		if (c === "\"") {
+			const after = src.slice(i + 1).replace(/^\s+/, "");
+			if (after.length === 0 || after.startsWith("#")) return out;
+			return null;
+		}
+		out += c;
+		i++;
+	}
+	return null;
+}
+function parseSingleQuoted(src) {
+	const close = src.indexOf("'", 1);
+	if (close === -1) return null;
+	const after = src.slice(close + 1).replace(/^\s+/, "");
+	if (after.length === 0 || after.startsWith("#")) return src.slice(1, close);
+	return null;
+}
+function parseUnquoted(src) {
+	let end = src.length;
+	for (let i = 0; i < src.length; i++) if (src.charAt(i) === "#" && i > 0 && /\s/.test(src.charAt(i - 1))) {
+		end = i;
+		break;
+	}
+	return src.slice(0, end).replace(/\s+$/, "");
+}
+//#endregion
 //#region src/lib/platform.ts
 function getPlatform() {
 	const override = process.env["ROSTER_PLATFORM"];
@@ -3142,21 +3275,6 @@ function auditEnvPermissions(cwd) {
 		autoFixable: true
 	};
 }
-const ENV_KEY_RE = /^([A-Za-z_][A-Za-z0-9_]*)\s*=/;
-function parseEnvKeys(content) {
-	const out = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const rawLine of content.split(/\r?\n/)) {
-		const line = rawLine.trim();
-		if (line.length === 0 || line.startsWith("#")) continue;
-		const m = (line.startsWith("export ") ? line.slice(7).trim() : line).match(ENV_KEY_RE);
-		if (m && !seen.has(m[1])) {
-			seen.add(m[1]);
-			out.push(m[1]);
-		}
-	}
-	return out;
-}
 const VAR_REF_RE = /\$(?:\{([A-Za-z_][A-Za-z0-9_]*)\}|([A-Za-z_][A-Za-z0-9_]*))/g;
 function extractVarRefs(content) {
 	const out = /* @__PURE__ */ new Map();
@@ -3257,7 +3375,8 @@ function auditEnvKeyReferences(cwd) {
 	const envPath = join(cwd, ".env");
 	let envKeys = [];
 	try {
-		envKeys = parseEnvKeys(readFileSync(envPath, "utf8"));
+		const raw = readFileSync(envPath, "utf8");
+		envKeys = Array.from(parseEnvFile(raw).entries()).filter(([, v]) => v.length > 0).map(([k]) => k);
 	} catch {}
 	const envKeySet = new Set(envKeys);
 	const yamls = collectConfigYamls(cwd);
@@ -3895,11 +4014,11 @@ function deriveScheduleName(agent, plan, override) {
 	if (override !== void 0 && override !== "") return override;
 	return `${agent}-${plan}`;
 }
-function buildOrchestratorPrompt(agent, plan, project) {
-	return `Use the roster-orchestrator skill to run plan ${plan} for agent ${agent} on project ${project}`;
+function buildOrchestratorPrompt(agent, plan) {
+	return `Use the roster-orchestrator skill to run plan ${plan} for agent ${agent}`;
 }
 function renderFieldsDoc(args) {
-	const prompt = buildOrchestratorPrompt(args.agent, args.plan, args.project);
+	const prompt = buildOrchestratorPrompt(args.agent, args.plan);
 	const allowedTools = DEFAULT_ALLOWED_TOOLS.join(", ");
 	return [
 		`# Claude Desktop Scheduled Task — ${args.name}`,
@@ -3963,7 +4082,6 @@ function installClaudeSchedule(opts) {
 		name: resolvedName,
 		agent: opts.agent,
 		plan: opts.plan,
-		project: opts.project,
 		cron: opts.cron,
 		tool: "claude",
 		install_mode: "ui-handoff",
@@ -3994,8 +4112,7 @@ function installClaudeSchedule(opts) {
 		cron: validatedEntry.cron,
 		workspacePath,
 		agent: validatedEntry.agent,
-		plan: validatedEntry.plan,
-		project: validatedEntry.project
+		plan: validatedEntry.plan
 	});
 	if (opts.dryRun) return {
 		resolvedName,
@@ -4145,7 +4262,7 @@ function auditCronDrift(opts) {
 			cron: entry.cron,
 			workspacePath,
 			codexBinaryPath,
-			prompt: buildOrchestratorPrompt(entry.agent, entry.plan, entry.project),
+			prompt: buildOrchestratorPrompt(entry.agent, entry.plan),
 			logPath: logPathFor(workspacePath, entry.name),
 			exitPath: exitPathFor(workspacePath, entry.name),
 			...entry.capture_events === true ? { eventsPath: eventsPathFor(workspacePath, entry.name) } : {}
@@ -4777,7 +4894,7 @@ function executeDoctor(opts) {
 //#region src/lib/codex-install.ts
 const KEBAB_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 function renderCodexHandoffDoc(args) {
-	const prompt = buildOrchestratorPrompt(args.agent, args.plan, args.project);
+	const prompt = buildOrchestratorPrompt(args.agent, args.plan);
 	return [
 		`# Codex App Automation — ${args.name}`,
 		"",
@@ -4865,7 +4982,6 @@ function installCodexSchedule(opts) {
 		name: resolvedName,
 		agent: opts.agent,
 		plan: opts.plan,
-		project: opts.project,
 		cron: opts.cron,
 		tool: "codex",
 		install_mode: opts.installMode,
@@ -4893,8 +5009,7 @@ function installCodexSchedule(opts) {
 		cron: validatedEntry.cron,
 		workspacePath,
 		agent: validatedEntry.agent,
-		plan: validatedEntry.plan,
-		project: validatedEntry.project
+		plan: validatedEntry.plan
 	}) : null;
 	let cronLine = null;
 	if (opts.installMode === "via-cron") {
@@ -4903,7 +5018,7 @@ function installCodexSchedule(opts) {
 			cron: validatedEntry.cron,
 			workspacePath,
 			codexBinaryPath,
-			prompt: buildOrchestratorPrompt(validatedEntry.agent, validatedEntry.plan, validatedEntry.project),
+			prompt: buildOrchestratorPrompt(validatedEntry.agent, validatedEntry.plan),
 			logPath,
 			exitPath,
 			...validatedEntry.capture_events === true ? { eventsPath: eventsPathFor(workspacePath, resolvedName) } : {}
@@ -5716,7 +5831,7 @@ async function executeRun(opts) {
 		name: opts.name,
 		functionName: opts.functionName
 	});
-	const prompt = buildOrchestratorPrompt(resolved.entry.agent, resolved.entry.plan, resolved.entry.project);
+	const prompt = buildOrchestratorPrompt(resolved.entry.agent, resolved.entry.plan);
 	if (resolved.entry.tool === "claude") {
 		for (const line of renderClaudeHandoff(resolved.workspacePath, prompt, resolved.entry.name, opts.silent, opts.dryRun)) console.log(line);
 		return {
@@ -5893,7 +6008,6 @@ function executeScheduleInstall(opts) {
 			functionName: opts.functionName,
 			agent: opts.agent,
 			plan: opts.plan,
-			project: opts.project,
 			cron: opts.cron,
 			name: opts.name,
 			dryRun: opts.dryRun
@@ -5917,7 +6031,6 @@ function executeScheduleInstall(opts) {
 		functionName: opts.functionName,
 		agent: opts.agent,
 		plan: opts.plan,
-		project: opts.project,
 		cron: opts.cron,
 		name: opts.name,
 		installMode,
@@ -7693,7 +7806,6 @@ function printHelp(version) {
 		`  --fix                        ${chalk.dim("Auto-fix broken symlinks + .env permissions (doctor)")}`,
 		`  --cwd <dir>                  ${chalk.dim("Run schedule validate against a different cwd")}`,
 		`  --dest <dir>                 ${chalk.dim("Destination workspace for migrate (default: cwd)")}`,
-		`  --project <name>             ${chalk.dim("Project slug for schedule install (default: _demo)")}`,
 		`  --dry-run                    ${chalk.dim("Print plan without writes (schedule *, doctor, migrate)")}`,
 		`  --force-resync               ${chalk.dim("Re-copy source files that changed since last migration (migrate)")}`,
 		`  --debug                      ${chalk.dim("Print full stack trace on error (global)")}`,
@@ -7839,7 +7951,6 @@ async function runSchedule(args) {
 		functionName: parsed.functionName,
 		agent: parsed.agent,
 		plan: parsed.plan,
-		project: parsed.project,
 		cron: parsed.cron,
 		tool: parsed.tool,
 		via: parsed.via,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firatcand/roster",
-  "version": "0.4.0",
+  "version": "1.0.0",
   "description": "A CLI that scaffolds a structured multi-agent workspace on top of AI coding tools (Claude Code, Codex CLI, Gemini)",
   "type": "module",
   "bin": {
@@ -27,10 +27,9 @@
     "test:update-golden": "node --experimental-strip-types scripts/update-golden.ts",
     "test:update-golden:stub": "node --experimental-strip-types scripts/update-golden-stub.ts",
     "smoke": "bash test/smoke.sh",
-    "e2e": "bash test/e2e-sdr.sh",
     "e2e:schedule": "bash test/e2e-schedule.sh",
     "perf": "bash test/perf.sh",
-    "test:dogfood-scripts": "bash test/new-agent-slash-only.sh && bash test/scripts-parity.sh",
+    "test:scaffold-scripts": "bash test/new-agent-slash-only.sh",
     "probe:claude-url": "bash scripts/probe-claude-url-scheme.sh"
   },
   "keywords": [