@lssm/example.versioned-knowledge-base 0.0.0-canary-20251217060804 → 0.0.0-canary-20251217062139

package/dist/entities/models.d.ts

@@ -1,93 +1,93 @@
-import * as _lssm_lib_schema15 from "@lssm/lib.schema";
+import * as _lssm_lib_schema84 from "@lssm/lib.schema";
 
 //#region src/entities/models.d.ts
-declare const SourceDocumentModel: _lssm_lib_schema15.SchemaModel<{
+declare const SourceDocumentModel: _lssm_lib_schema84.SchemaModel<{
   id: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   authority: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   fetchedAt: {
-    type: _lssm_lib_schema15.FieldType<Date, string>;
+    type: _lssm_lib_schema84.FieldType<Date, string>;
     isOptional: false;
   };
   hash: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   fileId: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
 }>;
-declare const SourceRefModel: _lssm_lib_schema15.SchemaModel<{
+declare const SourceRefModel: _lssm_lib_schema84.SchemaModel<{
   sourceDocumentId: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   excerpt: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: true;
   };
 }>;
-declare const RuleModel: _lssm_lib_schema15.SchemaModel<{
+declare const RuleModel: _lssm_lib_schema84.SchemaModel<{
   id: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   topicKey: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
 }>;
-declare const RuleVersionModel: _lssm_lib_schema15.SchemaModel<{
+declare const RuleVersionModel: _lssm_lib_schema84.SchemaModel<{
   id: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   ruleId: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   topicKey: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema15.FieldType<number, number>;
+    type: _lssm_lib_schema84.FieldType<number, number>;
     isOptional: false;
   };
   content: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   sourceRefs: {
-    type: _lssm_lib_schema15.SchemaModel<{
+    type: _lssm_lib_schema84.SchemaModel<{
       sourceDocumentId: {
-        type: _lssm_lib_schema15.FieldType<string, string>;
+        type: _lssm_lib_schema84.FieldType<string, string>;
         isOptional: false;
       };
       excerpt: {
-        type: _lssm_lib_schema15.FieldType<string, string>;
+        type: _lssm_lib_schema84.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -95,42 +95,42 @@ declare const RuleVersionModel: _lssm_lib_schema15.SchemaModel<{
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   approvedBy: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: true;
   };
   approvedAt: {
-    type: _lssm_lib_schema15.FieldType<Date, string>;
+    type: _lssm_lib_schema84.FieldType<Date, string>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema15.FieldType<Date, string>;
+    type: _lssm_lib_schema84.FieldType<Date, string>;
     isOptional: false;
   };
 }>;
-declare const KBSnapshotModel: _lssm_lib_schema15.SchemaModel<{
+declare const KBSnapshotModel: _lssm_lib_schema84.SchemaModel<{
   id: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isOptional: false;
   };
   asOfDate: {
-    type: _lssm_lib_schema15.FieldType<Date, string>;
+    type: _lssm_lib_schema84.FieldType<Date, string>;
     isOptional: false;
   };
   includedRuleVersionIds: {
-    type: _lssm_lib_schema15.FieldType<string, string>;
+    type: _lssm_lib_schema84.FieldType<string, string>;
     isArray: true;
     isOptional: false;
   };
   publishedAt: {
-    type: _lssm_lib_schema15.FieldType<Date, string>;
+    type: _lssm_lib_schema84.FieldType<Date, string>;
     isOptional: false;
   };
 }>;

package/dist/entities/models.js

@@ -1 +1 @@
-import{ScalarTypeEnum as e,defineSchemaModel as t}from"@lssm/lib.schema";const n=t({name:`SourceDocument`,description:`Immutable raw source document metadata referencing a stored file.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),r=t({name:`SourceRef`,description:`Reference to a source document used to justify a rule version.`,fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),i=t({name:`Rule`,description:`Curated rule (stable identity) with topic + jurisdiction scope.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),a=t({name:`RuleVersion`,description:`A versioned rule content with source references and approval status.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`KBSnapshot`,description:`Published KB snapshot (as-of) referencing approved rule versions.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{o as KBSnapshotModel,i as RuleModel,a as RuleVersionModel,n as SourceDocumentModel,r as SourceRefModel};
+import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";const n=t({name:`SourceDocument`,description:`Immutable raw source document metadata referencing a stored file.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),r=t({name:`SourceRef`,description:`Reference to a source document used to justify a rule version.`,fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),i=t({name:`Rule`,description:`Curated rule (stable identity) with topic + jurisdiction scope.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),a=t({name:`RuleVersion`,description:`A versioned rule content with source references and approval status.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`KBSnapshot`,description:`Published KB snapshot (as-of) referencing approved rule versions.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{o as KBSnapshotModel,i as RuleModel,a as RuleVersionModel,n as SourceDocumentModel,r as SourceRefModel};

package/dist/events.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 
 //#region src/events.d.ts
 declare const KbSourceIngestedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{

package/dist/events.js

@@ -1 +1 @@
-import{defineEvent as e,defineSchemaModel as t}from"@lssm/lib.contracts";import{ScalarTypeEnum as n}from"@lssm/lib.schema";const r=e({name:`kb.source.ingested`,version:1,description:`Source document ingested (immutable).`,payload:t({name:`KbSourceIngestedPayload`,description:`Emitted when a source document is ingested.`,fields:{sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1}}})}),i=e({name:`kb.ruleVersion.created`,version:1,description:`Rule version created (draft).`,payload:t({name:`KbRuleVersionCreatedPayload`,description:`Emitted when a rule version draft is created.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},ruleId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1}}})}),a=e({name:`kb.ruleVersion.approved`,version:1,description:`Rule version approved (human verified).`,payload:t({name:`KbRuleVersionApprovedPayload`,description:`Emitted when a rule version is approved.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}})}),o=e({name:`kb.snapshot.published`,version:1,description:`KB snapshot published.`,payload:t({name:`KbSnapshotPublishedPayload`,description:`Emitted when a KB snapshot is published.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{a as KbRuleVersionApprovedEvent,i as KbRuleVersionCreatedEvent,o as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent};
+import{n as e}from"./libs/contracts/dist/schema/dist/SchemaModel.js";import{e as t}from"./libs/contracts/dist/events.js";import"./libs/contracts/dist/index.js";import{l as n}from"./libs/schema/dist/ScalarTypeEnum.js";import"./libs/schema/dist/index.js";const r=t({name:`kb.source.ingested`,version:1,description:`Source document ingested (immutable).`,payload:e({name:`KbSourceIngestedPayload`,description:`Emitted when a source document is ingested.`,fields:{sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1}}})}),i=t({name:`kb.ruleVersion.created`,version:1,description:`Rule version created (draft).`,payload:e({name:`KbRuleVersionCreatedPayload`,description:`Emitted when a rule version draft is created.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},ruleId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1}}})}),a=t({name:`kb.ruleVersion.approved`,version:1,description:`Rule version approved (human verified).`,payload:e({name:`KbRuleVersionApprovedPayload`,description:`Emitted when a rule version is approved.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}})}),o=t({name:`kb.snapshot.published`,version:1,description:`KB snapshot published.`,payload:e({name:`KbSnapshotPublishedPayload`,description:`Emitted when a KB snapshot is published.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{a as KbRuleVersionApprovedEvent,i as KbRuleVersionCreatedEvent,o as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent};

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./contracts/kb.js";
-import "./contracts/index.js";
 import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./entities/models.js";
-import "./entities/index.js";
 import { KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSnapshotPublishedEvent, KbSourceIngestedEvent } from "./events.js";
 import example from "./example.js";
 import { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore } from "./handlers/memory.handlers.js";

package/dist/libs/contracts/dist/capabilities/openbanking.js

@@ -0,0 +1 @@
+import{e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`];[...t],[...n],e.Experimental,[...t],[...n],e.Experimental,[...t],[...n],e.Experimental;

package/dist/libs/contracts/dist/client/index.js

@@ -0,0 +1 @@
+"use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";

package/dist/libs/contracts/dist/client/react/feature-render.js

@@ -0,0 +1 @@
+import"../../presentations.v2.js";import"react";

package/dist/libs/contracts/dist/client/react/form-render.js

@@ -0,0 +1 @@
+import"react";import"react-hook-form";import"@hookform/resolvers/zod";import"react/jsx-runtime";

package/dist/libs/contracts/dist/client/react/index.js

@@ -0,0 +1 @@
+"use client";import"./feature-render.js";import"./form-render.js";

package/dist/libs/contracts/dist/contract-registry/index.js

@@ -0,0 +1 @@
+import{i as e,n as t,r as n}from"./schemas.js";

package/dist/libs/contracts/dist/contract-registry/schemas.js

@@ -0,0 +1 @@
+import{e}from"../ownership.js";import t from"zod";const n=t.enum([`contractspec:operation`,`contractspec:event`,`contractspec:presentation`,`contractspec:form`,`contractspec:feature`,`contractspec:workflow`,`contractspec:template`,`contractspec:integration`,`contractspec:data-view`,`contractspec:migration`,`contractspec:telemetry`,`contractspec:experiment`,`contractspec:app-config`,`contractspec:knowledge`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()});t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});export{i,n,r};

package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -0,0 +1,76 @@
+import{a as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
+
+This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
+
+## Release Tracks
+
+| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
+|-------|--------|---------|-----------|------------|----------|
+| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
+| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
+
+## Prerequisites
+
+- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
+- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
+- ✅ For stable releases: \`release\` branch exists and is protected.
+
+## Canary Workflow (Automatic)
+
+Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
+
+1. **Trigger**: Push to \`main\`.
+2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
+3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
+
+### Consuming Canary Builds
+
+To install the latest bleeding-edge version:
+
+\`\`\`bash
+npm install @lssm/lib.contracts@canary
+# or
+bun add @lssm/lib.contracts@canary
+\`\`\`
+
+## Stable Release Workflow (Manual)
+
+Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
+
+1. **Develop on \`main\`**: Create features and fixes.
+2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
+3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
+4. **"Version Packages" PR**:
+   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
+   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
+5. **Merge & Publish**:
+   - Review and merge the "Version Packages" PR.
+   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
+
+### Publishing Steps
+
+1. Ensure all changesets are present on \`main\`.
+2. Merge \`main\` into \`release\`:
+   \`\`\`bash
+   git checkout release
+   git pull origin release
+   git merge main
+   git push origin release
+   \`\`\`
+3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
+4. Merge that PR.
+5. The release is now live on npm!
+
+## Manual Verification (Optional)
+
+Before publishing a new version you can run:
+
+\`\`\`bash
+bun run build:not-apps
+npx npm-packlist --json packages/libs/contracts
+\`\`\`
+
+## Rollback
+
+If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
+`}]);