@impetik/xeer-mcp 0.2.10 → 0.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impetik/xeer-mcp",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "type": "module",
   "description": "Model Context Protocol server for Xeer: the scaffold, check, dev, build, and deploy loop as agent tools.",
   "license": "MIT",
@@ -47,7 +47,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.0.10",
-    "@impetik/xeer": "0.2.10"
+    "@impetik/xeer": "0.2.12"
   },
   "devDependencies": {
     "@types/node": "^24.1.0"

package/vendor/spec/index.d.ts

@@ -18,3 +18,4 @@ export * from './admin.js';
 export * from './admin-sql.js';
 export * from './network-policy.js';
 export * from './review.js';
+export * from './template.js';

package/vendor/spec/index.js

@@ -18,3 +18,4 @@ export * from './admin.js';
 export * from './admin-sql.js';
 export * from './network-policy.js';
 export * from './review.js';
+export * from './template.js';

package/vendor/spec/template.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const TEMPLATE_FORMAT: "xeer.template.v0";
+export declare const TEMPLATE_MANIFEST_SCHEMA_URL: "https://docs.xeer.run/template-v0.schema.json";
+export declare const templateManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    format: z.ZodLiteral<"xeer.template.v0">;
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    keyHighlights: z.ZodArray<z.ZodString>;
+    screenshots: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        alt: z.ZodString;
+    }, z.core.$strict>>;
+    author: z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    capabilities: z.ZodArray<z.ZodEnum<{
+        database: "database";
+        storage: "storage";
+    }>>;
+    requiredSecrets: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>;
+    previewAppId: z.ZodString;
+}, z.core.$strict>;
+export type TemplateManifestV0 = z.infer<typeof templateManifestSchema>;
+export declare const templateManifestJsonSchema: Readonly<Record<string, unknown>>;
+export declare function parseTemplateManifest(value: unknown): TemplateManifestV0;

package/vendor/spec/template.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { CAPABILITIES } from './types.js';
+export const TEMPLATE_FORMAT = 'xeer.template.v0';
+export const TEMPLATE_MANIFEST_SCHEMA_URL = 'https://docs.xeer.run/template-v0.schema.json';
+const trimmed = (maximum) => z.string().min(1).max(maximum)
+    .refine((value) => value === value.trim(), 'must not have leading or trailing whitespace')
+    .refine((value) => !/[\u0000-\u001f\u007f]/u.test(value), 'must not contain control characters');
+const slug = z.string().regex(/^[a-z][a-z0-9-]{1,62}$/u, 'must be a lowercase slug between 2 and 63 characters');
+const environmentName = z.string().regex(/^[A-Z][A-Z0-9_]{0,63}$/u, 'must be an uppercase environment variable name');
+const appId = z.string().regex(/^app_[A-Za-z0-9_-]{8,96}$/u, 'must be a valid Xeer appId');
+const screenshotPath = z.string().regex(/^screenshots\/(?:[A-Za-z0-9][A-Za-z0-9._-]*\/)*[A-Za-z0-9][A-Za-z0-9._-]*\.(?:avif|jpe?g|png|webp)$/u, 'must be a repository-local AVIF, JPEG, PNG, or WebP path under screenshots/');
+const authorSchema = z.strictObject({
+    name: trimmed(80),
+    url: z.string().url().optional(),
+});
+const requiredSecretSchema = z.strictObject({
+    name: environmentName,
+    description: trimmed(200),
+});
+const screenshotSchema = z.strictObject({
+    path: screenshotPath,
+    alt: trimmed(200),
+});
+export const templateManifestSchema = z.strictObject({
+    $schema: z.string().url().optional(),
+    format: z.literal(TEMPLATE_FORMAT),
+    title: trimmed(120),
+    description: trimmed(300),
+    category: slug,
+    tags: z.array(trimmed(40)).min(1).max(16),
+    keyHighlights: z.array(trimmed(120)).min(1).max(8),
+    screenshots: z.array(screenshotSchema).min(1).max(8),
+    author: authorSchema,
+    capabilities: z.array(z.enum(CAPABILITIES)).max(CAPABILITIES.length),
+    requiredSecrets: z.array(requiredSecretSchema).max(16),
+    previewAppId: appId,
+}).superRefine((manifest, ctx) => {
+    const unique = (values, path, label) => {
+        const seen = new Set();
+        for (const [index, value] of values.entries()) {
+            const normalized = value.toLocaleLowerCase('en-US');
+            if (seen.has(normalized)) {
+                ctx.addIssue({ code: 'custom', path: [path, index], message: `${label} is declared twice` });
+            }
+            seen.add(normalized);
+        }
+    };
+    unique(manifest.tags, 'tags', 'tag');
+    unique(manifest.keyHighlights, 'keyHighlights', 'highlight');
+    unique(manifest.screenshots.map((screenshot) => screenshot.path), 'screenshots', 'screenshot');
+    unique(manifest.capabilities, 'capabilities', 'capability');
+    unique(manifest.requiredSecrets.map((secret) => secret.name), 'requiredSecrets', 'secret');
+});
+const generatedTemplateManifestJsonSchema = z.toJSONSchema(templateManifestSchema);
+const generatedProperties = generatedTemplateManifestJsonSchema.properties;
+export const templateManifestJsonSchema = Object.freeze({
+    ...generatedTemplateManifestJsonSchema,
+    $id: TEMPLATE_MANIFEST_SCHEMA_URL,
+    title: 'Xeer template manifest v0',
+    description: 'Authored metadata for one application in the Xeer template catalog.',
+    properties: {
+        ...generatedProperties,
+        $schema: {
+            ...generatedProperties.$schema,
+            description: 'Editor schema hint. Xeer does not fetch this URL during validation.',
+        },
+        format: {
+            ...generatedProperties.format,
+            description: `Template metadata protocol discriminator; exactly ${TEMPLATE_FORMAT}.`,
+        },
+        tags: {
+            ...generatedProperties.tags,
+            uniqueItems: true,
+        },
+        keyHighlights: {
+            ...generatedProperties.keyHighlights,
+            uniqueItems: true,
+        },
+        screenshots: {
+            ...generatedProperties.screenshots,
+            description: 'Repository-local raster images used by template galleries.',
+            uniqueItems: true,
+        },
+        capabilities: {
+            ...generatedProperties.capabilities,
+            description: 'Application capabilities, verified against xeer.app.json when the catalog is generated.',
+            uniqueItems: true,
+        },
+        previewAppId: {
+            ...generatedProperties.previewAppId,
+            description: 'Stable first-party application identity used only for the public live preview.',
+        },
+        requiredSecrets: {
+            ...generatedProperties.requiredSecrets,
+            description: 'Secrets a template copy needs before it is usable.',
+        },
+    },
+});
+export function parseTemplateManifest(value) {
+    return templateManifestSchema.parse(value);
+}