@lssm/lib.contracts-spec 17.3.2

package/dist/node/product-intent/spec.js

@@ -0,0 +1 @@
+import{ZodSchemaType as o}from"@lssm/lib.schema";import*as t from"zod";import{StabilityEnum as e}from"../ownership.js";import{ContractPatchIntentModel as i,ContractSpecPatchModel as r,EvidenceFindingExtractionModel as c,ImpactReportModel as a,InsightExtractionModel as p,OpportunityBriefModel as s,ProblemGroupingModel as d,TaskPackModel as m,TicketCollectionModel as g}from"./types.js";const l=t.object({key:t.string().min(1),version:t.string().min(1),description:t.string().min(1),stability:t.nativeEnum(e),owners:t.array(t.string().min(1)),tags:t.array(t.string().min(1)),title:t.string().min(1).optional(),domain:t.string().min(1).optional(),docId:t.array(t.string().min(1)).optional(),goal:t.string().min(1).optional(),context:t.string().min(1).optional()}),u=t.object({id:t.string().min(1),meta:l,question:t.string().min(1),runtimeContext:t.unknown().optional(),findings:c.getZod().optional(),insights:p.getZod().optional(),problems:d.getZod().optional(),brief:s.getZod().optional(),tickets:g.getZod().optional(),patchIntent:i.getZod().optional(),patch:r.getZod().optional(),impact:a.getZod().optional(),tasks:m.getZod().optional()});export const ProductIntentSpecModel=new o(u,{name:"ProductIntentSpec"});export function defineProductIntentSpec(n){return n}

package/dist/node/product-intent/task-pack.js

@@ -0,0 +1 @@
+import{ZodSchemaType as e}from"@lssm/lib.schema";import*as a from"zod";const r=a.enum(["api","db","ui","workflows","policy","docs","tests","other"]),t=a.object({id:a.string().min(1),title:a.string().min(1),surface:a.array(r),why:a.string().min(1),acceptance:a.array(a.string().min(1)),agentPrompt:a.string().min(1),dependsOn:a.array(a.string().min(1)).optional()});export const TaskModel=new e(t,{name:"Task"});const n=a.object({packId:a.string().min(1),patchId:a.string().min(1),overview:a.string().min(1),tasks:a.array(t)});export const TaskPackModel=new e(n,{name:"TaskPack"});

package/dist/node/product-intent/tickets.js

@@ -0,0 +1 @@
+import{ZodSchemaType as t}from"@lssm/lib.schema";import*as e from"zod";const o=e.enum(["low","medium","high"]),i=e.object({ticketId:e.string().min(1),title:e.string().min(1),summary:e.string().min(1),evidenceIds:e.array(e.string().min(1)).min(1),acceptanceCriteria:e.array(e.string().min(1)).min(1),priority:o.optional(),tags:e.array(e.string().min(1)).optional()});export const TicketModel=new t(i,{name:"Ticket"});const c=e.object({tickets:e.array(i)});export const TicketCollectionModel=new t(c,{name:"TicketCollection"});

package/dist/node/product-intent/types.js

@@ -0,0 +1 @@
+export*from"./contract-patch-intent.js";export*from"./contract-spec-patch.js";export*from"./evidence.js";export*from"./findings.js";export*from"./impact-report.js";export*from"./insights.js";export*from"./opportunity-brief.js";export*from"./problems.js";export*from"./task-pack.js";export*from"./tickets.js";export*from"./ui-wireframe.js";

package/dist/node/product-intent/ui-wireframe.js

@@ -0,0 +1 @@
+import{ZodSchemaType as r}from"@lssm/lib.schema";import*as e from"zod";const i=e.enum(["mobile","desktop"]),m=e.enum(["header","text","input","button","list","card","divider","progress"]),a=e.object({screenName:e.string().min(1),device:i,currentScreenSummary:e.string().min(1),proposedChanges:e.array(e.string().min(1))});export const UiWireframeRequestModel=new r(a,{name:"UiWireframeRequest"});const t=e.object({type:m,label:e.string().min(1),notes:e.string().min(1).optional()});export const UiWireframeElementModel=new r(t,{name:"UiWireframeElement"});const n=e.object({layout:e.array(t)});export const UiWireframeLayoutModel=new r(n,{name:"UiWireframeLayout"});

package/dist/node/prompt.js

@@ -0,0 +1 @@
+export function definePrompt(t){return t}

package/dist/node/promptRegistry.js

@@ -0,0 +1 @@
+import{compareVersions as o}from"compare-versions";export class PromptRegistry{prompts=new Map;register(t){const r=`${t.meta.key}-v${t.meta.version}`;if(this.prompts.has(r))throw Error(`Duplicate prompt ${r}`);this.prompts.set(r,t);return this}list(){return[...this.prompts.values()]}get(t,r){if(r!=null)return this.prompts.get(`${t}-v${r}`);let e;for(const[s,p]of this.prompts.entries()){if(!s.startsWith(`${t}.v`))continue;if(!e||o(p.meta.version,e.meta.version)>0)e=p}return e}}

package/dist/node/provider-ranking/capabilities/index.js

@@ -0,0 +1 @@
+export*from"./providerRanking.capability.js";

package/dist/node/provider-ranking/capabilities/providerRanking.capability.js

@@ -0,0 +1 @@
+import{defineCapability as e}from"../../capabilities/index.js";import{docId as r}from"../../docs/registry.js";import{PROVIDER_RANKING_DOMAIN as i,PROVIDER_RANKING_OWNERS as n,PROVIDER_RANKING_STABILITY as o,PROVIDER_RANKING_TAGS as a}from"../constants.js";export const ProviderRankingCapability=e({meta:{key:"provider-ranking.system",version:"1.0.0",kind:"integration",title:"AI Provider Ranking",description:"Benchmark ingestion, scoring, and ranking for AI providers and models.",domain:i,owners:n,tags:[...a,"system"],stability:o,docId:[r("docs.tech.provider-ranking.system")]},provides:[{surface:"operation",key:"provider-ranking.benchmark.ingest",version:"1.0.0",description:"Trigger ingestion of external benchmark data."},{surface:"operation",key:"provider-ranking.benchmark.run-custom",version:"1.0.0",description:"Launch a custom benchmark evaluation against a model."},{surface:"operation",key:"provider-ranking.ranking.refresh",version:"1.0.0",description:"Recompute composite rankings from latest data."},{surface:"operation",key:"provider-ranking.ranking.get",version:"1.0.0",description:"Get ranked list of providers/models."},{surface:"operation",key:"provider-ranking.benchmark.results.list",version:"1.0.0",description:"List raw benchmark results."},{surface:"operation",key:"provider-ranking.model.profile.get",version:"1.0.0",description:"Get detailed model profile with scores."},{surface:"event",key:"provider-ranking.benchmark.ingested",version:"1.0.0",description:"External benchmark data ingested."},{surface:"event",key:"provider-ranking.benchmark.custom.completed",version:"1.0.0",description:"Custom benchmark run completed."},{surface:"event",key:"provider-ranking.ranking.updated",version:"1.0.0",description:"Composite rankings recomputed."},{surface:"presentation",key:"provider-ranking.model.comparison",version:"1.0.0",description:"Side-by-side model comparison view."}]});

package/dist/node/provider-ranking/commands/benchmarkIngest.command.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineCommand as r}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as i,PROVIDER_RANKING_OWNERS as a,PROVIDER_RANKING_STABILITY as s,PROVIDER_RANKING_TAGS as o}from"../constants.js";import{BenchmarkIngestedEvent as c}from"../events/benchmarkIngested.event.js";const m=new t({name:"BenchmarkIngestInput",fields:{source:{type:e.NonEmptyString(),isOptional:!1},sourceUrl:{type:e.String_unsecure(),isOptional:!0},dimensions:{type:e.String_unsecure(),isOptional:!0,isArray:!0},fromDate:{type:e.DateTime(),isOptional:!0},toDate:{type:e.DateTime(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0}}}),p=new t({name:"BenchmarkIngestOutput",fields:{ingestionId:{type:e.ID(),isOptional:!1},source:{type:e.NonEmptyString(),isOptional:!1},resultsCount:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},ingestedAt:{type:e.DateTime(),isOptional:!1}}});export const BenchmarkIngestDocBlock={id:"docs.tech.provider-ranking.benchmark.ingest",title:"Ingest benchmark data",summary:"Trigger ingestion of external benchmark data.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/ingest",tags:["ai","ranking","ingest"],body:`# provider-ranking.benchmark.ingest
+
+Imports and normalizes benchmark scores from external leaderboards.
+`},BenchmarkIngestCommand=r({meta:{key:"provider-ranking.benchmark.ingest",title:"Ingest Benchmark Data",version:"1.0.0",description:"Trigger ingestion of external benchmark data from a public source.",goal:"Import and normalize benchmark scores from external leaderboards.",context:"Used by operators and scheduled jobs to keep ranking data current.",domain:i,owners:a,tags:[...o,"ingest"],stability:s,docId:[n("docs.tech.provider-ranking.benchmark.ingest")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:m,output:p},policy:{auth:"user",pii:[]},sideEffects:{emits:[{ref:c.meta,when:"External benchmark data is successfully ingested and stored."}]}});

package/dist/node/provider-ranking/commands/benchmarkRunCustom.command.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineCommand as a}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as o,PROVIDER_RANKING_OWNERS as r,PROVIDER_RANKING_STABILITY as i,PROVIDER_RANKING_TAGS as s}from"../constants.js";import{BenchmarkCustomCompletedEvent as m}from"../events/benchmarkCustomCompleted.event.js";const u=new t({name:"BenchmarkRunCustomInput",fields:{evalSuiteKey:{type:e.NonEmptyString(),isOptional:!1},modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},parameters:{type:e.JSONObject(),isOptional:!0},maxConcurrency:{type:e.Int_unsecure(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0}}}),c=new t({name:"BenchmarkRunCustomOutput",fields:{runId:{type:e.ID(),isOptional:!1},evalSuiteKey:{type:e.NonEmptyString(),isOptional:!1},modelId:{type:e.NonEmptyString(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},startedAt:{type:e.DateTime(),isOptional:!1}}});export const BenchmarkRunCustomDocBlock={id:"docs.tech.provider-ranking.benchmark.run-custom",title:"Run custom benchmark",summary:"Launch a custom benchmark evaluation against a model.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/run-custom",tags:["ai","ranking","custom","eval"],body:`# provider-ranking.benchmark.run-custom
+
+Evaluates model performance using internal eval suites with configurable parameters.
+`},BenchmarkRunCustomCommand=a({meta:{key:"provider-ranking.benchmark.run-custom",title:"Run Custom Benchmark",version:"1.0.0",description:"Launch a custom benchmark evaluation against a specific model.",goal:"Evaluate model performance using internal eval suites.",context:"Used by operators to run proprietary benchmarks and compare models.",domain:o,owners:r,tags:[...s,"custom","eval"],stability:i,docId:[n("docs.tech.provider-ranking.benchmark.run-custom")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:u,output:c},policy:{auth:"user",pii:[]},sideEffects:{emits:[{ref:m.meta,when:"Custom benchmark evaluation finishes execution."}]}});

package/dist/node/provider-ranking/commands/index.js

@@ -0,0 +1 @@
+export*from"./benchmarkIngest.command.js";export*from"./benchmarkRunCustom.command.js";export*from"./rankingRefresh.command.js";

package/dist/node/provider-ranking/commands/rankingRefresh.command.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as r}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineCommand as t}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as i,PROVIDER_RANKING_OWNERS as s,PROVIDER_RANKING_STABILITY as a,PROVIDER_RANKING_TAGS as o}from"../constants.js";import{RankingUpdatedEvent as p}from"../events/rankingUpdated.event.js";const c=new r({name:"RankingRefreshInput",fields:{dimensions:{type:e.String_unsecure(),isOptional:!0,isArray:!0},weightOverrides:{type:e.JSONObject(),isOptional:!0},forceRecalculate:{type:e.Boolean(),isOptional:!0}}}),d=new r({name:"RankingRefreshOutput",fields:{modelsRanked:{type:e.Int_unsecure(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1}}});export const RankingRefreshDocBlock={id:"docs.tech.provider-ranking.ranking.refresh",title:"Refresh rankings",summary:"Recompute composite rankings from latest benchmark data.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/ranking/refresh",tags:["ai","ranking","refresh"],body:`# provider-ranking.ranking.refresh
+
+Recomputes weighted composite scores across all dimensions and updates the leaderboard.
+`},RankingRefreshCommand=t({meta:{key:"provider-ranking.ranking.refresh",title:"Refresh Rankings",version:"1.0.0",description:"Recompute composite rankings from latest benchmark data.",goal:"Keep the leaderboard current after new benchmark data arrives.",context:"Triggered after ingestion or on a schedule to update model rankings.",domain:i,owners:s,tags:[...o,"refresh"],stability:a,docId:[n("docs.tech.provider-ranking.ranking.refresh")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:c,output:d},policy:{auth:"user",pii:[]},sideEffects:{emits:[{ref:p.meta,when:"Composite rankings are successfully recomputed."}]}});

package/dist/node/provider-ranking/constants.js

@@ -0,0 +1 @@
+import{StabilityEnum as t,TagsEnum as o}from"../ownership.js";export const PROVIDER_RANKING_DOMAIN="provider-ranking",PROVIDER_RANKING_OWNERS=["platform.ai"],PROVIDER_RANKING_TAGS=[o.Automation,"ai","ranking","benchmark"],PROVIDER_RANKING_STABILITY=t.Experimental;

package/dist/node/provider-ranking/contracts.js

@@ -0,0 +1 @@
+import{ProviderRankingCapability as e}from"./capabilities/index.js";import{BenchmarkIngestCommand as t,BenchmarkRunCustomCommand as i,RankingRefreshCommand as n}from"./commands/index.js";import{BenchmarkCustomCompletedEvent as o,BenchmarkIngestedEvent as s,RankingUpdatedEvent as a}from"./events/index.js";import{BenchmarkIngestForm as g,BenchmarkRunCustomForm as p}from"./forms/index.js";import{ModelComparisonPresentation as m}from"./presentations/index.js";import{BenchmarkResultsListQuery as R,ModelProfileGetQuery as c,ProviderRankingGetQuery as y}from"./queries/index.js";import{BenchmarkResultsDataView as d,ProviderRankingsDataView as k}from"./views/index.js";export const providerRankingOperationContracts={BenchmarkIngestCommand:t,BenchmarkRunCustomCommand:i,RankingRefreshCommand:n,ProviderRankingGetQuery:y,BenchmarkResultsListQuery:R,ModelProfileGetQuery:c},providerRankingEventContracts={BenchmarkIngestedEvent:s,BenchmarkCustomCompletedEvent:o,RankingUpdatedEvent:a},providerRankingCapabilityContracts={ProviderRankingCapability:e},providerRankingDataViewContracts={ProviderRankingsDataView:k,BenchmarkResultsDataView:d},providerRankingFormContracts={BenchmarkIngestForm:g,BenchmarkRunCustomForm:p},providerRankingPresentationContracts={ModelComparisonPresentation:m};export function registerProviderRankingOperations(r){return r.register(t).register(i).register(n).register(y).register(R).register(c)}export function registerProviderRankingEvents(r){return r.register(s).register(o).register(a)}export function registerProviderRankingCapabilities(r){return r.register(e)}export function registerProviderRankingDataViews(r){return r.register(k).register(d)}export function registerProviderRankingForms(r){return r.register(g).register(p)}export function registerProviderRankingPresentations(r){return r.register(m)}

package/dist/node/provider-ranking/events/benchmarkCustomCompleted.event.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as o}from"../../docs/registry.js";import{defineEvent as n}from"../../events.js";import{PROVIDER_RANKING_DOMAIN as i,PROVIDER_RANKING_OWNERS as r,PROVIDER_RANKING_STABILITY as m,PROVIDER_RANKING_TAGS as s}from"../constants.js";export const BenchmarkCustomCompletedPayload=new t({name:"BenchmarkCustomCompletedPayload",fields:{runId:{type:e.ID(),isOptional:!1},evalSuiteKey:{type:e.NonEmptyString(),isOptional:!1},modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},resultsCount:{type:e.Int_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},completedAt:{type:e.DateTime(),isOptional:!1}}}),BenchmarkCustomCompletedDocBlock={id:"docs.tech.provider-ranking.benchmark.custom.completed",title:"Custom benchmark completed event",summary:"Emitted when a custom benchmark run finishes.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/custom/completed",tags:["ai","ranking","event","custom"],body:`# provider-ranking.benchmark.custom.completed
+
+Emitted when a custom evaluation run completes execution.
+`},BenchmarkCustomCompletedEvent=n({meta:{key:"provider-ranking.benchmark.custom.completed",version:"1.0.0",description:"Emitted when a custom benchmark run finishes.",domain:i,owners:r,tags:[...s,"custom","eval"],stability:m,docId:[o("docs.tech.provider-ranking.benchmark.custom.completed")]},capability:{key:"provider-ranking.system",version:"1.0.0"},pii:[],payload:BenchmarkCustomCompletedPayload});

