@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/kernel/DevPluginConfig.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "preset": {
+      "default": "standard",
+      "description": "Base configuration preset",
+      "type": "string",
+      "enum": [
+        "minimal",
+        "standard",
+        "full"
+      ]
+    },
+    "services": {
+      "description": "Per-service dev overrides keyed by service name",
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "minLength": 1
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "default": true,
+            "description": "Enable or disable this service",
+            "type": "boolean"
+          },
+          "strategy": {
+            "default": "memory",
+            "description": "Implementation strategy for development",
+            "type": "string",
+            "enum": [
+              "mock",
+              "memory",
+              "stub",
+              "passthrough"
+            ]
+          },
+          "config": {
+            "description": "Strategy-specific configuration for this service override",
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          }
+        },
+        "required": [
+          "enabled",
+          "strategy"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "fixtures": {
+      "description": "Fixture data loading configuration",
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": true,
+          "description": "Load fixture data on startup",
+          "type": "boolean"
+        },
+        "paths": {
+          "description": "Glob patterns for fixture files",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resetBeforeLoad": {
+          "default": true,
+          "description": "Clear existing data before loading fixtures",
+          "type": "boolean"
+        },
+        "envFilter": {
+          "description": "Only load fixtures matching these environment tags",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "enabled",
+        "resetBeforeLoad"
+      ],
+      "additionalProperties": false
+    },
+    "tools": {
+      "description": "Developer tooling settings",
+      "type": "object",
+      "properties": {
+        "hotReload": {
+          "default": true,
+          "description": "Enable HMR / live-reload",
+          "type": "boolean"
+        },
+        "requestInspector": {
+          "default": false,
+          "description": "Enable request inspector",
+          "type": "boolean"
+        },
+        "dbExplorer": {
+          "default": false,
+          "description": "Enable database explorer UI",
+          "type": "boolean"
+        },
+        "verboseLogging": {
+          "default": true,
+          "description": "Enable verbose logging",
+          "type": "boolean"
+        },
+        "apiDocs": {
+          "default": true,
+          "description": "Serve OpenAPI docs at /_dev/docs",
+          "type": "boolean"
+        },
+        "mailCatcher": {
+          "default": false,
+          "description": "Capture outbound emails in dev",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "hotReload",
+        "requestInspector",
+        "dbExplorer",
+        "verboseLogging",
+        "apiDocs",
+        "mailCatcher"
+      ],
+      "additionalProperties": false
+    },
+    "port": {
+      "default": 4400,
+      "description": "Port for the dev-tools dashboard",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 65535
+    },
+    "open": {
+      "default": false,
+      "description": "Auto-open dev dashboard in browser",
+      "type": "boolean"
+    },
+    "seedAdminUser": {
+      "default": true,
+      "description": "Create a default admin user for development",
+      "type": "boolean"
+    },
+    "simulatedLatency": {
+      "default": 0,
+      "description": "Artificial latency (ms) added to service calls",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "preset",
+    "port",
+    "open",
+    "seedAdminUser",
+    "simulatedLatency"
+  ],
+  "additionalProperties": false
+}

package/json-schema/kernel/DevPluginPreset.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "minimal",
+    "standard",
+    "full"
+  ],
+  "description": "Predefined dev configuration profile"
+}

package/json-schema/kernel/DevServiceOverride.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "service": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target service identifier"
+    },
+    "enabled": {
+      "default": true,
+      "description": "Enable or disable this service",
+      "type": "boolean"
+    },
+    "strategy": {
+      "default": "memory",
+      "description": "Implementation strategy for development",
+      "type": "string",
+      "enum": [
+        "mock",
+        "memory",
+        "stub",
+        "passthrough"
+      ]
+    },
+    "config": {
+      "description": "Strategy-specific configuration for this service override",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    }
+  },
+  "required": [
+    "service",
+    "enabled",
+    "strategy"
+  ],
+  "additionalProperties": false
+}

package/json-schema/kernel/DevToolsConfig.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "hotReload": {
+      "default": true,
+      "description": "Enable HMR / live-reload",
+      "type": "boolean"
+    },
+    "requestInspector": {
+      "default": false,
+      "description": "Enable request inspector",
+      "type": "boolean"
+    },
+    "dbExplorer": {
+      "default": false,
+      "description": "Enable database explorer UI",
+      "type": "boolean"
+    },
+    "verboseLogging": {
+      "default": true,
+      "description": "Enable verbose logging",
+      "type": "boolean"
+    },
+    "apiDocs": {
+      "default": true,
+      "description": "Serve OpenAPI docs at /_dev/docs",
+      "type": "boolean"
+    },
+    "mailCatcher": {
+      "default": false,
+      "description": "Capture outbound emails in dev",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "hotReload",
+    "requestInspector",
+    "dbExplorer",
+    "verboseLogging",
+    "apiDocs",
+    "mailCatcher"
+  ],
+  "additionalProperties": false
+}

