superlore-cli 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -87,7 +87,7 @@ declare function serializeSuperloreJson(config: SuperloreJson): string;
 declare function resolveMcpPath(config: SuperloreJson): string | undefined;
 
 /** The CLI version, kept in sync with package.json at build time. */
-declare const VERSION = "0.4.2";
+declare const VERSION = "0.5.0";
 /** Build the argument parser. Exported for tests; `run()` wires it to argv. */
 declare function buildCli(argv?: readonly string[]): cac.CAC;
 /** Parse argv and dispatch. Reports unknown commands and unexpected errors cleanly. */

package/dist/index.js

@@ -1811,10 +1811,8 @@ function writeSkeleton(root, config) {
           "fumadocs-core": "^16.8.2",
           "fumadocs-mdx": "^14.3.1",
           "fumadocs-ui": "^16.8.2",
-          superlore: "^0.5.3",
+          superlore: "^0.6.0",
           "lucide-react": "^1.21.0",
-          // superlore peers the rendered components pull in: Mermaid (Diagram), themes.
-          mermaid: "^11.15.0",
           ...mcpEnabled ? (
             // mcp-handler pins an EXACT sdk peer (1.26.0); npm errors on anything else (pnpm only
             // warns). Pin the sdk to match so `npm install` resolves cleanly for every package manager.
@@ -2018,6 +2016,53 @@ export const source = loader({
 import { createFromSource } from "superlore/search";
 
 export const { GET } = createFromSource(source);
+`
+  );
+  write(
+    "CLAUDE.md",
+    `# CLAUDE.md \u2014 ${config.name}
+
+This repo is a **superlore** knowledge base: author once in MDX, and humans get a clean visual site
+while agents read the same structured content over MCP. **One corpus. Humans and agents.**
+
+## Author in superlore MDX \u2014 not raw markdown
+
+When you create or edit anything in \`content/docs/\`, **use superlore's dual-representation
+components** wherever one fits. Each renders beautifully for humans AND serializes to typed data the
+MCP serves \u2014 so a diagram is never a flat picture an agent has to guess at; the agent gets the data
+behind it. Default to a component over plain prose, a bullet list, or an ASCII diagram:
+
+- **Canvas** (a fenced \`\`\`superlore-canvas JSON block) \u2014 architecture, system maps, request flows,
+  decision flows. The agent reads the typed { nodes, edges, groups } graph.
+- **Timeline / Schedule** \u2014 dated milestones, roadmaps, history, on-call.
+- **Board** \u2014 now / next / later, kanban.
+- **Decision** \u2014 architecture decision records (context \xB7 decision \xB7 consequences).
+- **Table / Comparison** \u2014 structured rows, option/criteria matrices.
+- **Roster / EntityCard** \u2014 people, teams, services, any entity.
+- **Checklist / Steps** \u2014 runbooks, procedures, onboarding.
+- **Releases** \u2014 changelog, version history.
+- **KeyFacts \xB7 StatGrid \xB7 FeatureList \xB7 MetaBar \xB7 PageHero \xB7 SectionHead** \u2014 editorial structure.
+
+## Look up patterns over MCP
+
+The superlore docs are available to you as an MCP server (\`superlore-docs\`, registered by the
+superlore Claude plugin). Use it for exact component props, the full Canvas vocabulary, and authoring
+patterns \u2014 \`search\`, \`get_page\`, \`list\`, \`navigate\`, \`get_component_data\`. Full reference:
+https://superlore.vercel.app/docs. Don't guess a component's props \u2014 query the MCP or the docs.
+
+## Layout
+
+- \`content/docs/**/*.mdx\` \u2014 the corpus. A \`meta.json\` per folder sets nav order, title, and icon.
+- \`superlore.json\` \u2014 KB config (type, MCP, auth). \`app/api/[transport]/route.ts\` \u2014 the MCP endpoint.
+- \`/\` redirects to \`/docs\` \u2014 a superlore KB *is* its docs.
+
+## Run
+
+- \`superlore dev\` \u2014 preview locally \xB7 \`superlore build\` \u2014 production build.
+- \`superlore connect\` \u2014 install the editor extension for the live dual-view preview + comments.
+
+**The contract:** every component must render for humans *and* serialize for agents. Keep it \u2014 it's
+the whole point.
 `
   );
   writeContent(write, config);
@@ -2432,7 +2477,7 @@ function printNextSteps(root, config) {
 }
 
 // src/index.ts
-var VERSION = "0.4.2";
+var VERSION = "0.5.0";
 function buildCli(argv = process3.argv) {
   const cli = cac("superlore");
   cli.command("init [dir]", "Scaffold a new superlore knowledge base").option("--name <name>", "KB name").option("--type <type>", "KB type: company-kb | product-docs | personal-kb").option("--auth", "Enable the Google SSO auth gate").option("--no-auth", "Disable the auth gate").option("--allowed-domain <domain>", "Restrict SSO to one email domain (implies --auth)").option("--accent <color>", "Brand accent colour (any CSS colour)").option("--no-mcp", "Disable the MCP endpoint (on by default)").option("--connect", "Install the editor extension after scaffolding (skip the prompt)").option("--no-connect", "Don't set up the editor extension").option("-y, --yes", "Skip prompts; use flags + defaults").example("superlore init my-kb --type product-docs").example("superlore init acme --type company-kb --auth --allowed-domain acme.com").example("superlore init me --type personal-kb").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlore-cli",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "The superlore CLI — scaffold, run, and build an agent-native knowledge base. One corpus. Humans and agents.",
   "license": "Apache-2.0",
   "author": "Krishnan S G",