Pack manifest — knowledgebases (domains)

import { defineScrydonPack } from '@scrydon/sdk-authoring/packs'

export default defineScrydonPack({
  package: {
    id: 'com.example.knowledge-pack',
    version: '1.0.0',
    displayName: 'Knowledge Pack',
  },

  knowledgebases: [
    {
      // Required — unique within this org, lowercase kebab-case.
      slug: 'learnings',
      displayName: 'Project Learnings',
      description: 'Durable project learnings.',

      // Which ontologies type the rows in this domain. Each slug must match an
      // ontology shipped by THIS Pack (the installer resolves slugs against the
      // pack's own ontology id).
      ontologies: ['com.example.knowledge-pack'],

      // Where rows are persisted. Org-KB content is tabular in StarRocks —
      // 'starrocks' is the only backend, and this field is optional (it
      // defaults to 'starrocks', so you can omit it entirely).
      storageBackend: 'starrocks',

      defaults: {
        // How long rows are retained before the retention sweep removes them.
        // Number of days. Omit for indefinite retention.
        retentionDays: 1825, // 5 years

        // Once true, rows can only be revoked — never overwritten by a later
        // promote. This flag cannot be relaxed after install (one-way ratchet).
        immutable: false,

        readPolicy: {
          // Properties classified above this level are redacted at read time
          // for callers without elevated privilege.
          // One of: 'public' | 'internal' | 'confidential' | 'restricted'.
          maxClassification: 'internal',

          // Org-scoped roles required to read this domain at all. Optional.
          requiredRoles: ['org:analyst', 'org:knowledge-lead'],
        },

        promotionPolicy: {
          // Minimum explicit approvals before materialization. 0 = auto-approve.
          requiredApprovals: 1,

          // Named reviewer slots filled from specific roles. The platform
          // resolves actual users at request-creation time (snapshot).
          // NOTE the field is `required` (a count), not `count`.
          roleSlots: [
            { role: 'org:knowledge-lead', required: 1 },
          ],

          // How long (seconds) a promotion request may sit pending before it
          // expires.
          expirationSeconds: 604800, // 7 days

          // Auto-file a promotion request when a workspace row matches.
          // An array of per-object-type trigger entries (see "Conditions").
          autoPromoteWhen: [
            {
              objectTypeSlug: 'Project',
              conditions: [
                { kind: 'property', property: 'status', equals: 'validated' },
              ],
            },
          ],

          // Approve a pending request without a human reviewer when the source
          // rows match. Same shape as autoPromoteWhen.
          autoApproveWhen: [
            {
              objectTypeSlug: 'Project',
              conditions: [
                { kind: 'property', property: 'value', equals: 'low' },
                { kind: 'lifecycle', equals: 'short' },
              ],
            },
          ],
        },
      },
    },
  ],

  // ... ontology and process-flow entries as usual
})

{
  objectTypeSlug: 'Project',     // the source object type this entry applies to
  conditions: [ /* … */ ],   // evaluated AND-wise within the entry
}

{
  kind: 'property',
  // The property slug on the object type (not a dotted path).
  property: 'status',

  // Provide exactly one matcher:
  equals: 'validated',           // exact string / number / boolean match
  // matches: 'Enterprise',      // ECMAScript regex against the property value
  // olderThan: '90d',           // duration <N>(s|m|h|d); true if the value is a
  //                             // timestamp older than now - duration
}

// Match projects whose name contains "Enterprise"
{ kind: 'property', property: 'name', matches: 'Enterprise' }

// Match rows created more than 90 days ago
{ kind: 'property', property: 'createdAt', olderThan: '90d' }

{
  kind: 'lifecycle',
  equals: 'long',          // 'long' | 'short' | 'unknown'
  minConfidence: 0.9,      // optional — require the classifier confidence ≥ threshold
}

autoPromoteWhen: [
  // Entry A: validated AND high-confidence long-lived  → fires
  {
    objectTypeSlug: 'Project',
    conditions: [
      { kind: 'property', property: 'status', equals: 'validated' },
      { kind: 'lifecycle', equals: 'long', minConfidence: 0.8 },
    ],
  },
  // Entry B: strategic priority (OR with entry A)         → also fires
  {
    objectTypeSlug: 'Project',
    conditions: [
      { kind: 'property', property: 'priority', equals: 'strategic' },
    ],
  },
]