package/json-schema/kernel/DisablePackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false

package/json-schema/kernel/EnablePackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false

package/json-schema/kernel/GetPackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false

package/json-schema/kernel/InstallPackageRequest.json

@@ -388,6 +388,32 @@
                 ],
                 "additionalProperties": false
               }
+            },
+            "commands": {
+              "description": "CLI command contributions",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]*$",
+                    "description": "CLI command name"
+                  },
+                  "description": {
+                    "description": "Command description for help text",
+                    "type": "string"
+                  },
+                  "module": {
+                    "description": "Module path exporting Commander.js commands",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              }
             }
           },
           "additionalProperties": false

package/json-schema/kernel/InstallPackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false

package/json-schema/kernel/InstalledPackage.json

@@ -388,6 +388,32 @@
                 ],
                 "additionalProperties": false
               }
+            },
+            "commands": {
+              "description": "CLI command contributions",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9-]*$",
+                    "description": "CLI command name"
+                  },
+                  "description": {
+                    "description": "Command description for help text",
+                    "type": "string"
+                  },
+                  "module": {
+                    "description": "Module path exporting Commander.js commands",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              }
             }
           },
           "additionalProperties": false

package/json-schema/kernel/ListPackagesResponse.json

@@ -393,6 +393,32 @@
                       ],
                       "additionalProperties": false
                     }
+                  },
+                  "commands": {
+                    "description": "CLI command contributions",
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string",
+                          "pattern": "^[a-z][a-z0-9-]*$",
+                          "description": "CLI command name"
+                        },
+                        "description": {
+                          "description": "Command description for help text",
+                          "type": "string"
+                        },
+                        "module": {
+                          "description": "Module path exporting Commander.js commands",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name"
+                      ],
+                      "additionalProperties": false
+                    }
                   }
                 },
                 "additionalProperties": false

package/json-schema/kernel/Manifest.json

@@ -385,6 +385,32 @@
             ],
             "additionalProperties": false
           }
+        },
+        "commands": {
+          "description": "CLI command contributions",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*$",
+                "description": "CLI command name"
+              },
+              "description": {
+                "description": "Command description for help text",
+                "type": "string"
+              },
+              "module": {
+                "description": "Module path exporting Commander.js commands",
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          }
         }
       },
       "additionalProperties": false

package/json-schema/kernel/MetadataFallbackStrategy.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "filesystem",
+    "memory",
+    "none"
+  ]
+}

package/json-schema/kernel/MetadataLoaderContract.json

@@ -8,6 +8,13 @@
     },
     "protocol": {
       "type": "string",
+      "enum": [
+        "file:",
+        "http:",
+        "s3:",
+        "datasource:",
+        "memory:"
+      ],
       "description": "Protocol identifier"
     },
     "capabilities": {

package/json-schema/kernel/MetadataManagerConfig.json

@@ -2,6 +2,25 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {
+    "datasource": {
+      "description": "Datasource name reference for database persistence",
+      "type": "string"
+    },
+    "tableName": {
+      "default": "sys_metadata",
+      "description": "Database table name for metadata storage",
+      "type": "string"
+    },
+    "fallback": {
+      "default": "none",
+      "description": "Fallback strategy when datasource is unavailable",
+      "type": "string",
+      "enum": [
+        "filesystem",
+        "memory",
+        "none"
+      ]
+    },
     "rootDir": {
       "description": "Root directory path",
       "type": "string"
@@ -117,6 +136,8 @@
     }
   },
   "required": [
+    "tableName",
+    "fallback",
     "formats",
     "watch"
   ],

package/json-schema/security/RLSAuditConfig.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "description": "Enable RLS audit logging"
+    },
+    "logLevel": {
+      "type": "string",
+      "enum": [
+        "all",
+        "denied_only",
+        "granted_only",
+        "none"
+      ],
+      "description": "Which evaluations to log"
+    },
+    "destination": {
+      "type": "string",
+      "enum": [
+        "system_log",
+        "audit_trail",
+        "external"
+      ],
+      "description": "Audit log destination"
+    },
+    "sampleRate": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Sampling rate (0-1) for high-traffic environments"
+    },
+    "retentionDays": {
+      "default": 90,
+      "description": "Audit log retention period in days",
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    },
+    "includeRowData": {
+      "default": false,
+      "description": "Include row data in audit logs (security-sensitive)",
+      "type": "boolean"
+    },
+    "alertOnDenied": {
+      "default": true,
+      "description": "Send alerts when access is denied",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "enabled",
+    "logLevel",
+    "destination",
+    "sampleRate",
+    "retentionDays",
+    "includeRowData",
+    "alertOnDenied"
+  ],
+  "additionalProperties": false
+}