@cyber-dash-tech/revela 0.18.8 → 0.18.10

package/lib/runtime/index.ts

@@ -11,11 +11,15 @@ import {
   getDesignLayout,
   getDesignSection,
   getDesignSkillMd,
+  installDesignArchive,
   installDesignDraftPackage,
+  listDesignAssets,
   listDesigns,
+  packDesignPackage,
   seedBuiltinDesigns,
   validateDesignDraftPackage,
   validateDesignPackage,
+  type DesignPackageAssetInput,
 } from "../design/designs"
 import { createDeckFoundation as createDeckFoundationShell } from "../deck-html/foundation"
 import { activeDomain, activateDomain, createDomainDraftPackage, createDomainPackage, getDomainSkillMd, installDomainDraftPackage, listDomains, seedBuiltinDomains, validateDomainDraftPackage, validateDomainPackage } from "../domain/domains"
@@ -85,6 +89,7 @@ export interface RuntimeDesignCreateInput {
   base?: string
   designMd: string
   previewHtml: string
+  assets?: DesignPackageAssetInput[]
   overwrite?: boolean
 }
 
@@ -103,6 +108,21 @@ export interface RuntimeDraftInstallInput extends RuntimeWorkspaceInput {
   overwrite?: boolean
 }
 
+export interface RuntimeDesignPackInput extends RuntimeWorkspaceInput {
+  name: string
+  source?: "draft" | "installed"
+  outputPath?: string
+  format?: "tar.gz" | "tar"
+  overwrite?: boolean
+}
+
+export interface RuntimeDesignArchiveInstallInput {
+  archivePath: string
+  name?: string
+  overwrite?: boolean
+  activate?: boolean
+}
+
 export interface RuntimeNameInput {
   name: string
 }
@@ -296,6 +316,7 @@ export function designRead(input: RuntimeDesignReadInput = {}) {
       name,
       section: input.section,
       markdown,
+      assets: listDesignAssets(name),
     }
     if (input.section === "rules") recordDesignRulesRead(root(input.workspaceRoot), name, markdown)
     return result
@@ -304,6 +325,7 @@ export function designRead(input: RuntimeDesignReadInput = {}) {
     ok: true,
     name,
     markdown: getDesignSkillMd(name),
+    assets: listDesignAssets(name),
   }
 }
 
@@ -341,6 +363,7 @@ export function designCreate(input: RuntimeDesignCreateInput) {
     base: input.base,
     designMd: requiredString(input?.designMd, "designMd"),
     previewHtml: requiredString(input?.previewHtml, "previewHtml"),
+    assets: input.assets,
     overwrite: input.overwrite ?? false,
   })
 }
@@ -356,6 +379,7 @@ export function designDraftCreate(input: RuntimeDesignDraftCreateInput) {
     base: input.base,
     designMd: requiredString(input?.designMd, "designMd"),
     previewHtml: requiredString(input?.previewHtml, "previewHtml"),
+    assets: input.assets,
     overwrite: input.overwrite ?? false,
   })
 }
@@ -373,6 +397,31 @@ export function designDraftInstall(input: RuntimeDraftInstallInput) {
   })
 }
 
+export function designPack(input: RuntimeDesignPackInput) {
+  return packDesignPackage({
+    workspaceRoot: root(input.workspaceRoot),
+    name: requiredName(input, "design"),
+    source: input.source,
+    outputPath: input.outputPath,
+    format: input.format,
+    overwrite: input.overwrite ?? false,
+  })
+}
+
+export function designInstallArchive(input: RuntimeDesignArchiveInstallInput) {
+  seedBuiltinDesigns()
+  const installed = installDesignArchive({
+    archivePath: requiredString(input?.archivePath, "archivePath"),
+    name: input.name,
+    overwrite: input.overwrite ?? false,
+  })
+  if (input.activate) {
+    activateDesign(installed.name)
+    return { ...installed, activated: true, activeDesign: installed.name }
+  }
+  return { ...installed, activated: false }
+}
+
 export interface DesignRulesReadinessResult {
   ok: boolean
   activeDesign: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.18.8",
+  "version": "0.18.10",
   "description": "OpenCode plugin for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",

package/plugins/revela/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "revela": {
       "command": "npx",
-      "args": ["-y", "@cyber-dash-tech/revela@0.18.8", "mcp"]
+      "args": ["-y", "@cyber-dash-tech/revela@0.18.10", "mcp"]
     }
   }
 }

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