package/dist/node/provider-ranking/events/benchmarkIngested.event.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineEvent as i}from"../../events.js";import{PROVIDER_RANKING_DOMAIN as r,PROVIDER_RANKING_OWNERS as a,PROVIDER_RANKING_STABILITY as s,PROVIDER_RANKING_TAGS as o}from"../constants.js";export const BenchmarkIngestedPayload=new t({name:"BenchmarkIngestedPayload",fields:{ingestionId:{type:e.ID(),isOptional:!1},source:{type:e.NonEmptyString(),isOptional:!1},resultsCount:{type:e.Int_unsecure(),isOptional:!1},ingestedAt:{type:e.DateTime(),isOptional:!1}}}),BenchmarkIngestedDocBlock={id:"docs.tech.provider-ranking.benchmark.ingested",title:"Benchmark ingested event",summary:"Emitted after external benchmark data is ingested.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/ingested",tags:["ai","ranking","event"],body:`# provider-ranking.benchmark.ingested
+
+Emitted when external benchmark data is successfully imported and stored.
+`},BenchmarkIngestedEvent=i({meta:{key:"provider-ranking.benchmark.ingested",version:"1.0.0",description:"Emitted after external benchmark data is ingested.",domain:r,owners:a,tags:[...o,"ingest"],stability:s,docId:[n("docs.tech.provider-ranking.benchmark.ingested")]},capability:{key:"provider-ranking.system",version:"1.0.0"},pii:[],payload:BenchmarkIngestedPayload});

package/dist/node/provider-ranking/events/index.js

@@ -0,0 +1 @@
+export*from"./benchmarkCustomCompleted.event.js";export*from"./benchmarkIngested.event.js";export*from"./rankingUpdated.event.js";

package/dist/node/provider-ranking/events/rankingUpdated.event.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as i}from"@lssm/lib.schema";import{docId as t}from"../../docs/registry.js";import{defineEvent as n}from"../../events.js";import{PROVIDER_RANKING_DOMAIN as o,PROVIDER_RANKING_OWNERS as r,PROVIDER_RANKING_STABILITY as a,PROVIDER_RANKING_TAGS as d}from"../constants.js";export const RankingUpdatedPayload=new i({name:"RankingUpdatedPayload",fields:{modelsRanked:{type:e.Int_unsecure(),isOptional:!1},topModelId:{type:e.NonEmptyString(),isOptional:!0},updatedAt:{type:e.DateTime(),isOptional:!1}}}),RankingUpdatedDocBlock={id:"docs.tech.provider-ranking.ranking.updated",title:"Ranking updated event",summary:"Emitted when composite rankings are recomputed.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/ranking/updated",tags:["ai","ranking","event"],body:`# provider-ranking.ranking.updated
+
+Emitted when the leaderboard is refreshed with new composite scores.
+`},RankingUpdatedEvent=n({meta:{key:"provider-ranking.ranking.updated",version:"1.0.0",description:"Emitted when composite rankings are recomputed.",domain:o,owners:r,tags:[...d,"refresh"],stability:a,docId:[t("docs.tech.provider-ranking.ranking.updated")]},capability:{key:"provider-ranking.system",version:"1.0.0"},pii:[],payload:RankingUpdatedPayload});

package/dist/node/provider-ranking/forms/benchmarkIngest.form.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as r}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineFormSpec as t}from"../../forms/forms.js";import{PROVIDER_RANKING_DOMAIN as o,PROVIDER_RANKING_OWNERS as i,PROVIDER_RANKING_STABILITY as a,PROVIDER_RANKING_TAGS as s}from"../constants.js";const m=new r({name:"BenchmarkIngestFormModel",fields:{source:{type:e.NonEmptyString(),isOptional:!1},sourceUrl:{type:e.String_unsecure(),isOptional:!0},fromDate:{type:e.DateTime(),isOptional:!0},toDate:{type:e.DateTime(),isOptional:!0}}});export const BenchmarkIngestFormDocBlock={id:"docs.tech.provider-ranking.benchmark.ingest.form",title:"Benchmark ingest form",summary:"Form specification for triggering benchmark ingestion.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/ingest/form",tags:["ai","ranking","form"],body:`# provider-ranking.benchmark.ingest.form
+
+Form surface used by Studio to trigger benchmark data ingestion.
+`},BenchmarkIngestForm=t({meta:{key:"provider-ranking.benchmark.ingest.form",title:"Ingest Benchmark Data",version:"1.0.0",description:"Form to trigger benchmark data ingestion from external sources.",domain:o,owners:i,tags:[...s,"ingest"],stability:a,docId:[n("docs.tech.provider-ranking.benchmark.ingest.form")]},model:m,fields:[{kind:"text",name:"source",labelI18n:"Source",placeholderI18n:"chatbot-arena, swe-bench, artificial-analysis...",required:!0},{kind:"text",name:"sourceUrl",labelI18n:"Source URL",placeholderI18n:"https://..."},{kind:"text",name:"fromDate",labelI18n:"From Date",placeholderI18n:"YYYY-MM-DD"},{kind:"text",name:"toDate",labelI18n:"To Date",placeholderI18n:"YYYY-MM-DD"}],actions:[{key:"ingest",labelI18n:"Start ingestion",op:{name:"provider-ranking.benchmark.ingest",version:"1.0.0"}}],policy:{flags:[],pii:[]}});

package/dist/node/provider-ranking/forms/benchmarkRunCustom.form.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as r}from"@lssm/lib.schema";import{docId as o}from"../../docs/registry.js";import{defineFormSpec as n}from"../../forms/forms.js";import{PROVIDER_RANKING_DOMAIN as t,PROVIDER_RANKING_OWNERS as a,PROVIDER_RANKING_STABILITY as i,PROVIDER_RANKING_TAGS as m}from"../constants.js";const c=new r({name:"BenchmarkRunCustomFormModel",fields:{evalSuiteKey:{type:e.NonEmptyString(),isOptional:!1},modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},maxConcurrency:{type:e.Int_unsecure(),isOptional:!0}}});export const BenchmarkRunCustomFormDocBlock={id:"docs.tech.provider-ranking.benchmark.run-custom.form",title:"Custom benchmark form",summary:"Form specification for launching custom benchmarks.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/run-custom/form",tags:["ai","ranking","form"],body:`# provider-ranking.benchmark.run-custom.form
+
+Form surface used by Studio to launch custom benchmark evaluations.
+`},BenchmarkRunCustomForm=n({meta:{key:"provider-ranking.benchmark.run-custom.form",title:"Run Custom Benchmark",version:"1.0.0",description:"Form to launch a custom benchmark evaluation against a model.",domain:t,owners:a,tags:[...m,"custom","eval"],stability:i,docId:[o("docs.tech.provider-ranking.benchmark.run-custom.form")]},model:c,fields:[{kind:"text",name:"evalSuiteKey",labelI18n:"Eval Suite",placeholderI18n:"coding, reasoning, agentic...",required:!0},{kind:"text",name:"modelId",labelI18n:"Model",placeholderI18n:"claude-sonnet-4-6",required:!0},{kind:"text",name:"providerKey",labelI18n:"Provider",placeholderI18n:"anthropic, openai, mistral...",required:!0},{kind:"text",name:"maxConcurrency",labelI18n:"Max Concurrency",placeholderI18n:"5"}],actions:[{key:"run",labelI18n:"Run benchmark",op:{name:"provider-ranking.benchmark.run-custom",version:"1.0.0"}}],policy:{flags:[],pii:[]}});

package/dist/node/provider-ranking/forms/index.js

@@ -0,0 +1 @@
+export*from"./benchmarkIngest.form.js";export*from"./benchmarkRunCustom.form.js";

package/dist/node/provider-ranking/index.js

@@ -0,0 +1 @@
+export*from"./capabilities/index.js";export*from"./commands/index.js";export*from"./constants.js";export*from"./contracts.js";export*from"./events/index.js";export*from"./forms/index.js";export*from"./presentations/index.js";export*from"./provider-ranking.feature.js";export*from"./queries/index.js";export*from"./views/index.js";

package/dist/node/provider-ranking/presentations/index.js

@@ -0,0 +1 @@
+export*from"./modelComparison.presentation.js";

package/dist/node/provider-ranking/presentations/modelComparison.presentation.js

