@vivary/create 0.1.0 → 0.2.0

package/README.md

@@ -2,16 +2,30 @@
 
 **The `create-t3-app` for agent-native workspaces.** Scaffold a complete Vivary
 workspace — typed knowledge graph (tropo), agent OS (strato), and starter graph — in
-one command.
+one command. Generated modules use `modules/<id>/index.md` routers so agents load
+context progressively.
 
 ```bash
 npm create @vivary my-workspace -- --preset coding
+npm create @vivary my-codebase -- --preset coding --active-context cocoindex-code
 # or
 npx @vivary/create my-workspace --preset coding
+
+# Agent-mode (no prompts, machine-readable output):
+npx @vivary/create init . --preset coding --auto --size large --yes --json
+
+# Reconfigure storage on an existing workspace:
+npx @vivary/create wizard my-workspace --auto --storage embedded --yes --json
 ```
 
 Presets: `coding` · `second-brain` · `writing`.
 
+A bare `npm create @vivary <name>` maps to the `init` subcommand; you can also pass
+`init` / `doctor` / `wizard` explicitly (e.g. `npm create @vivary doctor my-workspace`).
+
+On a terminal that supports input, `init` runs a short wizard to pick a storage tier.
+Skip it with `--no-wizard`, or use `--auto` for fully non-interactive agent use.
+
 ## How it works
 
 This package is a thin launcher: it runs the Python `create-vivary` scaffolder via
@@ -19,9 +33,18 @@ This package is a thin launcher: it runs the Python `create-vivary` scaffolder v
 scaffolder stays one source of truth in Python while you get a Node-native entry
 point. **Python 3.11+ and uv (or pipx) must be installed.**
 
-Prefer Python directly? `uvx create-vivary my-workspace --preset coding` or
-`pip install create-vivary`.
+Prefer Python directly? `uvx create-vivary my-workspace --preset coding` — a bare
+target defaults to `init` there too (the PyPI `create-vivary` is versioned in lockstep
+with this launcher) — or `pip install create-vivary`.
+
+For coding workspaces, `--active-context cocoindex-code` scaffolds optional
+CocoIndex-code guidance and ignored sidecar state. It does not auto-install, index, or
+enable MCP; the generated docs give the approved `ccc init` / `ccc index` path.
 
 ## License
 
 MIT.
+
+---
+
+Website & docs: <https://vivary.vercel.app/>

package/index.js

@@ -7,35 +7,57 @@
 
 const { spawnSync } = require("node:child_process");
 
-const args = process.argv.slice(2);
-const onWindows = process.platform === "win32";
-
-// VIVARY_FROM lets dev/CI point at a local wheel or path instead of PyPI.
-const from = process.env.VIVARY_FROM;
-
-function run(cmd, cmdArgs) {
-  return spawnSync(cmd, cmdArgs, { stdio: "inherit", shell: onWindows });
+// The documented UX is `npm create @vivary my-workspace` (create-t3-app style),
+// but the Python CLI expects an explicit `init`/`doctor` subcommand. Default a
+// bare target to `init` so the documented form works; an explicit subcommand or a
+// leading flag (e.g. `-h`/`--help`) passes through unchanged.
+const SUBCOMMANDS = new Set(["init", "doctor"]);
+
+function mapArgs(args) {
+  const first = args[0];
+  if (first && !first.startsWith("-") && !SUBCOMMANDS.has(first)) {
+    return ["init", ...args];
+  }
+  return args;
 }
 
-// 1) uv (uvx) — preferred, fast, no global install.
-let result = run("uvx", from
-  ? ["--from", from, "create-vivary", ...args]
-  : ["create-vivary", ...args]);
-
-// 2) pipx fallback if uv is not installed.
-if (result.error && result.error.code === "ENOENT") {
-  result = run("pipx", from
-    ? ["run", "--spec", from, "create-vivary", ...args]
-    : ["run", "create-vivary", ...args]);
+function main() {
+  const args = mapArgs(process.argv.slice(2));
+  const onWindows = process.platform === "win32";
+
+  // VIVARY_FROM lets dev/CI point at a local wheel or path instead of PyPI.
+  const from = process.env.VIVARY_FROM;
+
+  function run(cmd, cmdArgs) {
+    return spawnSync(cmd, cmdArgs, { stdio: "inherit", shell: onWindows });
+  }
+
+  // 1) uv (uvx) — preferred, fast, no global install.
+  let result = run("uvx", from
+    ? ["--from", from, "create-vivary", ...args]
+    : ["create-vivary", ...args]);
+
+  // 2) pipx fallback if uv is not installed.
+  if (result.error && result.error.code === "ENOENT") {
+    result = run("pipx", from
+      ? ["run", "--spec", from, "create-vivary", ...args]
+      : ["run", "create-vivary", ...args]);
+  }
+
+  // 3) Neither runner present — guide the user.
+  if (result.error && result.error.code === "ENOENT") {
+    console.error(
+      "create-vivary needs Python tooling to run the scaffolder.\n" +
+      "Install uv (https://docs.astral.sh/uv/) or pipx, then re-run `npm create vivary`."
+    );
+    process.exit(1);
+  }
+
+  process.exit(result.status == null ? 1 : result.status);
 }
 
-// 3) Neither runner present — guide the user.
-if (result.error && result.error.code === "ENOENT") {
-  console.error(
-    "create-vivary needs Python tooling to run the scaffolder.\n" +
-    "Install uv (https://docs.astral.sh/uv/) or pipx, then re-run `npm create vivary`."
-  );
-  process.exit(1);
-}
+module.exports = { mapArgs };
 
-process.exit(result.status == null ? 1 : result.status);
+if (require.main === module) {
+  main();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivary/create",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Scaffold a complete Vivary agent workspace — the create-t3-app for agent-native workspaces. Runs the Python create-vivary via uv/pipx.",
   "bin": {
     "create-vivary": "index.js"
@@ -22,7 +22,7 @@
   ],
   "license": "MIT",
   "author": "Jeff Kazzee",
-  "homepage": "https://github.com/vivary-dev/vivary",
+  "homepage": "https://vivary.vercel.app/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vivary-dev/vivary.git"