@shawaze/agentspace 0.3.2 → 0.3.5

package/README.md

@@ -89,6 +89,28 @@ npx @shawaze/agentspace init
 It refuses to write into a non-empty directory unless you pass `--force`, and
 `--dry-run` prints what it would write without touching disk.
 
+**Non-interactive** (CI / reproducible scaffolding): skip the wizard and pass a
+JSON config.
+
+```bash
+npx @shawaze/agentspace init --config workspace.json
+```
+
+```jsonc
+// workspace.json
+{
+  "workspaceName": "my-product",
+  "shape": "one-product",
+  "repos": [
+    { "name": "api", "remote": "https://github.com/me/api.git", "stack": "rails", "role": "backend" },
+    { "name": "web", "remote": "https://github.com/me/web.git", "stack": "nextjs", "role": "frontend" }
+  ],
+  "dependencyOrder": ["api", "web"],
+  "pillars": ["manifest", "wiki", "enforcement", "contracts"],
+  "enforcement": { "mode": "auto", "warmPages": 5, "warmSessions": 10 }
+}
+```
+
 ### `agentspace doctor`
 
 Mechanical health checks on a generated workspace — manifest validity,

package/dist/cli.js

@@ -265,7 +265,7 @@ function generateManifest(ctx) {
   };
   return [
     { path: "manifest.yaml", contents: render(MANIFEST_YAML, view) },
-    { path: "clone-repos.sh", contents: render(CLONE_REPOS_SH, view) },
+    { path: "clone-repos.sh", contents: render(CLONE_REPOS_SH, view), mode: 493 },
     { path: ".gitignore", contents: render(GITIGNORE, view) },
     { path: "CLAUDE.md", contents: render(ROOT_CLAUDE, view) },
     { path: "README.md", contents: render(ROOT_README, view) }
@@ -668,6 +668,7 @@ function claudeCodeAdapter(intents, ctx) {
 
 // src/fs/writeTree.ts
 import {
+  chmod,
   cp,
   mkdir,
   mkdtemp,
@@ -676,6 +677,7 @@ import {
   rm,
   writeFile
 } from "fs/promises";
+import { existsSync as existsSync3 } from "fs";
 import { dirname as dirname2, join as join4 } from "path";
 async function isNonEmptyDir(dir) {
   try {
@@ -699,16 +701,12 @@ async function writeTree(files, targetDir, opts) {
       const dest = join4(temp, file.path);
       await mkdir(dirname2(dest), { recursive: true });
       await writeFile(dest, file.contents);
+      if (file.mode !== void 0) await chmod(dest, file.mode);
     }
-    if (opts.force) {
-      await cp(temp, targetDir, { recursive: true, force: true });
-      await rm(temp, { recursive: true, force: true });
-    } else if (await isNonEmptyDir(targetDir)) {
+    if (existsSync3(targetDir)) {
       await cp(temp, targetDir, { recursive: true, force: true });
       await rm(temp, { recursive: true, force: true });
     } else {
-      await rm(targetDir, { recursive: true, force: true }).catch(() => {
-      });
       await rename(temp, targetDir);
     }
   } catch (err) {
@@ -729,20 +727,24 @@ var DEFAULT_ENFORCEMENT = {
 };
 
 // src/wizard/assemble.ts
+var str = (v) => (v ?? "").trim();
 function assembleConfig(answers) {
   const pillars = ["manifest"];
   if (answers.enableWiki) pillars.push("wiki");
   if (answers.enableEnforcement) pillars.push("enforcement");
   if (answers.enableContracts) pillars.push("contracts");
   return {
-    workspaceName: answers.workspaceName.trim(),
+    workspaceName: str(answers.workspaceName),
     shape: answers.shape,
-    repos: answers.repos.map((r) => ({
-      name: r.name.trim(),
-      remote: r.remote.trim() === "" ? null : r.remote.trim(),
-      stack: r.stack,
-      role: r.role.trim()
-    })),
+    repos: answers.repos.map((r) => {
+      const remote = str(r.remote);
+      return {
+        name: str(r.name),
+        remote: remote === "" ? null : remote,
+        stack: str(r.stack) || "generic",
+        role: str(r.role)
+      };
+    }),
     dependencyOrder: shapeHasDependencyOrder(answers.shape) ? answers.dependencyOrder : null,
     pillars,
     enforcement: answers.enableEnforcement ? { ...DEFAULT_ENFORCEMENT } : null
@@ -873,6 +875,71 @@ async function runWizard() {
   });
 }
 
+// src/config.ts
+import { readFileSync as readFileSync3 } from "fs";
+var SHAPES = [
+  "single-repo",
+  "one-product",
+  "peer-services",
+  "library-consumers",
+  "unrelated"
+];
+var PILLARS = ["manifest", "wiki", "contracts", "enforcement"];
+var MODES = ["auto", "warn", "block"];
+function validateConfig(raw) {
+  if (!raw || typeof raw !== "object") {
+    throw new Error("config must be a JSON object");
+  }
+  const o = raw;
+  const workspaceName = typeof o.workspaceName === "string" ? o.workspaceName.trim() : "";
+  if (!workspaceName) throw new Error("config.workspaceName is required");
+  if (typeof o.shape !== "string" || !SHAPES.includes(o.shape)) {
+    throw new Error(`config.shape must be one of: ${SHAPES.join(", ")}`);
+  }
+  const shape = o.shape;
+  if (!Array.isArray(o.repos) || o.repos.length === 0) {
+    throw new Error("config.repos must be a non-empty array");
+  }
+  const repos = o.repos.map((r, i) => {
+    const rr = r ?? {};
+    const name = typeof rr.name === "string" ? rr.name.trim() : "";
+    if (!name) throw new Error(`config.repos[${i}].name is required`);
+    const remote = typeof rr.remote === "string" && rr.remote.trim() !== "" ? rr.remote.trim() : null;
+    const stack = typeof rr.stack === "string" && rr.stack.trim() ? rr.stack.trim() : "generic";
+    const role = typeof rr.role === "string" ? rr.role.trim() : "";
+    return { name, remote, stack, role };
+  });
+  let pillars = Array.isArray(o.pillars) ? o.pillars.filter((p2) => PILLARS.includes(p2)) : ["manifest", "wiki"];
+  if (pillars.length === 0) pillars = ["manifest", "wiki"];
+  if (!pillars.includes("manifest")) pillars = ["manifest", ...pillars];
+  const dependencyOrder = Array.isArray(o.dependencyOrder) ? o.dependencyOrder.filter((s) => typeof s === "string") : null;
+  let enforcement = null;
+  if (pillars.includes("enforcement")) {
+    const e = o.enforcement ?? {};
+    enforcement = {
+      mode: MODES.includes(e.mode) ? e.mode : DEFAULT_ENFORCEMENT.mode,
+      warmPages: typeof e.warmPages === "number" ? e.warmPages : DEFAULT_ENFORCEMENT.warmPages,
+      warmSessions: typeof e.warmSessions === "number" ? e.warmSessions : DEFAULT_ENFORCEMENT.warmSessions
+    };
+  }
+  return { workspaceName, shape, repos, dependencyOrder, pillars, enforcement };
+}
+function loadConfig(path) {
+  let raw;
+  try {
+    raw = readFileSync3(path, "utf8");
+  } catch {
+    throw new Error(`Cannot read config file: ${path}`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`config file is not valid JSON: ${path}`);
+  }
+  return validateConfig(parsed);
+}
+
 // src/commands/init.ts
 function generateWorkspace(config, today) {
   const ctx = buildContext(config, today);
@@ -895,8 +962,8 @@ async function runInit(config, targetDir, opts) {
   await writeTree(files, targetDir, { force: opts.force });
 }
 async function initCommand(opts) {
-  const config = await runWizard();
-  await runInit(config, process.cwd(), opts);
+  const config = opts.configPath ? loadConfig(opts.configPath) : await runWizard();
+  await runInit(config, process.cwd(), { force: opts.force, today: opts.today });
   console.log(`
 \u2713 Created ${config.workspaceName} (${config.pillars.join(", ")}).`);
   console.log("  Next: ./clone-repos.sh");
@@ -909,7 +976,7 @@ async function initCommand(opts) {
 
 // src/commands/doctor.ts
 import { readFile, readdir as readdir2, stat } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { join as join5, relative } from "path";
 import { parse as parse2 } from "yaml";
 
@@ -1004,7 +1071,7 @@ async function runChecks(workspaceDir, today, deps = {}) {
       }
     }
   }
-  if (existsSync3(join5(workspaceDir, "openspec")) && !isOpenspecAvailable()) {
+  if (existsSync4(join5(workspaceDir, "openspec")) && !isOpenspecAvailable()) {
     findings.push({
       level: "warn",
       message: "openspec/ is present but the `openspec` CLI was not found on PATH. Install it (https://github.com/Fission-AI/OpenSpec) and run `openspec update`."
@@ -1031,25 +1098,28 @@ async function doctorCommand(workspaceDir, today, opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "0.3.2";
+var VERSION = "0.3.5";
 
 // src/cli.ts
 function parseArgs(argv) {
   const force = argv.includes("--force");
   const lint = argv.includes("--lint");
+  const ci = argv.indexOf("--config");
+  const configPath = ci >= 0 ? argv[ci + 1] : void 0;
   const first = argv[0];
-  if (first === "init") return { command: "init", force, lint };
-  if (first === "doctor") return { command: "doctor", force, lint };
-  if (first === "--version" || first === "-v") return { command: "version", force, lint };
-  return { command: "help", force, lint };
+  if (first === "init") return { command: "init", force, lint, configPath };
+  if (first === "doctor") return { command: "doctor", force, lint, configPath };
+  if (first === "--version" || first === "-v") return { command: "version", force, lint, configPath };
+  return { command: "help", force, lint, configPath };
 }
 var HELP = `agentspace \u2014 scaffold an agent-native multi-repo workspace
 
 Usage:
-  agentspace init [--force]   Interactively scaffold a workspace in the current dir
-  agentspace doctor           Run mechanical health checks on a workspace
-  agentspace --version        Print version
-  agentspace --help           Show this help
+  agentspace init [--force]            Interactively scaffold a workspace in the current dir
+  agentspace init --config <file>      Scaffold non-interactively from a JSON config
+  agentspace doctor [--lint]           Run mechanical health checks (--lint = JSON output)
+  agentspace --version                 Print version
+  agentspace --help                    Show this help
 `;
 function todayIso() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -1058,7 +1128,7 @@ async function main(argv) {
   const args = parseArgs(argv);
   switch (args.command) {
     case "init":
-      await initCommand({ force: args.force, today: todayIso() });
+      await initCommand({ force: args.force, today: todayIso(), configPath: args.configPath });
       return 0;
     case "doctor":
       return doctorCommand(process.cwd(), todayIso(), { lint: args.lint });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shawaze/agentspace",
   "publishConfig": { "access": "public" },
-  "version": "0.3.2",
+  "version": "0.3.5",
   "description": "Scaffold an agent-native multi-repo workspace — keep sibling repos coherent for AI coding agents",
   "type": "module",
   "bin": { "agentspace": "dist/cli.js" },
@@ -34,6 +34,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
     "prepublishOnly": "npm run typecheck && npm run build && npm test"
   },
   "dependencies": {