@@ -0,0 +1,4 @@
+import{docId as o}from"../../docs/registry.js";import{definePresentation as e}from"../../presentations/index.js";import{PROVIDER_RANKING_DOMAIN as r,PROVIDER_RANKING_OWNERS as i,PROVIDER_RANKING_STABILITY as n,PROVIDER_RANKING_TAGS as s}from"../constants.js";export const ModelComparisonDocBlock={id:"docs.tech.provider-ranking.model.comparison",title:"Model comparison presentation",summary:"Presentation spec for side-by-side model comparison.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/model/comparison",tags:["ai","ranking","presentation","comparison"],body:`# provider-ranking.model.comparison
+
+Presentation surface for comparing two or more models across all ranking dimensions.
+`},ModelComparisonPresentation=e({meta:{key:"provider-ranking.model.comparison",title:"Model Comparison",version:"1.0.0",description:"Side-by-side comparison of AI model scores and capabilities.",goal:"Enable informed model selection through visual comparison.",context:"Used by Studio to compare two or more models across dimensions.",domain:r,owners:i,tags:[...s,"comparison"],stability:n,docId:[o("docs.tech.provider-ranking.model.comparison")]},capability:{key:"provider-ranking.system",version:"1.0.0"},source:{type:"component",framework:"react",componentKey:"modelComparison"},targets:["react","markdown"]});

package/dist/node/provider-ranking/provider-ranking.feature.js

@@ -0,0 +1,4 @@
+import{defineFeature as r}from"../features/index.js";import{PROVIDER_RANKING_DOMAIN as e,PROVIDER_RANKING_OWNERS as n,PROVIDER_RANKING_STABILITY as i,PROVIDER_RANKING_TAGS as o}from"./constants.js";export const ProviderRankingSystemDocBlock={id:"docs.tech.provider-ranking.system",title:"AI Provider Ranking",summary:"Benchmark ingestion, scoring, and ranking for AI providers and models.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/system",tags:["ai","ranking","benchmark"],body:`# AI Provider Ranking
+
+Defines the core operations, events, and UI surfaces for ingesting benchmark data, computing composite rankings, and comparing AI models across dimensions.
+`},ProviderRankingFeature=r({meta:{key:"platform.provider-ranking",version:"1.0.0",title:"Provider Ranking",description:"Benchmark ingestion, custom benchmark runs, and AI model ranking with leaderboards",domain:e,owners:n,tags:[...o],stability:i},operations:[{key:"provider-ranking.benchmark.ingest",version:"1.0.0"},{key:"provider-ranking.benchmark.run-custom",version:"1.0.0"},{key:"provider-ranking.ranking.refresh",version:"1.0.0"},{key:"provider-ranking.ranking.get",version:"1.0.0"},{key:"provider-ranking.benchmark.results.list",version:"1.0.0"},{key:"provider-ranking.model.profile.get",version:"1.0.0"}],events:[{key:"provider-ranking.benchmark.ingested",version:"1.0.0"},{key:"provider-ranking.benchmark.custom.completed",version:"1.0.0"},{key:"provider-ranking.ranking.updated",version:"1.0.0"}],presentations:[{key:"provider-ranking.model.comparison",version:"1.0.0"}],capabilities:{provides:[{key:"provider-ranking.system",version:"1.0.0"}]},dataViews:[{key:"provider-ranking.ranking.index",version:"1.0.0"},{key:"provider-ranking.benchmark.results.index",version:"1.0.0"}],forms:[{key:"provider-ranking.benchmark.ingest.form",version:"1.0.0"},{key:"provider-ranking.benchmark.run-custom.form",version:"1.0.0"}]});

