@objectstack/metadata-core 10.3.0 → 11.1.0

package/dist/index.js

@@ -986,9 +986,127 @@ var SysMetadataHistoryObject = ObjectSchema2.create({
   }
 });
 
-// src/objects/sys-metadata-audit.object.ts
+// src/objects/sys-metadata-commit.object.ts
 import { ObjectSchema as ObjectSchema3, Field as Field3 } from "@objectstack/spec/data";
-var SysMetadataAuditObject = ObjectSchema3.create({
+var SysMetadataCommitObject = ObjectSchema3.create({
+  name: "sys_metadata_commit",
+  label: "Metadata Commit",
+  pluralLabel: "Metadata Commits",
+  icon: "git-commit",
+  isSystem: true,
+  managedBy: "system",
+  description: "Package-scoped commit log grouping a turn\u2019s metadata changes (ADR-0067).",
+  fields: {
+    /** Primary Key — the commit id. */
+    id: Field3.text({
+      label: "ID",
+      required: true,
+      readonly: true,
+      maxLength: 64
+    }),
+    /** The app/package this commit belongs to (the unit a user reverts). */
+    package_id: Field3.text({
+      label: "Package",
+      required: false,
+      searchable: true,
+      readonly: true,
+      maxLength: 255
+    }),
+    /** apply = a turn promoted changes; revert = this commit undid another. */
+    operation: Field3.select(["apply", "revert"], {
+      label: "Operation",
+      required: true,
+      readonly: true
+    }),
+    /** Human-readable summary — for AI turns, the user's prompt. */
+    message: Field3.textarea({
+      label: "Message",
+      required: false,
+      readonly: true,
+      description: "Change summary; for AI turns, the user instruction that produced it."
+    }),
+    /** Producing actor (user id, or an AI principal like "ai:claude"). */
+    actor: Field3.text({
+      label: "Actor",
+      required: false,
+      readonly: true,
+      maxLength: 255
+    }),
+    /** AI model that authored the turn (absent for human/CLI commits). */
+    ai_model: Field3.text({
+      label: "AI Model",
+      required: false,
+      readonly: true,
+      maxLength: 100
+    }),
+    /** For a revert commit, the id of the commit it reverted. */
+    parent_commit_id: Field3.text({
+      label: "Parent Commit",
+      required: false,
+      readonly: true,
+      maxLength: 64
+    }),
+    /** First `sys_metadata_history.event_seq` covered by this commit. */
+    event_seq_start: Field3.number({
+      label: "Event Seq Start",
+      required: false,
+      readonly: true
+    }),
+    /** Last `sys_metadata_history.event_seq` covered by this commit. */
+    event_seq_end: Field3.number({
+      label: "Event Seq End",
+      required: false,
+      readonly: true
+    }),
+    /**
+     * JSON array of the artifacts this commit touched, with the data
+     * `revertCommit` needs: [{ type, name, existedBefore, prevVersion }].
+     */
+    items: Field3.textarea({
+      label: "Items",
+      required: false,
+      readonly: true,
+      description: "JSON: [{ type, name, existedBefore, prevVersion }] \u2014 the revert plan."
+    }),
+    /** Number of artifacts in `items` (denormalized for list views). */
+    item_count: Field3.number({
+      label: "Item Count",
+      required: false,
+      readonly: true
+    }),
+    /** Organization ID for multi-tenant isolation. */
+    organization_id: Field3.lookup("sys_organization", {
+      label: "Organization",
+      required: false,
+      readonly: true,
+      description: "Organization for multi-tenant isolation."
+    }),
+    /** When the commit was recorded. */
+    created_at: Field3.datetime({
+      label: "Created At",
+      required: true,
+      readonly: true
+    })
+  },
+  indexes: [
+    // List a package's history newest-first (the timeline read pattern).
+    { fields: ["organization_id", "package_id", "created_at"] },
+    // Org-wide commit replay / audit.
+    { fields: ["organization_id", "created_at"] },
+    { fields: ["parent_commit_id"] }
+  ],
+  enable: {
+    trackHistory: false,
+    searchable: false,
+    apiEnabled: true,
+    apiMethods: ["get", "list"],
+    trash: false
+  }
+});
+
+// src/objects/sys-metadata-audit.object.ts
+import { ObjectSchema as ObjectSchema4, Field as Field4 } from "@objectstack/spec/data";
+var SysMetadataAuditObject = ObjectSchema4.create({
   name: "sys_metadata_audit",
   label: "Metadata Audit",
   pluralLabel: "Metadata Audit",
@@ -998,19 +1116,19 @@ var SysMetadataAuditObject = ObjectSchema3.create({
   description: "Append-only audit trail of metadata write decisions (ADR-0010).",
   fields: {
     /** Primary Key (UUID) */
-    id: Field3.text({
+    id: Field4.text({
       label: "ID",
       required: true,
       readonly: true
     }),
     /** When the decision was made (ISO-8601 UTC). */
-    occurred_at: Field3.datetime({
+    occurred_at: Field4.datetime({
       label: "Occurred At",
       required: true,
       readonly: true
     }),
     /** Acting principal (user id, system id, or 'system'). */
-    actor: Field3.text({
+    actor: Field4.text({
       label: "Actor",
       required: true,
       readonly: true,
@@ -1018,14 +1136,14 @@ var SysMetadataAuditObject = ObjectSchema3.create({
       description: 'Acting principal \u2014 user id, system id, or "system".'
     }),
     /** Code path that produced the decision (e.g. `protocol.saveMetaItem`). */
-    source: Field3.text({
+    source: Field4.text({
       label: "Source",
       required: false,
       readonly: true,
       maxLength: 128
     }),
     /** Metadata type (singular, e.g. `app`, `object`, `view`). */
-    type: Field3.text({
+    type: Field4.text({
       label: "Metadata Type",
       required: true,
       readonly: true,
@@ -1033,7 +1151,7 @@ var SysMetadataAuditObject = ObjectSchema3.create({
       maxLength: 100
     }),
     /** Item machine name. */
-    name: Field3.text({
+    name: Field4.text({
       label: "Name",
       required: true,
       readonly: true,
@@ -1041,19 +1159,19 @@ var SysMetadataAuditObject = ObjectSchema3.create({
       maxLength: 255
     }),
     /** Organization for multi-tenant filtering. NULL for env-wide writes. */
-    organization_id: Field3.lookup("sys_organization", {
+    organization_id: Field4.lookup("sys_organization", {
       label: "Organization",
       required: false,
       readonly: true
     }),
     /** Operation kind. */
-    operation: Field3.select(["save", "publish", "rollback", "delete", "reset"], {
+    operation: Field4.select(["save", "publish", "rollback", "delete", "reset"], {
       label: "Operation",
       required: true,
       readonly: true
     }),
     /** Decision outcome — allowed, denied (refused), or forced (bypassed via override). */
-    outcome: Field3.select(["allowed", "denied", "forced"], {
+    outcome: Field4.select(["allowed", "denied", "forced"], {
       label: "Outcome",
       required: true,
       readonly: true
@@ -1066,7 +1184,7 @@ var SysMetadataAuditObject = ObjectSchema3.create({
      *    `'metadata_conflict'`
      *  - on `forced`: `'lock_override'` (Phase 3)
      */
-    code: Field3.text({
+    code: Field4.text({
       label: "Code",
       required: true,
       readonly: true,
@@ -1078,26 +1196,26 @@ var SysMetadataAuditObject = ObjectSchema3.create({
      * later compliance queries can see "what was the lock state when
      * this write succeeded".
      */
-    lock_state: Field3.select(["none", "no-overlay", "no-delete", "full"], {
+    lock_state: Field4.select(["none", "no-overlay", "no-delete", "full"], {
       label: "Lock State",
       required: false,
       readonly: true
     }),
     /** True when the write succeeded by bypassing a lock (Phase 3). */
-    lock_overridden: Field3.boolean({
+    lock_overridden: Field4.boolean({
       label: "Lock Overridden",
       required: false,
       readonly: true
     }),
     /** Optional request correlation id for tracing. */
-    request_id: Field3.text({
+    request_id: Field4.text({
       label: "Request ID",
       required: false,
       readonly: true,
       maxLength: 128
     }),
     /** Optional free-form context (e.g. brief diff summary). */
-    note: Field3.textarea({
+    note: Field4.textarea({
       label: "Note",
       required: false,
       readonly: true
@@ -1119,8 +1237,8 @@ var SysMetadataAuditObject = ObjectSchema3.create({
 });
 
 // src/objects/sys-view-definition.object.ts
-import { ObjectSchema as ObjectSchema4, Field as Field4 } from "@objectstack/spec/data";
-var SysViewDefinitionObject = ObjectSchema4.create({
+import { ObjectSchema as ObjectSchema5, Field as Field5 } from "@objectstack/spec/data";
+var SysViewDefinitionObject = ObjectSchema5.create({
   name: "sys_view_definition",
   label: "View Definition",
   pluralLabel: "View Definitions",
@@ -1129,73 +1247,73 @@ var SysViewDefinitionObject = ObjectSchema4.create({
   description: "Runtime-authored view definitions (shared / personal layers). The package layer ships from source.",
   fields: {
     /** Primary Key (UUID) */
-    id: Field4.text({ label: "ID", required: true, readonly: true }),
+    id: Field5.text({ label: "ID", required: true, readonly: true }),
     /**
      * Globally-unique qualified view id, `<object>.<viewKey>`, matching the
      * spec `ViewItemSchema.name`. For personal views the runtime may suffix
      * to keep it unique per owner.
      */
-    name: Field4.text({
+    name: Field5.text({
       label: "Name",
       required: true,
       searchable: true,
       maxLength: 255
     }),
     /** Bound object — the foreign key used to aggregate views for the switcher. */
-    object: Field4.text({
+    object: Field5.text({
       label: "Object",
       required: true,
       searchable: true,
       maxLength: 255
     }),
     /** Whether `config` is a ListView (list family) or a FormView. */
-    view_kind: Field4.select(["list", "form"], {
+    view_kind: Field5.select(["list", "form"], {
       label: "View Kind",
       required: true,
       defaultValue: "list"
     }),
     /** Display label (plain string; i18n keys also accepted). */
-    label: Field4.text({ label: "Label", required: false, maxLength: 255 }),
+    label: Field5.text({ label: "Label", required: false, maxLength: 255 }),
     /** Whether this is the object's default view in the switcher. */
-    is_default: Field4.boolean({ label: "Is Default", required: false, defaultValue: false }),
+    is_default: Field5.boolean({ label: "Is Default", required: false, defaultValue: false }),
     /** Sort order within the object's switcher / left rail. */
-    view_order: Field4.number({ label: "Order", required: false, defaultValue: 0 }),
+    view_order: Field5.number({ label: "Order", required: false, defaultValue: 0 }),
     /**
      * Identity layer. Only `shared` and `personal` are stored at runtime;
      * `package` views come from source.
      */
-    scope: Field4.select(["shared", "personal"], {
+    scope: Field5.select(["shared", "personal"], {
       label: "Scope",
       required: true,
       defaultValue: "personal"
     }),
     /** Owner user id — set when scope = personal; null for shared. */
-    owner: Field4.text({ label: "Owner", required: false, maxLength: 255 }),
+    owner: Field5.text({ label: "Owner", required: false, maxLength: 255 }),
     /** Hidden from the switcher (per-user / per-org declutter). */
-    hidden: Field4.boolean({ label: "Hidden", required: false, defaultValue: false }),
+    hidden: Field5.boolean({ label: "Hidden", required: false, defaultValue: false }),
     /** The ListView / FormView configuration payload. */
-    config: Field4.json({
+    config: Field5.json({
       label: "Config",
       required: true,
       description: "ListView or FormView configuration (matches spec ViewItem.config)."
     }),
     /** Organization for multi-tenant isolation. */
-    organization_id: Field4.lookup("sys_organization", {
+    organization_id: Field5.lookup("sys_organization", {
       label: "Organization",
       required: false,
       description: "Organization for multi-tenant isolation."
     }),
     /** Lifecycle state. */
-    state: Field4.select(["draft", "active", "archived"], {
+    state: Field5.select(["draft", "active", "archived"], {
       label: "State",
       required: false,
       defaultValue: "active"
     }),
     /** Audit fields. */
-    created_by: Field4.lookup("sys_user", { label: "Created By", required: false, readonly: true }),
-    created_at: Field4.datetime({ label: "Created At", required: false, readonly: true }),
-    updated_by: Field4.lookup("sys_user", { label: "Updated By", required: false }),
-    updated_at: Field4.datetime({ label: "Updated At", required: false })
+    created_by: Field5.lookup("sys_user", { label: "Created By", required: false, readonly: true }),
+    created_at: Field5.datetime({ label: "Created At", required: false, readonly: true }),
+    updated_by: Field5.lookup("sys_user", { label: "Updated By", required: false }),
+    updated_at: Field5.datetime({ label: "Updated At", required: false })
   },
   indexes: [
     // A given view name is unique per (organization, owner) among active rows —
@@ -1237,6 +1355,7 @@ export {
   SchemaValidationError,
   SysMetadataObject as SysMetadata,
   SysMetadataAuditObject,
+  SysMetadataCommitObject,
   SysMetadataHistoryObject,
   SysMetadataObject,
   SysViewDefinitionObject,