@cyber-dash-tech/revela 0.17.18 → 0.17.21

package/plugins/revela/mcp/revela-server.ts

@@ -22,9 +22,17 @@ type RuntimeModule = {
   designActivate(input: any): any
   designCreate(input: any): any
   designValidate(input: any): any
+  designDraftCreate(input: any): any
+  designDraftValidate(input: any): any
+  designDraftInstall(input: any): any
   domainList(): any
   domainRead(input?: any): any
   domainActivate(input: any): any
+  domainCreate(input: any): any
+  domainValidate(input: any): any
+  domainDraftCreate(input: any): any
+  domainDraftValidate(input: any): any
+  domainDraftInstall(input: any): any
   storyRead(input?: any): any
   reviewDeckRead(input: any): Promise<any>
   reviewDeckOpen(input: any): Promise<any>
@@ -134,6 +142,35 @@ const tools = [
     description: "Validate a local Revela design package.",
     inputSchema: objectSchema({ name: requiredStringProp("Design name to validate.") }, ["name"]),
   },
+  {
+    name: "revela_design_draft_create",
+    description: "Create and validate a workspace-local Revela design draft package.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Design name in kebab-case."),
+      base: stringProp("Optional base design used as structural scaffold."),
+      designMd: requiredStringProp("Complete DESIGN.md content."),
+      previewHtml: requiredStringProp("Complete preview.html content."),
+      overwrite: booleanProp("Whether to replace an existing workspace draft. Defaults to false."),
+    }, ["name", "designMd", "previewHtml"]),
+  },
+  {
+    name: "revela_design_draft_validate",
+    description: "Validate a workspace-local Revela design draft package.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Design draft name to validate."),
+    }, ["name"]),
+  },
+  {
+    name: "revela_design_draft_install",
+    description: "Install a validated workspace-local Revela design draft into the user-level design registry.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Design draft name to install."),
+      overwrite: booleanProp("Whether to replace an existing user-level design package. Defaults to false."),
+    }, ["name"]),
+  },
   {
     name: "revela_domain_list",
     description: "List installed Revela narrative domains and the active domain.",
@@ -149,6 +186,47 @@ const tools = [
     description: "Activate a Revela narrative domain for future narrative authoring guidance.",
     inputSchema: objectSchema({ name: requiredStringProp("Domain name to activate.") }, ["name"]),
   },
+  {
+    name: "revela_domain_create",
+    description: "Create and validate a local Revela narrative domain package from complete INDUSTRY.md content.",
+    inputSchema: objectSchema({
+      name: requiredStringProp("Domain name in kebab-case."),
+      domainMd: requiredStringProp("Complete INDUSTRY.md content."),
+      overwrite: booleanProp("Whether to replace an existing local domain package. Defaults to false."),
+    }, ["name", "domainMd"]),
+  },
+  {
+    name: "revela_domain_validate",
+    description: "Validate a local Revela narrative domain package.",
+    inputSchema: objectSchema({ name: requiredStringProp("Domain name to validate.") }, ["name"]),
+  },
+  {
+    name: "revela_domain_draft_create",
+    description: "Create and validate a workspace-local Revela narrative domain draft package.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Domain name in kebab-case."),
+      domainMd: requiredStringProp("Complete INDUSTRY.md content."),
+      overwrite: booleanProp("Whether to replace an existing workspace draft. Defaults to false."),
+    }, ["name", "domainMd"]),
+  },
+  {
+    name: "revela_domain_draft_validate",
+    description: "Validate a workspace-local Revela narrative domain draft package.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Domain draft name to validate."),
+    }, ["name"]),
+  },
+  {
+    name: "revela_domain_draft_install",
+    description: "Install a validated workspace-local Revela narrative domain draft into the user-level domain registry.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root."),
+      name: requiredStringProp("Domain draft name to install."),
+      overwrite: booleanProp("Whether to replace an existing user-level domain package. Defaults to false."),
+    }, ["name"]),
+  },
   {
     name: "revela_story_read",
     description: "Read a deterministic Revela Story map and optional Markdown view from the canonical narrative vault without mutating files.",
@@ -278,9 +356,17 @@ async function callTool(name: string, args: any): Promise<any> {
   if (name === "revela_design_activate") return r.designActivate(args)
   if (name === "revela_design_create") return r.designCreate(args)
   if (name === "revela_design_validate") return r.designValidate(args)
+  if (name === "revela_design_draft_create") return r.designDraftCreate(args)
+  if (name === "revela_design_draft_validate") return r.designDraftValidate(args)
+  if (name === "revela_design_draft_install") return r.designDraftInstall(args)
   if (name === "revela_domain_list") return r.domainList()
   if (name === "revela_domain_read") return r.domainRead(args)
   if (name === "revela_domain_activate") return r.domainActivate(args)
+  if (name === "revela_domain_create") return r.domainCreate(args)
+  if (name === "revela_domain_validate") return r.domainValidate(args)
+  if (name === "revela_domain_draft_create") return r.domainDraftCreate(args)
+  if (name === "revela_domain_draft_validate") return r.domainDraftValidate(args)
+  if (name === "revela_domain_draft_install") return r.domainDraftInstall(args)
   if (name === "revela_story_read") return r.storyRead(args)
   if (name === "revela_review_deck_read") return r.reviewDeckRead(args)
   if (name === "revela_review_deck_open") return r.reviewDeckOpen(args)

package/plugins/revela/skills/revela-design/SKILL.md

@@ -25,10 +25,12 @@ Design changes are visual/artifact-level unless they change claim meaning, evide
 
 When the user asks to create a new design, use `starter` as the default base design unless they specify another base. Interview the user before saving anything: collect visual references such as images, webpages, brands, decks, or text descriptions, plus must-have and must-avoid constraints. Summarize the design brief and visual schema, then wait for the user to confirm before creating files.
 
-After confirmation, read the base design with `revela_design_read`. Generate complete `DESIGN.md` and complete `preview.html` content, then call `revela_design_create`. For edits to an existing design, read the existing design first, preserve useful layout/component coverage, and call `revela_design_create` with `overwrite: true` only after the user confirms the edit brief. Always call `revela_design_validate` after creation or overwrite.
+After confirmation, read the base design with `revela_design_read`. Generate complete `DESIGN.md` and complete `preview.html` content, then call `revela_design_draft_create` to save a workspace-local draft under `.revela/drafts/designs/<name>/`. Always call `revela_design_draft_validate` after draft creation or overwrite. The direct registry tools `revela_design_create` and `revela_design_validate` remain available for existing workflows, but Codex design authoring should use the draft workflow before install.
+
+Install the draft globally only after the user confirms the validated draft should be installed. Call `revela_design_draft_install` to copy the draft into the user-level design registry. If a user-level design already exists, pass `overwrite: true` only after the user confirms replacement. In sandboxed Codex sessions, the install step may require permission to write Revela user config under `~/.config/revela`.
 
 `DESIGN.md` must include frontmatter with `name`, `description`, `author`, and `version`, plus valid marker blocks for `@design:foundation`, `@design:rules`, at least one `@layout`, and at least one `@component`.
 
-`preview.html` must be self-contained and directly openable in a browser. Every `<section class="slide">` must include `slide-qa` and exactly one direct `.slide-canvas` child. Include a cover slide with `data-slide-role="cover"`, a closing slide with `data-slide-role="closing"`, and a visible sample for every `@component:*` using `data-preview-component="<component-name>"`.
+`preview.html` must be self-contained and directly openable in a browser. Every `<section class="slide">` must include `slide-qa` and exactly one direct `.slide-canvas` child. Every direct `.slide-canvas` is the fixed 1920px x 1080px export surface and must use explicit CSS with `width: 1920px` and `height: 1080px`; `.slide` may remain a viewport/navigation wrapper. Include a cover slide with `data-slide-role="cover"`, a closing slide with `data-slide-role="closing"`, and a visible sample for every `@component:*` using `data-preview-component="<component-name>"`.
 
-Do not automatically activate a newly created design. Report the saved path and tell the user they can activate it with `revela_design_activate`.
+Do not automatically activate a newly created design. Do not automatically activate a newly installed design. Report the draft path, installed path when installed, and tell the user they can activate it with `revela_design_activate`.

package/plugins/revela/skills/revela-domain/SKILL.md

@@ -5,7 +5,7 @@ description: Use or switch Revela narrative domain guidance in Codex for init, r
 
 # Revela Domain
 
-Use this skill when the user asks about Revela domains, wants domain-specific narrative guidance, or asks to switch the active domain.
+Use this skill when the user asks about Revela domains, wants domain-specific narrative guidance, asks to switch the active domain, or asks to create a new domain.
 
 ## Workflow
 
@@ -16,3 +16,15 @@ Use this skill when the user asks about Revela domains, wants domain-specific na
 5. Do not treat domain guidance as evidence, source material, or proof for factual claims.
 
 Domain changes are narrative-framing preferences. They do not rewrite existing claims, evidence boundaries, artifacts, or deck plans unless the user asks for those updates.
+
+## Creating Or Editing Domains
+
+When the user asks to create a new domain, interview the user before saving anything. Collect the communication context, typical audience, decisions, claim patterns, evidence expectations, common objections, risks, research-gap heuristics, terminology to use, and terminology to avoid. Summarize the domain brief, then wait for the user to confirm before creating files.
+
+After confirmation, generate complete `INDUSTRY.md` content and call `revela_domain_draft_create` to save a workspace-local draft under `.revela/drafts/domains/<name>/`. Always call `revela_domain_draft_validate` after draft creation or overwrite.
+
+Install the draft globally only after the user confirms the validated draft should be installed. Call `revela_domain_draft_install` to copy the draft into the user-level domain registry. If a user-level domain already exists, pass `overwrite: true` only after the user confirms replacement. In sandboxed Codex sessions, the install step may require permission to write Revela user config under `~/.config/revela`.
+
+`INDUSTRY.md` must include frontmatter with `name`, `description`, `author`, and `version`, followed by concrete narrative guidance for audience framing, decision framing, claim standards, evidence expectations, objection/risk handling, and research-gap interpretation.
+
+Do not automatically activate a newly installed domain. Report the draft path, installed path when installed, and tell the user they can activate it with `revela_domain_activate`.

package/plugins/revela/skills/revela-upgrade/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: revela-upgrade
+description: Guide Revela Codex plugin upgrade, update, version, and reinstall requests while checking the running runtime version first.
+---
+
+# Revela Upgrade
+
+Use this skill when the user asks how to upgrade, update, reinstall, or check the version of the Revela Codex plugin.
+
+## Workflow
+
+1. Call `revela_doctor` first to inspect the currently running Revela runtime version.
+2. Report the current runtime version from doctor output. Do not check the latest version online unless the user explicitly asks you to look it up.
+3. Explain that the Codex Git marketplace ref and `.mcp.json` npm runtime pin are published together for the same Revela release.
+4. If the user wants a fixed release, guide them through removing the installed plugin, removing the marketplace entry, adding the desired release tag, then adding the plugin again:
+
+```bash
+codex plugin remove revela@revela
+codex plugin marketplace remove revela
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref vX.Y.Z
+codex plugin add revela@revela
+```
+
+5. If the user already tracks a branch or movable ref, guide them through upgrading the marketplace clone, then re-adding the plugin:
+
+```bash
+codex plugin marketplace upgrade revela
+codex plugin add revela@revela
+```
+
+6. Tell the user to start a new Codex thread after upgrading so Codex reloads the Revela skills, MCP tools, hooks, and runtime pin.
+
+Do not run `codex plugin remove`, `codex plugin marketplace remove`, `codex plugin marketplace add`, `codex plugin marketplace upgrade`, or `codex plugin add` unless the user explicitly asks you to perform the upgrade or reinstall.