package/dist/node/provider-ranking/queries/benchmarkResultsList.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as i}from"../../docs/registry.js";import{defineQuery as s}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as r,PROVIDER_RANKING_OWNERS as n,PROVIDER_RANKING_STABILITY as a,PROVIDER_RANKING_TAGS as o}from"../constants.js";const l=new t({name:"BenchmarkResultsListInput",fields:{source:{type:e.String_unsecure(),isOptional:!0},modelId:{type:e.String_unsecure(),isOptional:!0},dimension:{type:e.String_unsecure(),isOptional:!0},providerKey:{type:e.String_unsecure(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),u=new t({name:"BenchmarkResultSummary",fields:{id:{type:e.ID(),isOptional:!1},modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},source:{type:e.NonEmptyString(),isOptional:!1},dimension:{type:e.NonEmptyString(),isOptional:!1},score:{type:e.Float_unsecure(),isOptional:!1},measuredAt:{type:e.DateTime(),isOptional:!1},ingestedAt:{type:e.DateTime(),isOptional:!1}}}),p=new t({name:"BenchmarkResultsListOutput",fields:{results:{type:u,isOptional:!1,isArray:!0},total:{type:e.Int_unsecure(),isOptional:!0},nextOffset:{type:e.Int_unsecure(),isOptional:!0}}});export const BenchmarkResultsListDocBlock={id:"docs.tech.provider-ranking.benchmark.results.list",title:"List benchmark results",summary:"List raw benchmark results.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/results/list",tags:["ai","ranking","results"],body:`# provider-ranking.benchmark.results.list
+
+Returns individual benchmark data points filterable by source, model, and dimension.
+`},BenchmarkResultsListQuery=s({meta:{key:"provider-ranking.benchmark.results.list",title:"List Benchmark Results",version:"1.0.0",description:"List raw benchmark results with pagination, filterable by source, model, and dimension.",goal:"Provide granular access to individual benchmark data points.",context:"Used by Studio to drill into specific benchmark results.",domain:r,owners:n,tags:[...o,"results"],stability:a,docId:[i("docs.tech.provider-ranking.benchmark.results.list")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:l,output:p},policy:{auth:"user",pii:[]}});

package/dist/node/provider-ranking/queries/index.js

@@ -0,0 +1 @@
+export*from"./benchmarkResultsList.query.js";export*from"./modelProfileGet.query.js";export*from"./providerRankingGet.query.js";

package/dist/node/provider-ranking/queries/modelProfileGet.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as o}from"@lssm/lib.schema";import{docId as i}from"../../docs/registry.js";import{defineQuery as t}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as r,PROVIDER_RANKING_OWNERS as l,PROVIDER_RANKING_STABILITY as n,PROVIDER_RANKING_TAGS as s}from"../constants.js";const a=new o({name:"ModelProfileGetInput",fields:{modelId:{type:e.NonEmptyString(),isOptional:!1}}}),p=new o({name:"ModelProfileOutput",fields:{modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!1},contextWindow:{type:e.Int_unsecure(),isOptional:!1},costPerMillionInput:{type:e.Float_unsecure(),isOptional:!0},costPerMillionOutput:{type:e.Float_unsecure(),isOptional:!0},capabilities:{type:e.String_unsecure(),isOptional:!1,isArray:!0},compositeScore:{type:e.Float_unsecure(),isOptional:!0},rank:{type:e.Int_unsecure(),isOptional:!0},dimensionScores:{type:e.JSONObject(),isOptional:!0},benchmarkResultsCount:{type:e.Int_unsecure(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!0}}});export const ModelProfileGetDocBlock={id:"docs.tech.provider-ranking.model.profile.get",title:"Get model profile",summary:"Get detailed profile for a single model.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/model/profile/get",tags:["ai","ranking","model","profile"],body:`# provider-ranking.model.profile.get
+
+Returns comprehensive model information including scores, metadata, cost, context window, and capabilities.
+`},ModelProfileGetQuery=t({meta:{key:"provider-ranking.model.profile.get",title:"Get Model Profile",version:"1.0.0",description:"Get detailed profile for a single model including all scores, metadata, cost, and capabilities.",goal:"Provide a comprehensive view of a single model for comparison.",context:"Used by Studio model detail pages and comparison views.",domain:r,owners:l,tags:[...s,"model","profile"],stability:n,docId:[i("docs.tech.provider-ranking.model.profile.get")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:a,output:p},policy:{auth:"user",pii:[]}});

package/dist/node/provider-ranking/queries/providerRankingGet.query.js

@@ -0,0 +1,4 @@
+import{ScalarTypeEnum as e,SchemaModel as i}from"@lssm/lib.schema";import{docId as t}from"../../docs/registry.js";import{defineQuery as n}from"../../operations/index.js";import{PROVIDER_RANKING_DOMAIN as r,PROVIDER_RANKING_OWNERS as o,PROVIDER_RANKING_STABILITY as s,PROVIDER_RANKING_TAGS as a}from"../constants.js";const p=new i({name:"ProviderRankingGetInput",fields:{dimension:{type:e.String_unsecure(),isOptional:!0},providerKey:{type:e.String_unsecure(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),g=new i({name:"DimensionScoreModel",fields:{score:{type:e.Float_unsecure(),isOptional:!1},confidence:{type:e.Float_unsecure(),isOptional:!1},sources:{type:e.String_unsecure(),isOptional:!1,isArray:!0}}}),d=new i({name:"RankedModelSummary",fields:{modelId:{type:e.NonEmptyString(),isOptional:!1},providerKey:{type:e.NonEmptyString(),isOptional:!1},compositeScore:{type:e.Float_unsecure(),isOptional:!1},rank:{type:e.Int_unsecure(),isOptional:!1},previousRank:{type:e.Int_unsecure(),isOptional:!0},dimensionScores:{type:e.JSONObject(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),l=new i({name:"ProviderRankingGetOutput",fields:{rankings:{type:d,isOptional:!1,isArray:!0},total:{type:e.Int_unsecure(),isOptional:!0},nextOffset:{type:e.Int_unsecure(),isOptional:!0}}});export const ProviderRankingGetDocBlock={id:"docs.tech.provider-ranking.ranking.get",title:"Get provider rankings",summary:"Get ranked list of providers and models.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/ranking/get",tags:["ai","ranking","leaderboard"],body:`# provider-ranking.ranking.get
+
+Returns a paginated, filterable leaderboard of AI models ranked by composite or per-dimension scores.
+`},ProviderRankingGetQuery=n({meta:{key:"provider-ranking.ranking.get",title:"Get Provider Rankings",version:"1.0.0",description:"Get ranked list of providers/models with composite scores, filterable by dimension.",goal:"Provide a leaderboard view of AI model performance.",context:"Used by Studio and API clients to compare model rankings.",domain:r,owners:o,tags:[...a,"leaderboard"],stability:s,docId:[t("docs.tech.provider-ranking.ranking.get")]},capability:{key:"provider-ranking.system",version:"1.0.0"},io:{input:p,output:l},policy:{auth:"user",pii:[]}});

package/dist/node/provider-ranking/views/benchmarkResults.dataView.js

@@ -0,0 +1,4 @@
+import{defineDataView as a}from"../../data-views/index.js";import{docId as r}from"../../docs/registry.js";import{defineTranslation as d}from"../../translations/index.js";import{PROVIDER_RANKING_DOMAIN as e,PROVIDER_RANKING_OWNERS as l,PROVIDER_RANKING_STABILITY as s,PROVIDER_RANKING_TAGS as o}from"../constants.js";import{BenchmarkResultsListQuery as i}from"../queries/benchmarkResultsList.query.js";const t=d({meta:{key:"provider-ranking.benchmark.results.index.i18n",version:"1.0.0",domain:e,owners:l},locale:"en",messages:{"field.id.label":{value:"ID"},"field.modelId.label":{value:"Model"},"field.providerKey.label":{value:"Provider"},"field.source.label":{value:"Source"},"field.dimension.label":{value:"Dimension"},"field.score.label":{value:"Score"},"field.measuredAt.label":{value:"Measured"},"field.ingestedAt.label":{value:"Ingested"},"filter.source.label":{value:"Source"},"filter.modelId.label":{value:"Model"},"filter.dimension.label":{value:"Dimension"},"filter.providerKey.label":{value:"Provider"}}});export const BenchmarkResultsDataViewDocBlock={id:"docs.tech.provider-ranking.benchmark.results.index",title:"Benchmark results view",summary:"Data view for raw benchmark results.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/benchmark/results/index",tags:["ai","ranking","data-view"],body:`# provider-ranking.benchmark.results.index
+
+List view over individual benchmark data points from all sources.
+`},BenchmarkResultsDataView=a(t,{meta:{key:"provider-ranking.benchmark.results.index",title:"Benchmark Results",version:"1.0.0",description:"Raw benchmark results from external and custom sources.",domain:e,owners:l,tags:[...o,"results","index"],stability:s,entity:"benchmark_result",docId:[r("docs.tech.provider-ranking.benchmark.results.index")]},source:{primary:{key:i.meta.key,version:i.meta.version}},view:{kind:"list",fields:[{key:"id",label:"field.id.label",dataPath:"id"},{key:"modelId",label:"field.modelId.label",dataPath:"modelId"},{key:"providerKey",label:"field.providerKey.label",dataPath:"providerKey"},{key:"source",label:"field.source.label",dataPath:"source"},{key:"dimension",label:"field.dimension.label",dataPath:"dimension"},{key:"score",label:"field.score.label",dataPath:"score"},{key:"measuredAt",label:"field.measuredAt.label",dataPath:"measuredAt"},{key:"ingestedAt",label:"field.ingestedAt.label",dataPath:"ingestedAt"}],primaryField:"id",secondaryFields:["modelId","source","score"],filters:[{key:"source",label:"filter.source.label",field:"source",type:"search"},{key:"modelId",label:"filter.modelId.label",field:"modelId",type:"search"},{key:"dimension",label:"filter.dimension.label",field:"dimension",type:"search"},{key:"providerKey",label:"filter.providerKey.label",field:"providerKey",type:"search"}]},policy:{flags:[],pii:[]}});

package/dist/node/provider-ranking/views/index.js

@@ -0,0 +1 @@
+export*from"./benchmarkResults.dataView.js";export*from"./providerRankings.dataView.js";

package/dist/node/provider-ranking/views/providerRankings.dataView.js

@@ -0,0 +1,4 @@
+import{defineDataView as r}from"../../data-views/index.js";import{docId as o}from"../../docs/registry.js";import{defineTranslation as d}from"../../translations/index.js";import{PROVIDER_RANKING_DOMAIN as e,PROVIDER_RANKING_OWNERS as i,PROVIDER_RANKING_STABILITY as l,PROVIDER_RANKING_TAGS as n}from"../constants.js";import{ProviderRankingGetQuery as a}from"../queries/providerRankingGet.query.js";const t=d({meta:{key:"provider-ranking.ranking.index.i18n",version:"1.0.0",domain:e,owners:i},locale:"en",messages:{"field.rank.label":{value:"Rank"},"field.modelId.label":{value:"Model"},"field.providerKey.label":{value:"Provider"},"field.compositeScore.label":{value:"Score"},"field.previousRank.label":{value:"Prev. Rank"},"field.updatedAt.label":{value:"Updated"},"filter.dimension.label":{value:"Dimension"},"filter.providerKey.label":{value:"Provider"}}});export const ProviderRankingsDataViewDocBlock={id:"docs.tech.provider-ranking.ranking.index",title:"Provider rankings view",summary:"Data view for the model leaderboard.",kind:"reference",visibility:"public",route:"/docs/tech/provider-ranking/ranking/index",tags:["ai","ranking","data-view"],body:`# provider-ranking.ranking.index
+
+List view over ranked models with composite and per-dimension scores.
+`},ProviderRankingsDataView=r(t,{meta:{key:"provider-ranking.ranking.index",title:"Provider Rankings",version:"1.0.0",description:"Ranked leaderboard of AI models with composite and per-dimension scores.",domain:e,owners:i,tags:[...n,"leaderboard","index"],stability:l,entity:"model_ranking",docId:[o("docs.tech.provider-ranking.ranking.index")]},source:{primary:{key:a.meta.key,version:a.meta.version}},view:{kind:"list",fields:[{key:"rank",label:"field.rank.label",dataPath:"rank"},{key:"modelId",label:"field.modelId.label",dataPath:"modelId"},{key:"providerKey",label:"field.providerKey.label",dataPath:"providerKey"},{key:"compositeScore",label:"field.compositeScore.label",dataPath:"compositeScore"},{key:"previousRank",label:"field.previousRank.label",dataPath:"previousRank"},{key:"updatedAt",label:"field.updatedAt.label",dataPath:"updatedAt"}],primaryField:"rank",secondaryFields:["modelId","providerKey","compositeScore"],filters:[{key:"dimension",label:"filter.dimension.label",field:"dimension",type:"search"},{key:"providerKey",label:"filter.providerKey.label",field:"providerKey",type:"search"}]},policy:{flags:[],pii:[]}});

package/dist/node/pwa/capabilities/index.js

@@ -0,0 +1 @@
+export*from"./pwaUpdateManagement.capability.js";

package/dist/node/pwa/capabilities/pwaUpdateManagement.capability.js

@@ -0,0 +1 @@
+import{defineCapability as e}from"../../capabilities/index.js";import{PWA_DOMAIN as t,PWA_OWNERS as a,PWA_STABILITY as p,PWA_TAGS as d}from"../constants.js";export const PwaUpdateManagementCapability=e({meta:{key:"pwa.update-management",version:"1.0.0",kind:"api",title:"PWA Update Management",description:"Frontend update checks and update prompt telemetry for PWA runtimes.",domain:t,owners:a,tags:[...d,"capability"],stability:p},provides:[{surface:"operation",key:"pwa.update.check",version:"1.0.0",description:"Check whether a PWA frontend should update."},{surface:"event",key:"pwa.update.prompted",version:"1.0.0",description:"Frontend update prompt displayed."},{surface:"event",key:"pwa.update.applied",version:"1.0.0",description:"Frontend update applied."},{surface:"event",key:"pwa.update.deferred",version:"1.0.0",description:"Optional frontend update deferred."}]});

package/dist/node/pwa/constants.js

@@ -0,0 +1 @@
+import{OwnersEnum as t,StabilityEnum as o}from"../ownership.js";export const PWA_DOMAIN="pwa",PWA_OWNERS=[t.PlatformCore],PWA_TAGS=["pwa","frontend-update","release"],PWA_STABILITY=o.Beta;

package/dist/node/pwa/contracts.js

@@ -0,0 +1 @@
+import{PwaUpdateManagementCapability as e}from"./capabilities/index.js";import{PwaUpdateAppliedEvent as r,PwaUpdateDeferredEvent as i,PwaUpdatePromptedEvent as p}from"./events/index.js";import{PwaUpdateCheckQuery as a}from"./queries/index.js";export const pwaOperationContracts={PwaUpdateCheckQuery:a},pwaEventContracts={PwaUpdatePromptedEvent:p,PwaUpdateAppliedEvent:r,PwaUpdateDeferredEvent:i},pwaCapabilityContracts={PwaUpdateManagementCapability:e};export function registerPwaOperations(t){return t.register(a)}export function registerPwaEvents(t){return t.register(p).register(r).register(i)}export function registerPwaCapabilities(t){return t.register(e)}

package/dist/node/pwa/events/index.js

@@ -0,0 +1 @@
+export*from"./pwaUpdateApplied.event.js";export*from"./pwaUpdateDeferred.event.js";export*from"./pwaUpdatePrompted.event.js";

package/dist/node/pwa/events/pwaUpdateApplied.event.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as a}from"@lssm/lib.schema";import{docId as t}from"../../docs/registry.js";import{defineEvent as p}from"../../events.js";import{PWA_DOMAIN as o,PWA_OWNERS as i,PWA_STABILITY as n,PWA_TAGS as d}from"../constants.js";export const PwaUpdateEventPayload=new a({name:"PwaUpdateEventPayload",fields:{appId:{type:e.ID(),isOptional:!1},fromVersion:{type:e.String_unsecure(),isOptional:!1},toVersion:{type:e.String_unsecure(),isOptional:!1},blocking:{type:e.Boolean(),isOptional:!0},occurredAt:{type:e.DateTime(),isOptional:!1}}}),PwaUpdateAppliedEvent=p({meta:{key:"pwa.update.applied",version:"1.0.0",description:"Emitted when a frontend PWA update is applied.",domain:o,owners:i,tags:[...d,"applied"],stability:n,docId:[t("docs.tech.contracts.pwa-updates")]},capability:{key:"pwa.update-management",version:"1.0.0"},payload:PwaUpdateEventPayload});

package/dist/node/pwa/events/pwaUpdateDeferred.event.js

@@ -0,0 +1 @@
+import{docId as e}from"../../docs/registry.js";import{defineEvent as t}from"../../events.js";import{PWA_DOMAIN as a,PWA_OWNERS as d,PWA_STABILITY as o,PWA_TAGS as r}from"../constants.js";import{PwaUpdateEventPayload as n}from"./pwaUpdateApplied.event.js";export const PwaUpdateDeferredEvent=t({meta:{key:"pwa.update.deferred",version:"1.0.0",description:"Emitted when a user defers an optional frontend PWA update.",domain:a,owners:d,tags:[...r,"deferred"],stability:o,docId:[e("docs.tech.contracts.pwa-updates")]},capability:{key:"pwa.update-management",version:"1.0.0"},payload:n});

package/dist/node/pwa/events/pwaUpdatePrompted.event.js

@@ -0,0 +1 @@
+import{docId as t}from"../../docs/registry.js";import{defineEvent as e}from"../../events.js";import{PWA_DOMAIN as o,PWA_OWNERS as a,PWA_STABILITY as p,PWA_TAGS as d}from"../constants.js";import{PwaUpdateEventPayload as r}from"./pwaUpdateApplied.event.js";export const PwaUpdatePromptedEvent=e({meta:{key:"pwa.update.prompted",version:"1.0.0",description:"Emitted when a frontend prompts the user to update.",domain:o,owners:a,tags:[...d,"prompt"],stability:p,docId:[t("docs.tech.contracts.pwa-updates")]},capability:{key:"pwa.update-management",version:"1.0.0"},payload:r});

package/dist/node/pwa/index.js

@@ -0,0 +1 @@
+export*from"./capabilities/index.js";export*from"./constants.js";export*from"./contracts.js";export*from"./events/index.js";export*from"./pwa.feature.js";export*from"./queries/index.js";export*from"./registry.js";export*from"./types.js";

package/dist/node/pwa/pwa.feature.js

@@ -0,0 +1 @@
+import{defineFeature as e}from"../features/index.js";import{PWA_DOMAIN as t,PWA_OWNERS as a,PWA_STABILITY as p,PWA_TAGS as o}from"./constants.js";export const PwaUpdateManagementFeature=e({meta:{key:"pwa.update-management",version:"1.0.0",title:"PWA Update Management",description:"Contracts for frontend update checks, blocking update policy, and update prompt telemetry.",domain:t,owners:a,tags:o,stability:p},operations:[{key:"pwa.update.check",version:"1.0.0"}],events:[{key:"pwa.update.prompted",version:"1.0.0"},{key:"pwa.update.applied",version:"1.0.0"},{key:"pwa.update.deferred",version:"1.0.0"}],capabilities:{provides:[{key:"pwa.update-management",version:"1.0.0"}]},docs:["docs.tech.contracts.pwa-updates"]});

package/dist/node/pwa/queries/index.js

@@ -0,0 +1 @@
+export*from"./pwaUpdateCheck.query.js";

package/dist/node/pwa/queries/pwaUpdateCheck.query.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,SchemaModel as t}from"@lssm/lib.schema";import{docId as n}from"../../docs/registry.js";import{defineQuery as i}from"../../operations/index.js";import{PWA_DOMAIN as r,PWA_OWNERS as a,PWA_STABILITY as s,PWA_TAGS as o}from"../constants.js";export const PwaUpdateCheckInput=new t({name:"PwaUpdateCheckInput",fields:{appId:{type:e.ID(),isOptional:!1},currentVersion:{type:e.String_unsecure(),isOptional:!1},currentBuildId:{type:e.String_unsecure(),isOptional:!0},platform:{type:e.String_unsecure(),isOptional:!0},lastCheckedAt:{type:e.DateTime(),isOptional:!0}}}),PwaUpdatePolicyModel=new t({name:"PwaUpdatePolicy",fields:{mode:{type:e.String_unsecure(),isOptional:!1},checkIntervalMs:{type:e.Int_unsecure(),isOptional:!0},gracePeriodMs:{type:e.Int_unsecure(),isOptional:!0},message:{type:e.String_unsecure(),isOptional:!0},minSupportedVersion:{type:e.String_unsecure(),isOptional:!0}}}),PwaReleaseModel=new t({name:"PwaRelease",fields:{version:{type:e.String_unsecure(),isOptional:!1},buildId:{type:e.String_unsecure(),isOptional:!0},releasedAt:{type:e.DateTime(),isOptional:!0},notes:{type:e.String_unsecure(),isOptional:!0}}}),PwaUpdateCheckOutput=new t({name:"PwaUpdateCheckOutput",fields:{appId:{type:e.ID(),isOptional:!1},currentVersion:{type:e.String_unsecure(),isOptional:!1},latestVersion:{type:e.String_unsecure(),isOptional:!1},updateAvailable:{type:e.Boolean(),isOptional:!1},update:{type:e.String_unsecure(),isOptional:!1},blocking:{type:e.Boolean(),isOptional:!1},policy:{type:PwaUpdatePolicyModel,isOptional:!1},release:{type:PwaReleaseModel,isOptional:!0},checkedAt:{type:e.DateTime(),isOptional:!1},message:{type:e.String_unsecure(),isOptional:!0}}}),PwaUpdateCheckQuery=i({meta:{key:"pwa.update.check",title:"Check PWA Update",version:"1.0.0",description:"Checks whether a browser frontend should prompt for a newer PWA release.",goal:"Let frontend runtimes ask the API for optional or blocking updates.",context:"Used by PWA clients during startup or polling; service-worker activation remains host-owned.",domain:r,owners:a,tags:[...o,"query"],stability:s,docId:[n("docs.tech.contracts.pwa-updates")]},capability:{key:"pwa.update-management",version:"1.0.0"},io:{input:PwaUpdateCheckInput,output:PwaUpdateCheckOutput,errors:{PWA_APP_NOT_FOUND:{description:"No PWA manifest exists for the requested app.",http:404,when:"The API cannot resolve the appId from the update request."}}},policy:{auth:"anonymous",pii:[]},transport:{rest:{method:"GET",path:"/pwa/update/check/v1.0.0"}},acceptance:{scenarios:[{key:"optional-update",given:["A newer release exists with optional policy"],when:["The client checks its current version"],then:["The response reports update optional and blocking false"]},{key:"required-update",given:["The current version is below the minimum supported version"],when:["The client checks its current version"],then:["The response reports update required and blocking true"]}]}});

package/dist/node/pwa/registry.js

@@ -0,0 +1 @@
+import{compareVersions as t}from"compare-versions";import{SpecContractRegistry as s}from"../registry.js";export class PwaAppManifestRegistry extends s{constructor(e){super("pwa-app",e)}}export function getLatestPwaRelease(e){return[...e.releases].sort((p,r)=>comparePwaVersions(r.version,p.version))[0]}export function comparePwaVersions(e,p){return t(e,p)}

package/dist/node/pwa/types.js

@@ -0,0 +1,6 @@
+export const definePwaAppManifest=(e)=>e,tech_contracts_pwa_updates_DocBlocks=[{id:"docs.tech.contracts.pwa-updates",title:"PWA update management",summary:"Configure frontend update checks with app defaults and release overrides.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/pwa-updates",tags:["tech","contracts","pwa","updates"],body:`# PWA update management
+
+PWA manifests describe the latest frontend release and the policy a runtime should apply when a browser is running an older version.
+
+Use \`defaultUpdatePolicy\` for application-wide behavior and \`release.updatePolicy\` when a release needs a stricter or looser policy. Host applications still own service worker registration and activation; ContractSpec standardizes the API contract, decision state, and update prompt behavior.
+`}];

package/dist/node/quality/environment.js

@@ -0,0 +1 @@
+import{sha256Hex as c}from"@lssm/lib.crypto-utils";import{z as t}from"zod";import{deliveryDigestSchema as r,deliveryRefSchema as n}from"../delivery/primitives.js";import{canonicalJsonString as m}from"../rich-reference/canonical-serializer.js";export const QUALITY_ENVIRONMENT_V1="contractspec.quality.environment.v1";const s={schemaVersion:t.literal(QUALITY_ENVIRONMENT_V1),id:n,mode:t.enum(["mocked","integrated","deployed"]),fixtureDigest:r,dependencies:t.array(t.object({id:n,capabilityRef:n,readinessCheckRef:n}).strict()),networkPolicyRef:n,unhandledRequests:t.literal("fail"),maximumReadinessMs:t.number().int().min(1).max(300000)};export const qualityEnvironmentMaterialV1Schema=t.object(s).strict(),qualityEnvironmentV1Schema=t.object({...s,digest:r}).strict().superRefine((e,i)=>{const{digest:o,...a}=e;if(o!==digestQualityEnvironmentV1(a))i.addIssue({code:"custom",path:["digest"],message:"Quality environment digest mismatch"});if(new Set(e.dependencies.map((d)=>d.id)).size!==e.dependencies.length)i.addIssue({code:"custom",path:["dependencies"],message:"Duplicate test dependency"});if(e.mode!=="mocked"&&e.dependencies.length===0)i.addIssue({code:"custom",path:["dependencies"],message:"Integrated and deployed tests require a readiness dependency"})});export function digestQualityEnvironmentV1(e){return`sha256:${c(m(e))}`}export function defineQualityEnvironmentV1(e){return qualityEnvironmentV1Schema.parse({...e,digest:digestQualityEnvironmentV1(e)})}export const qualityEnvironmentV1DocBlock={id:"quality-environment-v1",title:"Explicit QA environment dependencies",body:"QualityEnvironmentV1 distinguishes mocked, integrated and deployed test environments. Its digest binds fixtures, required readiness capabilities, a network policy and a bounded setup deadline. Unhandled requests must fail. Runners enforce network policy and verify fixtures before executing any test; environment configuration is never execution authority. Existing quality plans opt in through a digest-bound environment reference.",kind:"reference",route:"/docs/contracts/quality/environment-v1",visibility:"public"};

package/dist/node/quality/index.js

@@ -0,0 +1 @@
+export*from"./environment.js";export*from"./plan.js";export*from"./primitives.js";export*from"./profile.js";export*from"./receipt.js";

package/dist/node/quality/plan.js

@@ -0,0 +1 @@
+import{sha256Hex as f}from"@lssm/lib.crypto-utils";import{z as t}from"zod";import{addDeliveryDuplicateIssue as c,deliveryDigestSchema as s,deliveryGitShaSchema as r,deliveryRefSchema as i,deliveryTimestampSchema as p}from"../delivery/primitives.js";import{canonicalJsonString as u}from"../rich-reference/canonical-serializer.js";import{qualityCheckRefSchema as m,qualityGateSchema as h}from"./primitives.js";export const QUALITY_PLAN_V1="contractspec.quality.plan.v1",plannedQualityCheckV1Schema=t.object({check:m,gate:h,requirement:t.enum(["blocking","advisory"]),executionRef:i,dependsOnCheckKeys:t.array(i),environmentRef:t.object({ref:i,digest:s}).strict().optional(),reasonRefs:t.array(i).min(1)}).strict().superRefine((e,a)=>{c(e.dependsOnCheckKeys,["dependsOnCheckKeys"],a);c(e.reasonRefs,["reasonRefs"],a);if(e.dependsOnCheckKeys.includes(e.check.key))a.addIssue({code:"custom",path:["dependsOnCheckKeys"],message:"A quality check cannot depend on itself"})});const d={schemaVersion:t.literal(QUALITY_PLAN_V1),id:i,deliveryPlanDigest:s,profileRef:i,profileDigest:s,baseSha:r,headSha:r,treeSha:r,catalogHash:s,connectDecisionRefs:t.array(i).min(1),affectedContractRefs:t.array(i).min(1),checks:t.array(plannedQualityCheckV1Schema).min(1),createdAt:p};export const qualityPlanMaterialV1Schema=t.object(d).strict().superRefine(y),qualityPlanV1Schema=t.object({...d,digest:s}).strict().superRefine((e,a)=>{y(e,a);const{digest:o,...n}=e;if(o!==digestQualityPlanV1(n))a.addIssue({code:"custom",path:["digest"],message:"Quality plan digest does not match canonical material"})});export function digestQualityPlanV1(e){return`sha256:${f(u(e))}`}export function defineQualityPlanV1(e){return qualityPlanV1Schema.parse({...e,digest:digestQualityPlanV1(e)})}function y(e,a){c(e.connectDecisionRefs,["connectDecisionRefs"],a);c(e.affectedContractRefs,["affectedContractRefs"],a);const o=e.checks.map((n)=>n.check.key);c(o,["checks"],a);for(const n of e.checks)for(const l of n.dependsOnCheckKeys)if(!o.includes(l))a.addIssue({code:"custom",path:["checks"],message:`Unknown quality check dependency: ${l}`})}export const qualityPlanV1DocBlock={id:"contractspec-quality-plan-v1",title:"Digest-bound quality plan V1",body:"QualityPlanV1 selects immutable QualityCheckRef values from a qualified profile for one exact delivery digest and Git tree. Each selected check names a gate, blocking or advisory requirement, dependency keys, a qualified execution reference, and reason references. CI executes this plan; it does not decide policy or receive raw command strings from Builder.",kind:"reference",route:"/docs/contracts/quality/plan-v1",visibility:"public"};

package/dist/node/quality/primitives.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{addDeliveryDuplicateIssue as c,deliveryDigestSchema as i,deliveryRefSchema as a,deliveryTimestampSchema as o}from"../delivery/primitives.js";export const QUALITY_CHECK_KINDS=["contract","generated_drift","lint","typecheck","unit","integration","database","security","accessibility","visual","browser","package","build","supply_chain","performance","agent_evaluation","infrastructure","release","smoke"],qualityCheckKindSchema=e.enum(QUALITY_CHECK_KINDS),QUALITY_GATES=["local_agent","pr_fast","risk","merge_release","nightly","post_deploy"],qualityGateSchema=e.enum(QUALITY_GATES),qualityCheckStatusSchema=e.enum(["passed","failed","skipped","error"]),qualityCheckRefSchema=e.object({key:a,version:e.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/),digest:i,kind:qualityCheckKindSchema}).strict(),qualityCostSchema=e.object({amount:e.number().finite().nonnegative(),currency:e.string().regex(/^[A-Z]{3}$/),evidenceRef:a}).strict(),qualityCacheStateSchema=e.object({status:e.enum(["disabled","miss","local_hit","remote_hit"]),keyDigest:i.optional(),sourceReceiptRef:a.optional()}).strict().superRefine((t,s)=>{if(t.status==="disabled"&&t.keyDigest)s.addIssue({code:"custom",path:["keyDigest"],message:"A disabled cache cannot carry a key digest"});if(t.status==="remote_hit"&&!t.sourceReceiptRef)s.addIssue({code:"custom",path:["sourceReceiptRef"],message:"A remote cache hit requires its source receipt"})}),qualityCheckResultV1Schema=e.object({check:qualityCheckRefSchema,status:qualityCheckStatusSchema,commandDigest:i,cache:qualityCacheStateSchema,attempts:e.number().int().positive(),startedAt:o,finishedAt:o,durationMs:e.number().int().nonnegative(),cost:qualityCostSchema,sanitizedEvidenceDigests:e.array(i),blockingReasons:e.array(a)}).strict().superRefine((t,s)=>{c(t.sanitizedEvidenceDigests,["sanitizedEvidenceDigests"],s);c(t.blockingReasons,["blockingReasons"],s);if(Date.parse(t.finishedAt)<Date.parse(t.startedAt))s.addIssue({code:"custom",path:["finishedAt"],message:"Check finish must not precede its start"});if((t.status==="failed"||t.status==="error")&&t.blockingReasons.length===0)s.addIssue({code:"custom",path:["blockingReasons"],message:"Failed checks require stable blocking reason references"});if(t.status==="passed"&&t.blockingReasons.length>0)s.addIssue({code:"custom",path:["blockingReasons"],message:"Passed checks cannot report blocking reasons"})});

package/dist/node/quality/profile.js

@@ -0,0 +1 @@
+import{sha256Hex as p}from"@lssm/lib.crypto-utils";import{z as e}from"zod";import{deliveryDigestSchema as m,deliveryRefSchema as o}from"../delivery/primitives.js";import{canonicalJsonString as h}from"../rich-reference/canonical-serializer.js";import{QUALITY_GATES as d,qualityCheckRefSchema as b,qualityGateSchema as g}from"./primitives.js";export const QUALITY_PROFILE_V1="contractspec.quality.profile.v1";const f={schemaVersion:e.literal(QUALITY_PROFILE_V1),id:o,version:e.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/),ownerBindingRef:o,checks:e.array(b).min(1),executionBindings:e.array(e.object({checkKey:o,executionRef:o,environmentRef:e.object({ref:o,digest:m}).strict().optional(),requirement:e.enum(["blocking","advisory"]),dependsOnCheckKeys:e.array(o)}).strict()).min(1),gateAssignments:e.array(e.object({gate:g,checkKeys:e.array(o)}).strict()).length(d.length),budgets:e.array(e.object({gate:g,maximumDurationMs:e.number().int().positive(),maximumCost:e.number().finite().nonnegative(),currency:e.string().regex(/^[A-Z]{3}$/)}).strict()).length(d.length),policyRefs:e.array(o).min(1)};export const qualityProfileMaterialSchema=e.object(f).strict().superRefine(y),qualityProfileSpecSchema=e.object({...f,digest:m}).strict().superRefine((t,s)=>{y(t,s);const{digest:a,...c}=t;if(a!==digestQualityProfileSpec(c))s.addIssue({code:"custom",path:["digest"],message:"Quality profile digest does not match canonical material"})});export function digestQualityProfileSpec(t){return`sha256:${p(h(t))}`}export function defineQualityProfileSpec(t){return qualityProfileSpecSchema.parse({...t,digest:digestQualityProfileSpec(t)})}function y(t,s){const a=t.checks.map((i)=>i.key);if(new Set(a).size!==a.length)s.addIssue({code:"custom",path:["checks"],message:"Quality check keys must be unique within a profile"});const c=t.executionBindings.map((i)=>i.checkKey);if(new Set(c).size!==c.length||c.length!==a.length||a.some((i)=>!c.includes(i)))s.addIssue({code:"custom",path:["executionBindings"],message:"Every quality check requires one exact execution binding"});for(const i of t.executionBindings)for(const n of i.dependsOnCheckKeys)if(!a.includes(n)||n===i.checkKey)s.addIssue({code:"custom",path:["executionBindings"],message:`Invalid quality dependency ${n}`});for(const[i,n]of[["gateAssignments",t.gateAssignments.map((r)=>r.gate)],["budgets",t.budgets.map((r)=>r.gate)]])if(new Set(n).size!==d.length)s.addIssue({code:"custom",path:[i],message:"Every quality gate must be declared exactly once"});for(const i of t.gateAssignments)for(const n of i.checkKeys)if(!a.includes(n))s.addIssue({code:"custom",path:["gateAssignments"],message:`Unknown quality check key: ${n}`});const l=t.budgets.find((i)=>i.gate==="local_agent"),u=t.budgets.find((i)=>i.gate==="pr_fast");if(l&&l.maximumDurationMs>60000)s.addIssue({code:"custom",path:["budgets"],message:"Local/agent quality budget cannot exceed 60 seconds"});if(u&&u.maximumDurationMs>480000)s.addIssue({code:"custom",path:["budgets"],message:"PR fast-path quality budget cannot exceed eight minutes"})}export const qualityProfileSpecDocBlock={id:"contractspec-quality-profile-v1",title:"Quality profile specification V1",body:"QualityProfileSpec catalogs immutable typed checks, binds each check to one qualified execution capability and dependency set, assigns checks to the local, PR, risk, merge/release, nightly, and post-deploy gates, and caps duration and cost. Profiles do not embed provider commands or let an agent invent untyped checks.",kind:"reference",route:"/docs/contracts/quality/profile-v1",visibility:"public"};

package/dist/node/quality/receipt.js

@@ -0,0 +1 @@
+import{sha256Hex as h}from"@lssm/lib.crypto-utils";import{z as n}from"zod";import{addDeliveryDuplicateIssue as R,deliveryDigestSchema as r,deliveryGitShaSchema as u,deliveryRefSchema as c,deliveryTimestampSchema as p}from"../delivery/primitives.js";import{canonicalJsonString as f}from"../rich-reference/canonical-serializer.js";import{qualityCheckResultV1Schema as m,qualityCostSchema as g}from"./primitives.js";export const QUALITY_RUN_RECEIPT_V1="contractspec.quality.run-receipt.v1",qualityRunnerIdentityV1Schema=n.object({kind:n.enum(["local","ci","runtime_node"]),identityRef:c,imageRef:c,imageDigest:r,environmentRef:c}).strict(),qualityToolchainBindingV1Schema=n.object({toolRef:c,version:c,digest:r}).strict();const d={schemaVersion:n.literal(QUALITY_RUN_RECEIPT_V1),id:c,planDigest:r,deliveryPlanDigest:r,baseSha:u,headSha:u,treeSha:u,runner:qualityRunnerIdentityV1Schema,toolchains:n.array(qualityToolchainBindingV1Schema).min(1),checkResults:n.array(m).min(1),status:n.enum(["passed","failed","indeterminate"]),startedAt:p,finishedAt:p,durationMs:n.number().int().nonnegative(),cost:g,connectDecisionRefs:n.array(c).min(1),sanitizedEvidenceDigests:n.array(r),blockingReasons:n.array(c)};export const qualityRunReceiptMaterialV1Schema=n.object(d).strict().superRefine(y),qualityRunReceiptV1Schema=n.object({...d,digest:r}).strict().superRefine((e,i)=>{y(e,i);const{digest:a,...s}=e;if(a!==digestQualityRunReceiptV1(s))i.addIssue({code:"custom",path:["digest"],message:"Quality receipt digest does not match canonical material"})});export function digestQualityRunReceiptV1(e){return`sha256:${h(f(e))}`}export function defineQualityRunReceiptV1(e){return qualityRunReceiptV1Schema.parse({...e,digest:digestQualityRunReceiptV1(e)})}export function verifyQualityRunReceiptV1(e){const i=verifyQualityRunReceiptIntegrityV1(e),{plan:a,receipt:s}=e,o=new Map(s.checkResults.map((t)=>[t.check.key,t]));for(const t of a.checks){const l=o.get(t.check.key);if(t.requirement==="blocking"&&l?.status!=="passed")i.push(`Blocking quality check did not pass: ${t.check.key}`)}if(i.length>0&&s.status==="passed")i.push("A receipt with binding or blocking failures cannot pass");return i}export function verifyQualityRunReceiptIntegrityV1(e){const{plan:i,receipt:a}=e,s=[];if(a.planDigest!==i.digest)s.push("Quality receipt does not bind the quality plan digest");if(a.deliveryPlanDigest!==i.deliveryPlanDigest)s.push("Quality receipt does not bind the delivery plan digest");for(const t of["baseSha","headSha","treeSha"])if(a[t]!==i[t])s.push(`Quality receipt changes ${t}`);const o=new Map(a.checkResults.map((t)=>[t.check.key,t]));for(const t of i.checks){const l=o.get(t.check.key);if(!l){s.push(`Quality receipt omits check ${t.check.key}`);continue}if(l.check.digest!==t.check.digest)s.push(`Quality receipt changes check ${t.check.key}`)}for(const t of i.connectDecisionRefs)if(!a.connectDecisionRefs.includes(t))s.push(`Quality receipt omits Connect decision ${t}`);return s}function y(e,i){for(const[a,s]of[["toolchains",e.toolchains.map((o)=>o.toolRef)],["checkResults",e.checkResults.map((o)=>o.check.key)],["connectDecisionRefs",e.connectDecisionRefs],["sanitizedEvidenceDigests",e.sanitizedEvidenceDigests],["blockingReasons",e.blockingReasons]])R(s,[a],i);if(Date.parse(e.finishedAt)<Date.parse(e.startedAt))i.addIssue({code:"custom",path:["finishedAt"],message:"Quality run finish must not precede its start"});if(e.status==="passed"&&e.blockingReasons.length>0)i.addIssue({code:"custom",path:["blockingReasons"],message:"Passed quality runs cannot report blocking reasons"});if(e.status!=="passed"&&e.blockingReasons.length===0)i.addIssue({code:"custom",path:["blockingReasons"],message:"Non-passing quality runs require stable blocking reasons"})}export const qualityRunReceiptV1DocBlock={id:"contractspec-quality-run-receipt-v1",title:"Quality run receipt V1",body:"QualityRunReceiptV1 binds one immutable quality plan and delivery plan to exact Git SHAs, runner image, toolchains, command digests, cache states, attempts, durations, costs, sanitized evidence digests, Connect decisions, and blocking reasons. Verification rejects omitted or changed checks and prevents a blocking failure from being represented as passing.",kind:"reference",route:"/docs/contracts/quality/run-receipt-v1",visibility:"public"};

package/dist/node/query/cache-status.js

@@ -0,0 +1 @@
+export const CACHE_STATUSES=["fresh","stale","warm","offline","empty","conflict"];export function isCacheStatus(t){return typeof t==="string"&&CACHE_STATUSES.includes(t)}

package/dist/node/query/conflict-policy.js

@@ -0,0 +1 @@
+export const DEFAULT_CONFLICT_STRATEGY="server-wins",CONFLICT_STRATEGIES=["server-wins","field-merge","client-wins","surface","crdt","custom"];export function defaultConflictPolicy(){return{strategy:DEFAULT_CONFLICT_STRATEGY}}export function isConflictStrategy(t){return typeof t==="string"&&CONFLICT_STRATEGIES.includes(t)}

package/dist/node/query/consistency.js

@@ -0,0 +1 @@
+export const DEFAULT_QUERY_CONSISTENCY="read-your-writes",QUERY_CONSISTENCY_LEVELS=["eventual","read-your-writes","strong"];export function isQueryConsistency(e){return e==="eventual"||e==="read-your-writes"||e==="strong"}

package/dist/node/query/index.d.js

@@ -0,0 +1 @@
+export{CACHE_STATUSES,isCacheStatus}from"./cache-status.js";export{CONFLICT_STRATEGIES,DEFAULT_CONFLICT_STRATEGY,defaultConflictPolicy,isConflictStrategy}from"./conflict-policy.js";export{DEFAULT_QUERY_CONSISTENCY,isQueryConsistency,QUERY_CONSISTENCY_LEVELS}from"./consistency.js";export{createInvalidationTag,invalidationTagKey,invalidationTagMatches,isInvalidationTag}from"./invalidation.js";export{createQueryKey}from"./key.js";export{createQueryResultEnvelope,normalizeQueryEnvelope,normalizeQueryPagination,requireOnlineForDestructiveMutation,toLegacyAgentListInput}from"./normalize.js";export{isTerminalQueryStatus}from"./query-state.js";export{isVersionToken,versionTokensConflict}from"./version-token.js";

package/dist/node/query/index.js

@@ -0,0 +1 @@
+export{CACHE_STATUSES,isCacheStatus}from"./cache-status.js";export{CONFLICT_STRATEGIES,DEFAULT_CONFLICT_STRATEGY,defaultConflictPolicy,isConflictStrategy}from"./conflict-policy.js";export{DEFAULT_QUERY_CONSISTENCY,isQueryConsistency,QUERY_CONSISTENCY_LEVELS}from"./consistency.js";export{createInvalidationTag,invalidationTagKey,invalidationTagMatches,isInvalidationTag}from"./invalidation.js";export{createQueryKey}from"./key.js";export{createQueryResultEnvelope,normalizeQueryEnvelope,normalizeQueryPagination,requireOnlineForDestructiveMutation,toLegacyAgentListInput}from"./normalize.js";export{isTerminalQueryStatus}from"./query-state.js";export{isVersionToken,versionTokensConflict}from"./version-token.js";

package/dist/node/query/invalidation.js

@@ -0,0 +1 @@
+export function createInvalidationTag(n,i){return i===void 0?{entity:n}:{entity:n,id:i}}export function invalidationTagKey(n){return n.id===void 0?n.entity:`${n.entity}:${n.id}`}export function invalidationTagMatches(n,i){if(n.entity!==i.entity)return!1;if(i.id===void 0)return!0;return n.id===i.id}export function isInvalidationTag(n){return typeof n==="object"&&n!==null&&typeof n.entity==="string"}

package/dist/node/query/key.js

@@ -0,0 +1 @@
+export function createQueryKey(r){return i(["query",r.operation.key,r.operation.version??"",r.input??null,r.search??"",r.filters??[],r.sort??[],r.pagination??null,r.cache?.keyParts??[]])}function i(r){return JSON.stringify(o(r))}function o(r){if(Array.isArray(r))return r.map(o);if(!r||typeof r!=="object")return r;return Object.fromEntries(Object.entries(r).sort(([n],[t])=>n.localeCompare(t)).map(([n,t])=>[n,o(t)]))}

package/dist/node/query/normalize.js

@@ -0,0 +1 @@
+export function normalizeQueryPagination(e){const r=e?.mode??(e?.cursor?"cursor":"offset");if(r==="cursor")return{mode:r,cursor:e?.cursor,limit:t(e?.limit??e?.pageSize,20),direction:e?.direction??"forward"};const o=t(e?.pageSize??e?.limit,20),n=t(e?.page,1);return{mode:r,page:n,pageSize:o,offset:Math.max(0,e?.offset??(n-1)*o),limit:o}}export function normalizeQueryEnvelope(e){const r=Array.isArray(e.sort)?e.sort:e.sort?[e.sort]:[];return{operation:e.operation??{key:"query.unknown"},input:e.input,search:e.search?.trim()||void 0,filters:i(e.filters)??[],sort:r,pagination:normalizeQueryPagination(e.pagination),cache:e.cache,tags:e.tags,consistency:e.consistency}}export function createQueryResultEnvelope(e){const r=e.pagination?.mode??(e.cursor?"cursor":void 0);return{data:e.data,pageInfo:{mode:r,cursor:e.cursor,hasNextPage:e.cursor?!0:void 0,approxTotal:e.approxTotal,fromCache:e.fromCache,stale:e.stale,offline:e.offline},versionToken:e.versionToken}}export function requireOnlineForDestructiveMutation(e,r,o="Destructive offline mutations require an explicit replay/conflict policy."){return{operation:e,input:r,offlinePolicy:{mode:"online-only",destructive:!0,reason:o}}}export function toLegacyAgentListInput(e){const r=Object.fromEntries((e.filters??[]).map((a)=>[a.field,a.value])),o=e.sort?.[0],n=e.pagination;return{filter:Object.keys(r).length?r:void 0,sort:o?`${o.field}:${o.direction}`:void 0,cursor:n?.mode==="cursor"?n.cursor:void 0,limit:n?.limit}}function i(e){if(!e)return;if(Array.isArray(e))return[...e];return Object.entries(e).sort(([r],[o])=>r.localeCompare(o)).flatMap(([r,o])=>o==null||o===""||o==="all"?[]:[{field:r,operator:Array.isArray(o)?"in":"eq",value:o}])}function t(e,r){return Math.max(1,Math.floor(e??r))}

package/dist/node/query/query-state.js

@@ -0,0 +1 @@
+export function isTerminalQueryStatus(e){return e==="success"||e==="error"||e==="auth-expired"}

package/dist/node/query/version-token.js

@@ -0,0 +1 @@
+export function isVersionToken(n){return typeof n==="string"&&n.length>0}export function versionTokensConflict(n,e){if(n===void 0||e===void 0)return!1;return n!==e}

package/dist/node/regenerator/executor.js

@@ -0,0 +1 @@
+export class ProposalExecutor{deps;constructor(o={}){this.deps=o}async execute(o,e,i={}){const s=new Date,a=[];for(const[n,t]of e.actions.entries()){const r=await this.executeAction({index:n,action:t,context:o,proposal:e,options:i});a.push(r)}const p=new Date,u=c(a);return{proposalId:e.id,contextId:o.id,startedAt:s,finishedAt:p,status:u,actions:a}}async executeAction({index:o,action:e,context:i,proposal:s,options:a}){const p=new Date,u=a.dryRun??!1,n=(t,r={})=>({index:o,action:e,status:t,startedAt:p,finishedAt:new Date,reason:r.reason,output:r.output,error:r.error});if(u)return n("skipped",{reason:"dry_run"});try{switch(e.kind){case"update_blueprint":{const t=this.deps.blueprintUpdater;if(!t)return n("skipped",{reason:"missing_blueprint_updater"});const r=await t.applyBlueprintUpdate(i,s,e);return n("success",{output:r})}case"update_tenant_config":{const t=this.deps.tenantConfigUpdater;if(!t)return n("skipped",{reason:"missing_tenant_config_updater"});const r=await t.applyTenantConfigUpdate(i,s,e);return n("success",{output:r})}case"run_tests":{const t=this.deps.testExecutor;if(!t)return n("skipped",{reason:"missing_test_executor"});const r=await t.runTests(i,s,e);return n("success",{output:r})}case"run_migrations":{const t=this.deps.migrationExecutor;if(!t)return n("skipped",{reason:"missing_migration_executor"});const r=await t.runMigrations(i,s,e);return n("success",{output:r})}case"trigger_regeneration":{const t=this.deps.regenerationTrigger;if(!t)return n("skipped",{reason:"missing_regeneration_trigger"});const r=await t.triggerRegeneration(i,s,e);return n("success",{output:r})}default:return n("skipped",{reason:"unknown_action"})}}catch(t){return n("failed",{error:t instanceof Error?t:Error(String(t))})}}}function c(o){if(o.some((e)=>e.status==="failed"))return"failed";if(o.some((e)=>e.status==="success")&&o.some((e)=>e.status==="skipped"))return"partial";if(o.every((e)=>e.status==="skipped"))return"partial";return"success"}

package/dist/node/regenerator/index.js

@@ -0,0 +1 @@
+export*from"./adapters.js";export*from"./executor.js";export*from"./service.js";export*from"./sinks.js";export*from"./types.js";export*from"./utils.js";

package/dist/node/regenerator/service.js

@@ -0,0 +1 @@
+import{behaviorToEnvelope as i,errorToEnvelope as l,telemetryToEnvelope as c}from"./utils.js";const p=(e)=>new Promise((n)=>setTimeout(n,e)),u=60000,g=300000;export class RegeneratorService{options;contexts;lastPoll=new Map;timer;running=!1;pollInterval;batchDuration;clock;constructor(e){this.options=e;this.contexts=new Map(e.contexts.map((n)=>[n.id,n]));this.pollInterval=e.pollIntervalMs??u;this.batchDuration=e.batchDurationMs??g;this.clock=e.clock??(()=>new Date);if(this.options.rules.length===0)throw Error("RegeneratorService requires at least one rule")}start(){if(this.running)return;this.running=!0;this.tick();this.timer=setInterval(()=>{this.tick()},this.pollInterval)}stop(){if(!this.running)return;this.running=!1;if(this.timer){clearInterval(this.timer);this.timer=void 0}}async runOnce(){await this.tick()}async tick(){const e=this.clock(),n=new Date(e.getTime()-this.batchDuration);for(const t of this.contexts.values()){const r=this.lastPoll.get(t.id)??n;await this.evaluateContext(t,r,e);this.lastPoll.set(t.id,e)}}async evaluateContext(e,n,t){const r=await this.collectSignals(e,n,t);if(r.length===0)return;for(const o of this.options.rules){let s=[];try{s=await o.evaluate(e,r)}catch(a){console.error(`[regenerator] rule ${o.id} failed`,a instanceof Error?a:Error(String(a)));continue}await this.flushProposals(e,s)}}async collectSignals(e,n,t){const r=[],{adapters:o}=this.options;if(o.telemetry){const s=await o.telemetry.pollTelemetry(e,n,t);r.push(...s.map((a)=>c(e.id,a,this.clock)))}if(o.errors){const s=await o.errors.pollErrors(e,n,t);r.push(...s.map((a)=>l(e.id,a,this.clock)))}if(o.behavior){const s=await o.behavior.pollBehavior(e,n,t);r.push(...s.map((a)=>i(e.id,a,this.clock)))}return r}async flushProposals(e,n){for(const t of n){if(t.signalIds.length===0)continue;await this.options.sink.submit(e,t);if(n.length>10)await p(0)}}}export const tech_contracts_regenerator_DocBlocks=[{id:"docs.tech.contracts.regenerator",title:"Regenerator Service",summary:"The Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/regenerator",tags:["tech","contracts","regenerator"],body:"## Regenerator Service\n\nThe Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.\n\n- Runtime entrypoint: `packages/libs/contracts/src/regenerator/service.ts`\n- Types/interfaces: `packages/libs/contracts/src/regenerator/types.ts`\n- Signal adapters: `packages/libs/contracts/src/regenerator/adapters.ts`\n\n### Architecture\n\n```text\nSignal Adapters ──► RegeneratorService ──► Rules ──► ProposalSink\n          ▲                                       │\n          │                                       ▼\n     Telemetry / Errors / Behavior         Spec change proposals\n```\n\n1. **Signal adapters** pull batches of telemetry, error logs, or behavior metrics for each `RegenerationContext`.\n2. `RegeneratorService` schedules polling (`resolveAppConfig` + `composeAppConfig` provide context).\n3. **Rules** implement domain heuristics and emit `SpecChangeProposal` objects.\n4. **Proposal sinks** persist or forward proposals for human review.\n\n### Key types\n\n```ts\nexport interface RegenerationContext {\n  id: string;\n  blueprint: AppBlueprintSpec;\n  tenantConfig: TenantAppConfig;\n  resolved: ResolvedAppConfig;\n}\n\nexport interface RegeneratorRule {\n  id: string;\n  description: string;\n  evaluate(\n    context: RegenerationContext,\n    signals: RegeneratorSignal[]\n  ): Promise<SpecChangeProposal[]>;\n}\n\nexport interface SpecChangeProposal {\n  id: string;\n  title: string;\n  summary: string;\n  confidence: 'low' | 'medium' | 'high';\n  target: ProposalTarget;\n  actions: ProposalAction[];\n  blockers?: ProposalBlocker[];\n  signalIds: string[];\n  createdAt: Date;\n}\n```\n\n- Signals are normalized envelopes: telemetry (`count`, anomaly score), errors, and behavior trends.\n- Proposals reference blueprint or tenant specs via `ProposalTarget`.\n- Actions encode what the automation should perform (update blueprint, run tests/migrations, trigger regeneration).\n\n### Providing signals\n\nImplement `TelemetrySignalProvider`, `ErrorSignalProvider`, or `BehaviorSignalProvider`:\n\n```ts\nconst service = new RegeneratorService({\n  contexts,\n  adapters: {\n    telemetry: new PosthogTelemetryAdapter(),\n    errors: new SentryErrorAdapter(),\n  },\n  rules: [new WorkflowFailureRule(), new DataViewUsageRule()],\n  sink: new ProposalQueueSink(),\n  pollIntervalMs: 60_000,\n});\n```\n\nAdapters receive the full `RegenerationContext`, making it easy to scope queries per tenant/app.\n\n### Authoring rules\n\nRules focus on signals → proposals:\n\n```ts\nclass WorkflowFailureRule implements RegeneratorRule {\n  id = 'workflow-failure';\n  description = 'Suggest splitting workflows that exceed failure thresholds';\n\n  async evaluate(context, signals) {\n    const failures = signals.filter(\n      (signal) =>\n        signal.type === 'telemetry' &&\n        signal.signal.eventName === 'workflow.failure' &&\n        signal.signal.count >= 10\n    );\n\n    if (failures.length === 0) return [];\n\n    return [\n      {\n        id: `${this.id}-${context.id}`,\n        title: 'Split onboarding workflow',\n        summary: 'Step 3 fails consistently; propose dedicated remediation branch.',\n        confidence: 'medium',\n        rationale: ['Failure count ≥ 10 within last window'],\n        target: {\n          specType: 'workflow',\n          reference: { name: 'onboarding.workflow', version: '1.0.0' },\n          tenantScoped: true,\n        },\n        actions: [\n          { kind: 'update_tenant_config', summary: 'Add alternate fallback path' },\n          { kind: 'run_tests', tests: ['workflows/onboarding.spec.ts'] },\n        ],\n        signalIds: failures.map((f) => f.signal.eventName),\n        createdAt: new Date(),\n      },\n    ];\n  }\n}\n```\n\n### Reviewing proposals\n\nProposals flow to a `ProposalSink` (queue, DB, messaging bus). The Studio will surface:\n\n1. Signal evidence (telemetry counts, error metadata)\n2. Proposed spec diffs and required actions (tests/migrations)\n3. Approval workflow (approve → write spec diff → run automation)\n\n### CLI driver\n\nRun the regenerator daemon from the CLI:\n\n```bash\nbunx contracts regenerator ./app.blueprint.ts ./tenant.config.ts ./regenerator.rules.ts auto \\\n  --executor ./regenerator.executor.ts \\\n  --poll-interval 60000 \\\n  --batch-duration 300000 \\\n  --dry-run\n```\n\n- Expects modules exporting default `AppBlueprintSpec`, `TenantAppConfig`, and one or more `RegenerationRule`s.\n- Pass a sink module path, or use the special `auto` value with `--executor <module>` to instantiate an `ExecutorProposalSink`.\n- Executor modules can export a `ProposalExecutor` instance, a factory, or a plain dependency object for the executor constructor. Optional exports: `sinkOptions`, `logger`, `onResult`, `dryRun`.\n- Optionally provide `--contexts ./contexts.ts` to load custom context arrays (advanced multi-tenant scenarios).\n- Use `--dry-run` to preview actions without mutating specs/configs, and `--once` for CI smoke tests.\n\n### Proposal executor\n\n`ProposalExecutor` + `ExecutorProposalSink` orchestrate follow-up actions once a proposal is approved:\n\n- Interfaces for applying blueprint or tenant-config updates (`BlueprintUpdater`, `TenantConfigUpdater`).\n- Hooks for running contract tests and migrations (`TestExecutor`, `MigrationExecutor`).\n- Optional trigger to recompose the runtime (`RegenerationTrigger`).\n- Built-in `dryRun` mode to preview outcomes.\n- Pluggable result logging/forwarding via `ExecutorSinkOptions`.\n\n```ts\nimport {\n  ProposalExecutor,\n  ExecutorProposalSink,\n} from '@lssm/lib.contracts-spec/regenerator';\n\nconst executor = new ProposalExecutor({\n  tenantConfigUpdater,\n  testExecutor,\n  migrationExecutor,\n  regenerationTrigger,\n});\n\nconst sink = new ExecutorProposalSink(executor, {\n  dryRun: false,\n  onResult: ({ result }) => console.log(result.status),\n});\n```\n\nExecution results include per-action status (`success`, `skipped`, `failed`) plus aggregated proposal status (`success`, `partial`, `failed`). Missing dependencies mark actions as `skipped`, making it easy to plug into partial automation flows today and extend later.\n\n### Next steps\n\n- Build adapters for existing telemetry/error providers.\n- Encode canonical rules (workflow failure, feature under-use, high latency).\n- Integrate with App Studio proposal inbox and automate acceptance (write spec diff, run tests, queue migrations).\n\n"}];

package/dist/node/regenerator/sinks.js

@@ -0,0 +1 @@
+export class ExecutorProposalSink{executor;options;constructor(e,r={}){this.executor=e;this.options=r}async submit(e,r){const t=this.options.dryRun??!1;try{const o=await this.executor.execute(e,r,{dryRun:t});if(this.options.logger?.info)this.options.logger.info("[regenerator] proposal executed",{proposalId:r.id,contextId:e.id,status:o.status});if(this.options.onResult)await this.options.onResult({context:e,proposal:r,result:o})}catch(o){if(this.options.logger?.error)this.options.logger.error("[regenerator] proposal execution failed",o instanceof Error?o:Error(String(o)),{proposalId:r.id,contextId:e.id});throw o instanceof Error?o:Error(String(o))}}}

package/dist/node/regenerator/utils.js

@@ -0,0 +1 @@
+export function telemetryToEnvelope(e,r,n){return{type:"telemetry",contextId:e,signal:t(r,n)}}export function errorToEnvelope(e,r,n){return{type:"error",contextId:e,signal:i(r,n)}}export function behaviorToEnvelope(e,r,n){return{type:"behavior",contextId:e,signal:a(r,n)}}function t(e,r){return{...e,windowStart:o(e.windowStart,r),windowEnd:o(e.windowEnd,r)}}function i(e,r){return{...e,occurredAt:o(e.occurredAt,r)}}function a(e,r){return{...e,windowStart:o(e.windowStart,r),windowEnd:o(e.windowEnd,r)}}function o(e,r){if(e instanceof Date)return e;const n=new Date(e);if(Number.isNaN(n.getTime()))return r();return n}

package/dist/node/registry-utils.js

@@ -0,0 +1 @@
+export const GroupingStrategies={byTag:(e)=>e.meta.tags?.[0]??"untagged",byAllTags:(e)=>e.meta.tags?.length?e.meta.tags:["untagged"],byOwner:(e)=>e.meta.owners?.[0]??"unowned",byDomain:(e)=>{return(e.meta.key??e.meta.key??"").split(".")[0]??"default"},byStability:(e)=>e.meta.stability??"stable",byUrlPath:(e)=>(t)=>{if(!t.path)return"root";return t.path.split("/").filter(Boolean).slice(0,e).join("/")||"root"}};export function filterBy(e,t){return e.filter((n)=>{if(t.tags?.length){if(!t.tags.some((s)=>n.meta.tags?.includes(s)))return!1}if(t.owners?.length){if(!t.owners.some((s)=>n.meta.owners?.includes(s)))return!1}if(t.stability?.length){if(!t.stability.includes(n.meta.stability??"stable"))return!1}if(t.domain){if(GroupingStrategies.byDomain(n)!==t.domain)return!1}if(t.keyPattern){const r=n.meta.key??n.meta.key??"",s=t.keyPattern.replace(/\*/g,".*").replace(/\?/g,".");if(!new RegExp(`^${s}$`,"i").test(r))return!1}return!0})}export function groupBy(e,t){const n=new Map;for(const r of e){const s=t(r),i=n.get(s);if(i)i.push(r);else n.set(s,[r])}return n}export function groupByToArray(e,t){const n=groupBy(e,t);return Array.from(n.entries()).map(([r,s])=>({key:r,items:s}))}export function groupByMultiple(e,t){const n=new Map;for(const r of e){const s=t(r);for(const i of s){const o=n.get(i);if(o)o.push(r);else n.set(i,[r])}}return n}export function getUniqueTags(e){const t=new Set;for(const n of e)for(const r of n.meta.tags??[])t.add(r);return Array.from(t).sort()}export function getUniqueOwners(e){const t=new Set;for(const n of e)for(const r of n.meta.owners??[])t.add(r);return Array.from(t).sort()}export function getUniqueDomains(e){const t=new Set;for(const n of e)t.add(GroupingStrategies.byDomain(n));return Array.from(t).sort()}

package/dist/node/registry.js

@@ -0,0 +1 @@
+import{compareVersions as s}from"compare-versions";import{filterBy as c,getUniqueTags as o,groupBy as a}from"./registry-utils.js";export const keyOfSpecContract=(t)=>`${t.meta.key}.v${t.meta.version}`;export class SpecContractRegistry{contractType;items=new Map;constructor(t,e){this.contractType=t;if(e)e.forEach((r)=>this.register(r))}register(t){const e=keyOfSpecContract(t);if(this.items.has(e))throw Error(`Duplicate contract \`${this.contractType}\` ${e}`);this.items.set(e,t);return this}count(){return this.items.size}list(){return[...this.items.values()]}get(t,e){if(e!=null)return this.items.get(`${t}.v${e}`);let r;for(const[n,i]of this.items.entries()){if(!n.startsWith(`${t}.v`))continue;if(!r||s(i.meta.version,r.meta.version)>0)r=i}return r}has(t,e){return!!this.get(t,e)}filter(t){return c(this.list(),t)}listByTag(t){return this.list().filter((e)=>e.meta.tags?.includes(t))}listByOwner(t){return this.list().filter((e)=>e.meta.owners?.includes(t))}groupBy(t){return a(this.list(),t)}getUniqueTags(){return o(this.list())}}

package/dist/node/release/index.js

@@ -0,0 +1 @@
+export*from"../versioning/index.js";

package/dist/node/resources.js

@@ -0,0 +1 @@
+export function defineResourceTemplate(e){return e}function p(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function u(e){const r=[],i=e.split(/(\{[^}]+\})/g).filter(Boolean).map((t)=>{const n=t.match(/^\{([^}]+)\}$/);if(!n)return p(t);const[s]=n.slice(1);if(!s)return p(t);r.push(s);return"([^/]+)"}).join("");return{regex:new RegExp(`^${i}$`),names:r}}export class ResourceRegistry{templates=[];register(e){this.templates.push(e);return this}listTemplates(){return[...this.templates]}match(e){for(const r of this.templates){const{regex:i,names:t}=u(r.meta.uriTemplate),n=e.match(i);if(!n)continue;const s={};t.forEach((a,c)=>{const o=n[c+1];if(a&&o)s[a]=decodeURIComponent(o)});return{tmpl:r,params:s}}return}}export function resourceRef(e,r){return{kind:"resource_ref",uriTemplate:e,varName:r.varName??"id",graphQLType:r.graphQLType,many:r.many}}export function isResourceRef(e){const r=e;return!!r&&r.kind==="resource_ref"&&typeof r.uriTemplate==="string"}

package/dist/node/results/builders.js

@@ -0,0 +1 @@
+import{isStandardRetryableStatus as s}from"./status.js";export const success={ok:(e={})=>({status:e.status??200,state:e.state??"completed",description:e.description??"The operation completed successfully.",headers:e.headers}),created:(e={})=>({status:e.status??201,state:e.state??"created",description:e.description??"The resource was created.",headers:e.headers}),accepted:(e={})=>({status:e.status??202,state:e.state??"accepted",description:e.description??"The operation was accepted.",headers:e.headers}),queued:(e={})=>({status:e.status??202,state:e.state??"queued",description:e.description??"The operation was queued.",headers:e.headers}),noContent:(e={})=>({status:e.status??204,state:e.state??"empty",description:e.description??"The operation completed without a body.",headers:e.headers}),partial:(e={})=>({status:e.status??206,state:e.state??"partial",description:e.description??"The operation partially completed.",headers:e.headers})},failure={badRequest:(e={})=>r(400,"validation","The request is malformed.",e),unauthenticated:(e={})=>r(401,"auth","Authentication is required.",e),paymentRequired:(e={})=>r(402,"payment","Payment or billing action is required.",e),forbidden:(e={})=>r(403,"auth","The caller is not allowed to perform this action.",e),notFound:(e={})=>r(404,"not_found","The requested resource was not found.",e),conflict:(e={})=>r(409,"conflict","The request conflicts with current state.",e),validation:(e={})=>r(422,"validation","The request did not pass validation.",e),rateLimited:(e={})=>r(429,"rate_limit","The caller has been rate limited.",{retryable:!0,...e}),internal:(e={})=>r(500,"internal","An unexpected error occurred.",{severity:"error",...e}),timeout:(e={})=>r(504,"timeout","The operation timed out.",{retryable:!0,...e})};function r(e,a,n,t){return{status:t.status??t.http??e,http:t.http,category:t.category??a,description:t.description??n,title:t.title,type:t.type,severity:t.severity??(e>=500?"error":"warning"),retryable:t.retryable??s(e),retryAfter:t.retryAfter,gqlCode:t.gqlCode,when:t.when,args:t.args}}

package/dist/node/results/error.js

@@ -0,0 +1 @@
+export class ContractSpecError extends Error{problem;code;status;retryable;constructor(t){super(t.detail??t.title);this.name="ContractSpecError";this.problem=t;this.code=t.code;this.status=t.status;this.retryable=t.retryable;Object.setPrototypeOf(this,new.target.prototype)}}

package/dist/node/results/factories.js

@@ -0,0 +1 @@
+import{ContractSpecError as s}from"./error.js";import{createProblem as c}from"./problem.js";export function defineResultCatalog(e){return e}export function contractOk(e,t={}){return{ok:!0,code:t.code??"OK",status:t.status??200,data:e,state:t.state??"completed",message:t.message,warnings:t.warnings,partialProblems:t.partialProblems,traceId:t.traceId,headers:t.headers,links:t.links,pagination:t.pagination,cache:t.cache,idempotency:t.idempotency,consistency:t.consistency,versionToken:t.versionToken,source:t.source,metadata:t.metadata}}export function contractCreated(e,t={}){return contractOk(e,{...t,code:t.code??"CREATED",status:t.status??201,state:"created"})}export function contractAccepted(e,t={}){return contractOk(e,{...t,code:t.code??"ACCEPTED",status:t.status??202,state:"accepted"})}export function contractQueued(e,t={}){return contractOk(e,{...t,code:t.code??"QUEUED",status:t.status??202,state:"queued"})}export function contractNoContent(e={}){return contractOk(void 0,{...e,code:e.code??"NO_CONTENT",status:e.status??204,state:"empty"})}export function contractPartial(e,t={}){return contractOk(e,{...t,code:t.code??"PARTIAL",status:t.status??206,state:"partial"})}export function contractFail(e,t,a={}){const r=c(e,{...a,code:e,args:t});return{ok:!1,code:e,status:r.status,problem:r}}export function contractValidationFail(e,t={}){return contractFail("VALIDATION_FAILED",void 0,{...t,status:t.status??422,category:t.category??"validation",issues:e})}export function createContractError(e,t,a={}){return new s(contractFail(e,t,a).problem)}

package/dist/node/results/guards.js

@@ -0,0 +1 @@
+import{ContractSpecError as o}from"./error.js";import{isRecord as r}from"./value-utils.js";export function isContractProblem(t){return r(t)&&typeof t.type==="string"&&typeof t.title==="string"&&typeof t.status==="number"&&typeof t.code==="string"&&typeof t.category==="string"&&typeof t.retryable==="boolean"}export function isContractSuccess(t){return r(t)&&t.ok===!0&&"data"in t}export function isContractFailure(t){return r(t)&&t.ok===!1&&typeof t.code==="string"&&isContractProblem(t.problem)}export function isContractResult(t){return isContractSuccess(t)||isContractFailure(t)}export function isContractSpecError(t){return t instanceof o}

package/dist/node/results/index.d.js

@@ -0,0 +1 @@
+export{failure,success}from"./builders.js";export{ContractSpecError}from"./error.js";export{contractAccepted,contractCreated,contractFail,contractNoContent,contractOk,contractPartial,contractQueued,contractValidationFail,createContractError,defineResultCatalog}from"./factories.js";export{isContractFailure,isContractProblem,isContractResult,isContractSpecError,isContractSuccess}from"./guards.js";export{normalizeContractError,normalizeContractResult,problemToSafeMessage}from"./normalize.js";export{isStandardFailureCode,isStandardSuccessCode,STANDARD_FAILURE_SPECS,STANDARD_SUCCESS_SPECS,standardErrors,standardSuccess}from"./standard-specs.js";

package/dist/node/results/index.js

@@ -0,0 +1 @@
+export{failure,success}from"./builders.js";export{ContractSpecError}from"./error.js";export{contractAccepted,contractCreated,contractFail,contractNoContent,contractOk,contractPartial,contractQueued,contractValidationFail,createContractError,defineResultCatalog}from"./factories.js";export{isContractFailure,isContractProblem,isContractResult,isContractSpecError,isContractSuccess}from"./guards.js";export{normalizeContractError,normalizeContractResult,problemToSafeMessage}from"./normalize.js";export{isStandardFailureCode,isStandardSuccessCode,STANDARD_FAILURE_SPECS,STANDARD_SUCCESS_SPECS,standardErrors,standardSuccess}from"./standard-specs.js";