@@ -28,6 +28,8 @@ type RuntimeModule = {
   designDraftCreate(input: any): any
   designDraftValidate(input: any): any
   designDraftInstall(input: any): any
+  designPack(input: any): any
+  designInstallArchive(input: any): any
   domainList(): any
   domainRead(input?: any): any
   domainActivate(input: any): any
@@ -175,6 +177,7 @@ const tools = [
       base: stringProp("Optional base design used as structural scaffold."),
       designMd: requiredStringProp("Complete DESIGN.md content."),
       previewHtml: requiredStringProp("Complete preview.html content."),
+      assets: designAssetsProp(),
       overwrite: booleanProp("Whether to replace an existing local design package. Defaults to false."),
     }, ["name", "designMd", "previewHtml"]),
   },
@@ -192,6 +195,7 @@ const tools = [
       base: stringProp("Optional base design used as structural scaffold."),
       designMd: requiredStringProp("Complete DESIGN.md content."),
       previewHtml: requiredStringProp("Complete preview.html content."),
+      assets: designAssetsProp(),
       overwrite: booleanProp("Whether to replace an existing workspace draft. Defaults to false."),
     }, ["name", "designMd", "previewHtml"]),
   },
@@ -212,6 +216,28 @@ const tools = [
       overwrite: booleanProp("Whether to replace an existing user-level design package. Defaults to false."),
     }, ["name"]),
   },
