@rockclaver/sandcastle 0.7.0 → 0.8.0

package/dist/main.js

@@ -18410,6 +18410,106 @@ var SANDBOX_PROVIDER_REGISTRY = [
 ];
 var listSandboxProviders = () => SANDBOX_PROVIDER_REGISTRY;
 var getSandboxProvider = (name) => SANDBOX_PROVIDER_REGISTRY.find((p3) => p3.name === name);
+var DEFAULT_PROFILE_NAME = "js-ts";
+var PROFILE_REGISTRY = [
+  {
+    name: "js-ts",
+    label: "JavaScript / TypeScript",
+    guidance: "JavaScript or TypeScript project managed with npm, pnpm, yarn, or bun. Install dependencies before validating, and prefer the project's existing scripts (typecheck, lint, test) over ad-hoc commands.",
+    setupCommands: ["npm install"],
+    validationCommands: [
+      "npm install",
+      "npm run typecheck",
+      "npm run lint",
+      "npm test"
+    ]
+  },
+  {
+    name: "flutter",
+    label: "Flutter",
+    guidance: "Flutter application using the Dart SDK. Fetch packages with `flutter pub get`, then analyze and test through the Flutter toolchain. Sandcastle does not install or pin the Flutter SDK \u2014 assume it is available in the sandbox.",
+    setupCommands: ["flutter pub get"],
+    validationCommands: ["flutter pub get", "flutter analyze", "flutter test"]
+  },
+  {
+    name: "dart",
+    label: "Dart",
+    guidance: "Standalone Dart package (no Flutter). Fetch packages with `dart pub get`, then analyze and test with the Dart toolchain. Sandcastle does not install or pin the Dart SDK \u2014 assume it is available in the sandbox.",
+    setupCommands: ["dart pub get"],
+    validationCommands: ["dart pub get", "dart analyze", "dart test"]
+  },
+  {
+    name: "go",
+    label: "Go",
+    guidance: "Go module defined by `go.mod`. Build, vet, and test through the Go toolchain. Sandcastle does not install or pin the Go SDK \u2014 assume it is available in the sandbox.",
+    setupCommands: ["go mod download"],
+    validationCommands: ["go build ./...", "go vet ./...", "go test ./..."]
+  }
+];
+var listProfiles = () => PROFILE_REGISTRY;
+var getProfile = (name) => PROFILE_REGISTRY.find((p3) => p3.name === name);
+var resolveProfileEntries = (profileNames) => {
+  const names = profileNames.length === 0 ? [DEFAULT_PROFILE_NAME] : profileNames;
+  const seen = /* @__PURE__ */ new Set();
+  const resolved = [];
+  for (const name of names) {
+    if (seen.has(name)) continue;
+    const entry = PROFILE_REGISTRY.find((p3) => p3.name === name);
+    if (!entry) {
+      const valid = PROFILE_REGISTRY.map((p3) => p3.name).join(", ");
+      throw new Error(
+        `Unknown profile "${name}". Available profiles: ${valid}`
+      );
+    }
+    seen.add(name);
+    resolved.push(entry);
+  }
+  return resolved;
+};
+var hasFile = (repoDir, file4) => Effect_exports.gen(function* () {
+  const fs = yield* FileSystem_exports.FileSystem;
+  return yield* fs.exists(join(repoDir, file4)).pipe(Effect_exports.orElseSucceed(() => false));
+});
+var readOptionalFile = (repoDir, file4) => Effect_exports.gen(function* () {
+  const fs = yield* FileSystem_exports.FileSystem;
+  const path2 = join(repoDir, file4);
+  const exists = yield* fs.exists(path2).pipe(Effect_exports.orElseSucceed(() => false));
+  if (!exists) return void 0;
+  return yield* fs.readFileString(path2).pipe(Effect_exports.orElseSucceed(() => void 0));
+});
+var hasFlutterMarkers = (pubspec) => /^\s*sdk:\s*flutter\s*$/m.test(pubspec) || /^flutter:\s*$/m.test(pubspec);
+var detectRepositoryProfiles = (repoDir) => Effect_exports.gen(function* () {
+  const detected = [];
+  const hasJsSignal = (yield* hasFile(repoDir, "package.json")) || (yield* Effect_exports.all(
+    LOCKFILES.map(([file4]) => hasFile(repoDir, file4)),
+    {
+      concurrency: "unbounded"
+    }
+  )).some(Boolean);
+  if (hasJsSignal) {
+    detected.push(getProfile("js-ts"));
+  }
+  const pubspec = yield* readOptionalFile(repoDir, "pubspec.yaml");
+  if (pubspec !== void 0) {
+    detected.push(
+      getProfile(hasFlutterMarkers(pubspec) ? "flutter" : "dart")
+    );
+  }
+  if (yield* hasFile(repoDir, "go.mod")) {
+    detected.push(getProfile("go"));
+  }
+  return { profiles: detected };
+});
+var getProfileMismatchWarning = (selectedProfiles, detection) => {
+  if (detection.profiles.length === 0) return void 0;
+  const detectedNames = new Set(detection.profiles.map((p3) => p3.name));
+  const mismatches = selectedProfiles.filter((p3) => !detectedNames.has(p3.name));
+  if (mismatches.length === 0) return void 0;
+  const selected = selectedProfiles.map((p3) => p3.name).join(", ");
+  const detected = detection.profiles.map((p3) => p3.name).join(", ");
+  const mismatchNames = mismatches.map((p3) => p3.name).join(", ");
+  return `Selected profile${mismatches.length === 1 ? "" : "s"} ${mismatchNames} did not match detected repository profile${detection.profiles.length === 1 ? "" : "s"} (${detected}). Continuing because custom layouts and monorepos may still be valid. Selected: ${selected}.`;
+};
 function getNextStepsLines(template, mainFilename, issueTracker, agent, packageManager) {
   if (issueTracker.name === "custom") {
     return [
@@ -18530,6 +18630,61 @@ var rewritePromptFiles = (configDir) => Effect_exports.gen(function* () {
     { concurrency: "unbounded" }
   );
 });
+var isPromptFile = (filename) => filename.endsWith("prompt.md");
+var buildProfilesPromptSection = (profiles) => {
+  const entries = profiles.map((p3) => `- ${p3.label} \u2014 \`.sandcastle/${profileGuidancePath(p3.name)}\``).join("\n");
+  return `# Project profiles
+
+This project was scaffolded for the profile(s) below. Read each guidance file and follow its setup and validation commands instead of assuming a specific toolchain:
+
+${entries}
+`;
+};
+var buildProfileSetupHookCommand = (profile, setupCommand) => {
+  const bin = setupCommand.split(" ")[0];
+  const guidance = `.sandcastle/${profileGuidancePath(profile.name)}`;
+  return `command -v ${bin} >/dev/null 2>&1 && ${setupCommand} || echo 'Sandcastle: ${bin} not found in sandbox \u2014 add it to .sandcastle/Dockerfile (see ${guidance})'`;
+};
+var rewriteProfileReferences = (configDir, profiles, mainFilename) => Effect_exports.gen(function* () {
+  const fs = yield* FileSystem_exports.FileSystem;
+  const files = yield* fs.readDirectory(configDir).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+  const promptSection = buildProfilesPromptSection(profiles);
+  const promptFiles = files.filter(isPromptFile);
+  yield* Effect_exports.all(
+    promptFiles.map(
+      (f) => Effect_exports.gen(function* () {
+        const filePath = join(configDir, f);
+        const content = yield* fs.readFileString(filePath).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+        let updated = content.replace(
+          /`npm run typecheck` and `npm run test`/g,
+          "the validation commands listed in your project profile guidance under `.sandcastle/profiles/`"
+        );
+        updated = `${updated.trimEnd()}
+
+${promptSection}`;
+        yield* fs.writeFileString(filePath, updated).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+      })
+    ),
+    { concurrency: "unbounded" }
+  );
+  const hasJsProfile = profiles.some((p3) => p3.name === DEFAULT_PROFILE_NAME);
+  const primary = profiles[0];
+  const setupCommand = primary?.setupCommands[0];
+  if (!hasJsProfile && primary && setupCommand) {
+    const mainPath = join(configDir, mainFilename);
+    const mainExists = yield* fs.exists(mainPath).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+    if (mainExists) {
+      const mainContent = yield* fs.readFileString(mainPath).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+      const rewritten = mainContent.replace(
+        /command: "npm install"/g,
+        `command: ${JSON.stringify(buildProfileSetupHookCommand(primary, setupCommand))}`
+      );
+      if (rewritten !== mainContent) {
+        yield* fs.writeFileString(mainPath, rewritten).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+      }
+    }
+  }
+});
 var TEXT_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".md",
   ".txt",
@@ -18625,6 +18780,54 @@ sandcastle ${cliNamespace} build-image
 
 Run your **list** command inside the built image and confirm it returns the open tasks as JSON. If it errors, fix the command or the auth and rebuild.
 `;
+var PROFILES_DIR = "profiles";
+var PROFILES_METADATA_FILE = `${PROFILES_DIR}/profiles.json`;
+var profileGuidancePath = (profileName) => `${PROFILES_DIR}/${profileName}.md`;
+var buildProfileGuidanceDoc = (profile) => {
+  const setup = profile.setupCommands.map((c) => `- \`${c}\``).join("\n");
+  const commands = profile.validationCommands.map((c) => `- \`${c}\``).join("\n");
+  return `# ${profile.label} profile
+
+${profile.guidance}
+
+## Suggested setup commands
+
+${setup}
+
+## Suggested validation commands
+
+${commands}
+
+> These commands are guidance, not a contract. Sandcastle does not install or pin the SDK for this profile \u2014 adapt them to the project's actual scripts and tooling.
+`;
+};
+var scaffoldProfiles = (configDir, profiles) => Effect_exports.gen(function* () {
+  const fs = yield* FileSystem_exports.FileSystem;
+  const profilesDir = join(configDir, PROFILES_DIR);
+  yield* fs.makeDirectory(profilesDir, { recursive: true }).pipe(Effect_exports.mapError((e) => new Error(e.message)));
+  const metadata = {
+    profiles: profiles.map((p3) => ({
+      name: p3.name,
+      label: p3.label,
+      guidance: profileGuidancePath(p3.name)
+    }))
+  };
+  yield* Effect_exports.all(
+    [
+      fs.writeFileString(
+        join(configDir, PROFILES_METADATA_FILE),
+        JSON.stringify(metadata, null, 2) + "\n"
+      ).pipe(Effect_exports.mapError((e) => new Error(e.message))),
+      ...profiles.map(
+        (profile) => fs.writeFileString(
+          join(configDir, profileGuidancePath(profile.name)),
+          buildProfileGuidanceDoc(profile)
+        ).pipe(Effect_exports.mapError((e) => new Error(e.message)))
+      )
+    ],
+    { concurrency: "unbounded" }
+  );
+});
 var detectMainFilename = (repoDir) => Effect_exports.gen(function* () {
   const fs = yield* FileSystem_exports.FileSystem;
   const pkgPath = join(repoDir, "package.json");
@@ -18646,9 +18849,13 @@ var scaffold = (repoDir, options3) => Effect_exports.gen(function* () {
     createLabel = true,
     issueTracker = ISSUE_TRACKER_REGISTRY[0],
     // default: github-issues
-    sandboxProvider = SANDBOX_PROVIDER_REGISTRY[0]
+    sandboxProvider = SANDBOX_PROVIDER_REGISTRY[0],
     // default: docker
+    profiles
   } = options3;
+  const selectedProfiles = resolveProfileEntries(
+    (profiles ?? []).map((p3) => p3.name)
+  );
   if (agents.length === 0) {
     yield* Effect_exports.fail(new Error("At least one agent must be selected."));
   }
@@ -18698,9 +18905,11 @@ var scaffold = (repoDir, options3) => Effect_exports.gen(function* () {
       buildSetupIssueTrackerDoc(sandboxProvider.cliNamespace)
     ).pipe(Effect_exports.mapError((e) => new Error(e.message)));
   }
+  yield* scaffoldProfiles(configDir, selectedProfiles);
+  yield* rewriteProfileReferences(configDir, selectedProfiles, mainFilename);
   return { mainFilename };
 });
-var VERSION = "0.7.0" ;
+var VERSION = "0.8.0" ;
 
 // src/cli.ts
 var imageNameOption = Options_exports.text("image-name").pipe(
@@ -18754,6 +18963,12 @@ var issueTrackerOption = Options_exports.text("issue-tracker").pipe(
   ),
   Options_exports.optional
 );
+var profileOption = Options_exports.text("profile").pipe(
+  Options_exports.withDescription(
+    "Comma-separated project profiles to scaffold (e.g. js-ts,go)"
+  ),
+  Options_exports.optional
+);
 var createLabelOption = Options_exports.choice("create-label", [
   "true",
   "false"
@@ -18779,6 +18994,24 @@ var installTemplateDepsOption = Options_exports.choice("install-template-deps",
   Options_exports.optional
 );
 var choiceToTriBool = (opt) => opt._tag === "Some" ? Option_exports.some(opt.value === "true") : Option_exports.none();
+var parseCommaSeparatedNames = (value2) => value2.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+var resolveProfileFlagEntries = (value2) => {
+  const names = parseCommaSeparatedNames(value2);
+  if (names.length === 0) {
+    throw new Error("--profile must name at least one profile.");
+  }
+  return resolveProfileEntries(names);
+};
+var promptForProfiles = async (profiles = listProfiles()) => clack.multiselect({
+  message: "Select one or more project profiles:",
+  initialValues: [DEFAULT_PROFILE_NAME],
+  required: true,
+  options: profiles.map((p3) => ({
+    value: p3.name,
+    label: p3.label,
+    hint: p3.validationCommands.join(", ")
+  }))
+});
 var initCommand = Command_exports.make(
   "init",
   {
@@ -18788,6 +19021,7 @@ var initCommand = Command_exports.make(
     model: initModelOption,
     sandbox: sandboxOption,
     issueTracker: issueTrackerOption,
+    profile: profileOption,
     createLabel: createLabelOption,
     buildImage: buildImageOption,
     installTemplateDeps: installTemplateDepsOption
@@ -18799,6 +19033,7 @@ var initCommand = Command_exports.make(
     model: modelFlag,
     sandbox: sandboxFlag,
     issueTracker: issueTrackerFlag,
+    profile: profileFlag,
     createLabel: createLabelFlag,
     buildImage: buildImageFlag,
     installTemplateDeps: installTemplateDepsFlag
@@ -18840,6 +19075,17 @@ var initCommand = Command_exports.make(
         );
       }
     }
+    if (profileFlag._tag === "Some") {
+      try {
+        resolveProfileFlagEntries(profileFlag.value);
+      } catch (e) {
+        yield* Effect_exports.fail(
+          new InitError({
+            message: `${e instanceof Error ? e.message : e}`
+          })
+        );
+      }
+    }
     const createLabelChoice = choiceToTriBool(createLabelFlag);
     const buildImageChoice = choiceToTriBool(buildImageFlag);
     const installTemplateDepsChoice = choiceToTriBool(
@@ -18920,6 +19166,31 @@ var initCommand = Command_exports.make(
     }
     const defaultAgent = selectedAgents[0];
     const modelOverride = modelFlag._tag === "Some" ? modelFlag.value : void 0;
+    const profiles = listProfiles();
+    let selectedProfiles;
+    if (profileFlag._tag === "Some") {
+      selectedProfiles = resolveProfileFlagEntries(profileFlag.value);
+    } else if (isInteractive) {
+      const selected = yield* Effect_exports.promise(
+        () => promptForProfiles(profiles)
+      );
+      if (clack.isCancel(selected)) {
+        yield* Effect_exports.fail(
+          new InitError({ message: "Profile selection cancelled." })
+        );
+      }
+      selectedProfiles = selected.map((n) => getProfile(n));
+    } else {
+      selectedProfiles = resolveProfileEntries([]);
+    }
+    const repositoryProfileDetection = yield* detectRepositoryProfiles(cwd);
+    const profileMismatchWarning = getProfileMismatchWarning(
+      selectedProfiles,
+      repositoryProfileDetection
+    );
+    if (profileMismatchWarning) {
+      yield* d.status(profileMismatchWarning, "warn");
+    }
     const sandboxProviders = listSandboxProviders();
     let selectedSandboxProvider;
     if (sandboxFlag._tag === "Some") {
@@ -19024,7 +19295,8 @@ var initCommand = Command_exports.make(
         templateName: selectedTemplate,
         createLabel: shouldCreateLabel,
         issueTracker: selectedIssueTracker,
-        sandboxProvider: selectedSandboxProvider
+        sandboxProvider: selectedSandboxProvider,
+        profiles: selectedProfiles
       }).pipe(
         Effect_exports.mapError(
           (e) => new InitError({