@kybernesis/create 0.1.2 → 0.1.4

package/dist/cli.js

@@ -15,7 +15,7 @@ import { upgrade } from "./upgrade.js";
 const [, , command, ...rest] = process.argv;
 switch (command) {
     case "init":
-        await init(rest.find((a) => !a.startsWith("-")));
+        await init(rest.find((a) => !a.startsWith("-")), { engineer: rest.includes("--engineer") });
         break;
     case "doctor":
         await doctor();
@@ -24,20 +24,19 @@ switch (command) {
         await upgrade(rest.includes("--skip-eval"));
         break;
     case undefined:
-        // `npm create @kybernesis <name>` lands here with the name in rest? No —
-        // npm create passes extra args as argv; treat a bare arg as init's name.
-        await init(undefined);
+        await init(undefined, { engineer: false });
         break;
     default:
         if (!command.startsWith("-")) {
             // `npm create @kybernesis acme-agent` → argv[2] is the name.
-            await init(command);
+            await init(command, { engineer: rest.includes("--engineer") });
             break;
         }
         console.log(`
 ${bold("kyb")} — Kybernesis agent scaffolder & FDE toolkit
 
   ${bold("kyb init [name]")}     scaffold a full Kybernesis eve agent
+      --engineer        ${dim("add the engineer layer: workshop sandbox + vision dev loop")}
   ${bold("kyb doctor")}          preflight checks (keys, issuer, envs, discovery)
   ${bold("kyb upgrade")}         bump @kybernesis/* packages, gated on evals
       --skip-eval       ${dim("skip the eval gate")}

package/dist/init.d.ts

@@ -1 +1,3 @@
-export declare function init(rawName: string | undefined): Promise<void>;
+export declare function init(rawName: string | undefined, options?: {
+    engineer?: boolean;
+}): Promise<void>;

package/dist/init.js

@@ -3,7 +3,10 @@ import { join, resolve } from "node:path";
 import { DEFAULT_ISSUER, EVE_VERSION, REGISTRY_URL, ask, bold, closePrompts, green, run, slug, yellow, } from "./util.js";
 import { envExample, evalFileTs, evalScript, identityMd, rootArcanaTs, subagentAgentTs, subagentArcanaTs, subagentInstructionsMd, } from "./templates.js";
 const ITEMS = ["enterprise", "arcana", "multiplayer", "evals"];
-export async function init(rawName) {
+// Official eve-registry limbs installed alongside the engineer layer.
+const ENGINEER_OFFICIAL_ITEMS = ["extension/agent-browser", "extension/github-tools", "connection/vercel"];
+export async function init(rawName, options) {
+    const engineer = options?.engineer === true;
     const name = slug(rawName ?? (await ask("Agent name (kebab-case)?", "acme-agent")));
     if (!name) {
         console.error("An agent name is required.");
@@ -29,6 +32,17 @@ export async function init(rawName) {
     for (const item of ITEMS) {
         run("npx", ["eve", "add", `@kybernesis/${item}`, "--overwrite"], { cwd: dir });
     }
+    if (engineer) {
+        console.log(bold("\n2b   Engineer layer: workshop sandbox + vision dev loop …"));
+        run("npx", ["eve", "add", "@kybernesis/engineer", "--overwrite"], { cwd: dir });
+        for (const item of ENGINEER_OFFICIAL_ITEMS) {
+            // Official items may carry their own interactive setup; a failure here
+            // shouldn't kill the scaffold — the FDE can re-run `eve add <item>`.
+            const ok = run("npx", ["eve", "add", item, "--overwrite"], { cwd: dir, allowFail: true });
+            if (!ok)
+                console.log(yellow(`  ! ${item} did not install cleanly — re-run: npx eve add ${item}`));
+        }
+    }
     console.log(bold("\n3/6  Writing agent identity, memory mount, and eval wiring …"));
     mkdirSync(join(dir, "agent/instructions"), { recursive: true });
     writeFileSync(join(dir, "agent/instructions/identity.md"), identityMd(displayName, depts));
@@ -68,7 +82,25 @@ export async function init(rawName) {
     const infoOk = run("npx", ["eve", "info"], { cwd: dir, allowFail: true, quiet: true });
     console.log(tsOk && infoOk ? green("  ✓ typecheck + discovery clean") : yellow("  ! verify manually: npm run typecheck && npx eve info"));
     console.log(`
-${green("✓")} ${bold(name)} scaffolded: governed (enterprise) · remembering (arcana) · multiplayer (slack) · self-testing (evals)${depts.length ? ` · ${depts.length} dept subagent(s)` : ""}
+${green("✓")} ${bold(name)} scaffolded: governed (enterprise) · remembering (arcana) · multiplayer (slack) · self-testing (evals)${engineer ? " · engineer (workshop + vision loop)" : ""}${depts.length ? ` · ${depts.length} dept subagent(s)` : ""}${engineer ? `
+
+${bold("Engineer notes:")}
+  · The workshop sandbox (agent/sandbox/sandbox.ts) bakes Playwright into the
+    template at DEPLOY time — a broken bootstrap fails the Vercel build loudly.
+    Deployed sessions run under a domain allowlist; extend it deliberately in
+    that file when a project needs another host.
+  · Vercel connection (preview deploys + link-back), after \`vercel link\`:
+      vercel connect create mcp.vercel.com --name vercel
+      vercel connect attach mcp.vercel.com/vercel --yes
+    then set connect("mcp.vercel.com/vercel") — the UID, not the short name —
+    in agent/connections/vercel.ts. First tool use posts an OAuth link in the
+    thread (user-scoped); grant "All projects" so the agent can create new ones,
+    then narrow the grant in the dashboard once the project exists.
+  · File delivery (the deliver tool needs it):
+      vercel blob create-store ${name}-deliverables --access public --yes
+    links the store and injects BLOB_READ_WRITE_TOKEN automatically.
+  · agent-browser / github-tools may need their Connect setup flows — run
+    their printed setup commands if tools 401.` : ""}
 
 ${bold("Human steps (in order) — the FDE playbook covers each in detail:")}
   1. Arcana: create workspaces (${name}-company, ${name}-eval${depts.map((d) => `, ${name}-${d}`).join("")}) + scoped kb_ keys; fill .env.local from .env.example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/create",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "The Kybernesis agent scaffolder and FDE toolkit: one command to a governed, remembering, multiplayer, self-testing eve agent — plus doctor and upgrade.",
   "license": "Apache-2.0",
   "type": "module",