+  {
+    name: "revela_design_pack",
+    description: "Package an installed or workspace-draft Revela design as a shareable .tar or .tar.gz archive.",
+    inputSchema: objectSchema({
+      workspaceRoot: stringProp("Optional workspace root. Used for draft source lookup and default output path."),
+      name: requiredStringProp("Design name in kebab-case."),
+      source: enumProp(["draft", "installed"], "Package a workspace draft or installed design. Defaults to draft when a matching draft exists."),
+      outputPath: stringProp("Optional archive output path. Defaults to .revela/design-archives/{name}.tar.gz under the workspace."),
+      format: enumProp(["tar.gz", "tar"], "Archive format. Defaults to tar.gz."),
+      overwrite: booleanProp("Whether to replace an existing archive. Defaults to false."),
+    }, ["name"]),
+  },
+  {
+    name: "revela_design_install_archive",
+    description: "Install a local .tar or .tar.gz Revela design archive into the user-level design registry.",
+    inputSchema: objectSchema({
+      archivePath: requiredStringProp("Local path to a .tar, .tar.gz, or .tgz design archive."),
+      name: stringProp("Optional installed design name override."),
+      overwrite: booleanProp("Whether to replace an existing user-level design package. Defaults to false."),
+      activate: booleanProp("Whether to activate the design after installation. Defaults to false."),
+    }, ["archivePath"]),
+  },
   {
     name: "revela_domain_list",
     description: "List installed Revela narrative domains and the active domain.",
@@ -410,6 +436,8 @@ async function callTool(name: string, args: any): Promise<any> {
   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_design_pack") return r.designPack(args)
+  if (name === "revela_design_install_archive") return r.designInstallArchive(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)
@@ -495,6 +523,24 @@ function arrayObjectProp(description: string) {
   }
 }
 
+function designAssetsProp() {
+  return {
+    type: "array",
+    description: "Optional design-owned assets to write under assets/**. Each item must use path plus content, contentBase64, or sourcePath.",
+    items: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Package-relative asset path. Must start with assets/." },
+        content: { type: "string", description: "UTF-8 text asset content." },
+        contentBase64: { type: "string", description: "Base64-encoded binary asset content." },
+        sourcePath: { type: "string", description: "Local file path to copy into the design asset." },
+      },
+      required: ["path"],
+      additionalProperties: false,
+    },
+  }
+}
+
 function componentPlanArrayProp() {
   const childSchema: any = {
     type: "object",

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

@@ -1,17 +1,19 @@
 ---
 name: revela-design
-description: Create, edit, validate, install, activate, inspect, or list Revela design packages in Codex using design MCP tools.
+description: Create, edit, validate, package, share, install, activate, inspect, or list Revela design packages in Codex using design MCP tools.
 ---
 
 # Revela Design
 
-Use this skill when the user asks to create, customize, edit, validate, install, activate, inspect, list, or switch a Revela design.
+Use this skill when the user asks to create, customize, edit, validate, package, share, install, activate, inspect, list, or switch a Revela design.
 
 ## Contract
 
 - Designs define deck visual systems: rules, foundation, layouts, components, chart rules, and preview coverage.
+- Designs may include package-owned `assets/**` such as cover or closing backgrounds; design tools surface these as design elements, not source evidence.
 - Default authoring is workspace draft first, then validate, then install only when appropriate.
 - Direct user-level creation is reserved for explicit create/install-now requests.
+- Shareable design archives are `.tar` or `.tar.gz`; install archives only from trusted local paths.
 - Do not use domain tools for visual design work.
 - Do not generate deck HTML while authoring a design.
 
@@ -34,6 +36,14 @@ For new or edited designs:
 7. Call `revela_design_draft_install` only after the draft validates and the user intent is to install it.
 8. Call `revela_design_activate` only when the user asks to make it active.
 
+For sharing or installing design archives:
+
+1. Call `revela_design_draft_validate` or `revela_design_validate` before packaging.
+2. Call `revela_design_pack` to create a `.tar.gz` archive from a workspace draft or installed design.
+3. Call `revela_design_install_archive` to install a local `.tar` or `.tar.gz` archive.
+4. After archive installation, call `revela_design_inventory` or `revela_design_read` to confirm the design and assets are readable.
+5. Call `revela_design_activate` only when the user asks to make the installed design active, or use `activate: true` on archive install when the request is explicit.
+
 Use `revela_design_create` only when the user explicitly requests direct local creation outside the workspace draft workflow. Follow it with `revela_design_validate`.
 
 ## Design Package Requirements
@@ -41,6 +51,7 @@ Use `revela_design_create` only when the user explicitly requests direct local c
 - Use a kebab-case design name.
 - `DESIGN.md` must include valid frontmatter and complete design marker sections.
 - Include design rules, foundation guidance, at least one layout, and at least one component.
+- Optional assets must live under `assets/**`; reference them as package-relative paths like `assets/cover-background.png`.
 - `preview.html` must use the fixed Revela preview canvas contract and visibly preview the design.
 - Preview must include cover and closing examples and showcase every component.
 - Preserve source inspiration and limitations explicitly; do not copy copyrighted design text or assets into the package.
@@ -48,6 +59,8 @@ Use `revela_design_create` only when the user explicitly requests direct local c
 ## Outputs
 
 - Design draft path/status or installed design name.
+- Archive path/status when packaging or installing a shareable design.
+- Asset metadata surfaced by read/inventory tools when `assets/**` exists.
 - Validation result and any remaining diagnostics.
 - Whether the design was activated.
 - Next step, usually `revela-research` for planning with the design or `revela-make-deck` when a valid `deck-plan.md` already exists.

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

@@ -48,12 +48,21 @@ Use this skill to turn user intent and available workspace context into a concis
 - `## Audience`
 - `## Decision Or Action`
 - `## Output`
+- `## Language`
+- `## Domain / Use Case`
+- `## Design`
 - `## Constraints`
 - `## Available Materials`
 - `## Known Gaps`
 - `## Acceptance Criteria`
 - `## Recommended Next Step`
 
+Section expectations:
+
+- `## Language`: output language, terminology preference, and localization notes.
+- `## Domain / Use Case`: active or requested domain, business/use-case context, and decision context.
+- `## Design`: active or requested design, visual direction, and brand/style constraints.
+
 Use explicit `Unknown` or `Pending user input` entries instead of inventing requirements.
 
 ## Outputs