@jay-framework/jay-stack-cli 0.25.0 → 0.25.2

package/dist/index.d.ts

@@ -1,6 +1,15 @@
 import { LogLevel } from '@jay-framework/logger';
 export { MaterializeContractsOptions, MaterializeResult, PluginContractEntry, PluginsIndex, PluginsIndexEntry, listContracts, materializeContracts } from '@jay-framework/stack-server-build';
 
+/**
+ * `express.static` `setHeaders` callback that mirrors production for agent-readiness resources
+ * (DL#217): everything under `/.well-known/` is served CORS-open, with `SKILL.md` as
+ * `text/markdown` and skill archives (`.gz`) as `application/gzip`. Exported so the dev-serving
+ * test guards the real behavior rather than a copy.
+ */
+declare function setWellKnownHeaders(res: {
+    setHeader(name: string, value: string): void;
+}, filePath: string): void;
 interface StartDevServerOptions {
     projectPath?: string;
     testMode?: boolean;
@@ -19,10 +28,34 @@ interface JayConfig {
     };
     site?: {
         baseUrl?: string;
+        /** Site/organization name — drives Organization + WebSite JSON-LD (DL#213). */
+        name?: string;
+        /** Logo URL (absolute or baseUrl-relative) for the Organization JSON-LD (DL#213). */
+        logo?: string;
+        /** Short site description for the Organization JSON-LD (DL#213). */
+        description?: string;
+        /** Social/profile URLs for the Organization `sameAs` (DL#213). */
+        sameAs?: string[];
+    };
+    /** Project-wide validation suppressions for project-level concerns (DL#214). */
+    validations?: {
+        /**
+         * Suppress the `/.well-known/ard.json` absence nudge — for sites with no agent-callable
+         * resources/APIs to advertise. Lives in `.jay` (not a page's `application/jay-validations`
+         * script) because it governs a single project-level file, not any page's markup.
+         */
+        'allow-no-ard'?: boolean;
+        /**
+         * Suppress the minimum-error-pages nudge — for sites that intentionally ship no branded
+         * `404`/`5xx` pages and accept the plain-text fallback. Lives in `.jay` (not a page's
+         * `application/jay-validations` script) because it governs the project's `pages/` tree as a
+         * whole, not any single page's markup (DL#218).
+         */
+        'allow-no-error-pages'?: boolean;
     };
 }
 declare function loadConfig(projectRoot?: string): JayConfig;
 declare function getConfigWithDefaults(config: JayConfig): Required<Pick<JayConfig, 'devServer'>> & Pick<JayConfig, 'site'>;
 declare function updateConfig(updates: Partial<JayConfig>): void;
 
-export { type JayConfig, type StartDevServerOptions, getConfigWithDefaults, loadConfig, startDevServer, updateConfig };
+export { type JayConfig, type StartDevServerOptions, getConfigWithDefaults, loadConfig, setWellKnownHeaders, startDevServer, updateConfig };