@salsita-ai/sdk 0.50.0-develop.91d65bd507 → 0.50.0-develop.9239ced550

package/README.md

@@ -103,7 +103,7 @@ The `package.json` `exports` map is the machine-readable list, and the TypeScrip
 ## Documentation and support
 
 - `pnpm phoenix docs -s "<topic>"` searches the bundled documentation; `phoenix docs -r <path>` reads a page.
-- `phoenix sync` generates agent skills into `.claude/skills/` and `.agents/skills/`, so coding agents know the project conventions and the CLI.
+- `phoenix sync` generates one `phoenix` skill under `.claude/skills/` and `.agents/skills/`, with task-specific project, CLI, workflow, review, variants and feedback guides linked from its entry point.
 - The builder docs at [docs.salsita.ai](https://docs.salsita.ai) have the guides for getting started and the CLI reference; Studio is where you sign in and manage projects.
 - `pnpm phoenix feedback "<message>"` reaches the team directly.
 

package/dist/application/index.d.ts

@@ -1,3 +1,4 @@
 export { mountApplication, 
 /** @deprecated Use embedded admin in Editor instead */
 mountStandaloneAdminApplication, mountConfiguratorApplication, mountEmbeddedAdminApplication, mountEmbeddedConfiguratorApplication, embeddedModuleSchema, } from './mount-application.js';
+export { mountConfigurator } from './mount-configurator.js';

package/dist/application/index.js

@@ -1 +1 @@
-export{mountApplication,mountStandaloneAdminApplication,mountConfiguratorApplication,mountEmbeddedAdminApplication,mountEmbeddedConfiguratorApplication,embeddedModuleSchema}from"./mount-application.js";
+export{mountApplication,mountStandaloneAdminApplication,mountConfiguratorApplication,mountEmbeddedAdminApplication,mountEmbeddedConfiguratorApplication,embeddedModuleSchema}from"./mount-application.js";export{mountConfigurator}from"./mount-configurator.js";

package/dist/application/mount-application.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { $DomainEntity, ApplicationConfig, DomainEntity } from '#package/domain';
+import { type $DomainEntity, type ApplicationConfig, type DomainEntity } from '#package/domain';
 export declare const embeddedModuleSchema: z.ZodObject<{
     default: z.ZodObject<{
         mount: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodString>;

package/dist/application/mount-application.js

@@ -1 +1 @@
-import{jsx as o}from"react/jsx-runtime";import{z as t}from"zod";import{Application as n,EmbeddedAdmin as e,StandaloneAdmin as i}from"#package/admin";import{ConfiguratorApp as p,createConfiguratorExtensions as a}from"#package/configurator";import{createApplicationRuntime as m,createWebComponent as r}from"#package/react-sdk";export const embeddedModuleSchema=t.object({default:t.object({mount:t.function().returns(t.string()),config:t.unknown()})});let c=(o,t)=>{customElements.get(o)?console.error(`Web component with tag name "${o}" is already registered.`):customElements.define(o,t)};export const mountApplication=t=>{let e=t.mount.Application?t.mount.Application(t):()=>o(n,{});c(t.mount.tag,r({RootComponent:e,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountConfiguratorApplication=t=>{let n=t.mount.Application?t.mount.Application(t):()=>o(p,{});c(t.mount.tag,r({RootComponent:n,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountStandaloneAdminApplication=t=>{c("salsita-admin",r({RootComponent:()=>o(i,{}),webComponentOptions:{},embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountEmbeddedAdminApplication=(t,n,i)=>{c(`salsita-admin-${n}-${i}`,r({RootComponent:()=>o(e,{}),webComponentOptions:{},embeddedIntegration:!0,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountEmbeddedConfiguratorApplication=(t,n,e)=>{c(`salsita-configurator-${n}-${e}`,r({RootComponent:t.mount.Application?t.mount.Application(t):()=>o(p,{}),webComponentOptions:t.mount.options,embeddedIntegration:!0,applicationRuntimeFactory:o=>m(t,o,a)}))};
+import{jsx as o}from"react/jsx-runtime";import{z as t}from"zod";import{Application as n,EmbeddedAdmin as i,StandaloneAdmin as e}from"#package/admin";import{ConfiguratorApp as p}from"#package/configurator";import{applicationFromConfig as m}from"#package/domain";import{createWebComponent as a}from"#package/react-sdk";import{createMountedApplicationRuntime as r}from"./mounted-application-runtime.js";import{registerWebComponent as c}from"./register-web-component.js";export const embeddedModuleSchema=t.object({default:t.object({mount:t.function().returns(t.string()),config:t.unknown()})});export const mountApplication=t=>{let i=t.mount.Application?t.mount.Application(t):()=>o(n,{});c(t.mount.tag,a({RootComponent:i,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountConfiguratorApplication=t=>{let n=t.mount.Application?t.mount.Application(t):()=>o(p,{});c(t.mount.tag,a({RootComponent:n,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountStandaloneAdminApplication=t=>{c("salsita-admin",a({RootComponent:()=>o(e,{}),webComponentOptions:{},embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountEmbeddedAdminApplication=(t,n,e)=>{c(`salsita-admin-${n}-${e}`,a({RootComponent:()=>o(i,{}),webComponentOptions:{},embeddedIntegration:!0,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountEmbeddedConfiguratorApplication=(t,n,i)=>{c(`salsita-configurator-${n}-${i}`,a({RootComponent:t.mount.Application?t.mount.Application(t):()=>o(p,{}),webComponentOptions:t.mount.options,embeddedIntegration:!0,applicationRuntimeFactory:o=>r(m(t),o)}))};

package/dist/application/mount-configurator.d.ts

@@ -0,0 +1,19 @@
+import { type Application } from '#package/domain';
+/**
+ * Declares the web component of a configurator application built from its runtime spec
+ * (`createApplication` of `@salsita-ai/sdk/application-spec`), with no `ApplicationConfig`.
+ *
+ * It registers `application.tag`; every `<tag></tag>` element in the DOM renders the configurator
+ * in a closed shadow DOM. The web component's properties and events and the wrapper of the
+ * application come from the project's `GetWebComponentOptions` and `GetApplicationWrapper` handlers.
+ * With `embedded`, the configurator integrates with the page that embeds it, as
+ * `mountEmbeddedConfiguratorApplication` does; the embedding host looks for the tag
+ * `salsita-configurator-<project slug>-<environment slug>`, which the caller passes to
+ * `createApplication` as `tag`.
+ *
+ * It runs the same runtime as `mountConfiguratorApplication`, which converts its config to an
+ * application first.
+ */
+export declare const mountConfigurator: <TYPES>(application: Application<TYPES>, options?: {
+    readonly embedded?: boolean;
+}) => void;

package/dist/application/mount-configurator.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{ConfiguratorApp as r}from"#package/configurator";import{isGetApplicationWrapperHandler as t,isGetWebComponentOptionsHandler as e}from"#package/domain";import{createWebComponent as n}from"#package/react-sdk";import{createMountedApplicationRuntime as a}from"./mounted-application-runtime.js";import{registerWebComponent as i}from"./register-web-component.js";export const mountConfigurator=(m,p={})=>{let{handlers:d}=m.spec.configurator,c=d.find(t)?.handler().handler,f=d.find(e)?.handler().handler(void 0),s=c?c(m):()=>o(r,{});i(m.tag,n({RootComponent:s,webComponentOptions:f??{},embeddedIntegration:p.embedded??!1,applicationRuntimeFactory:o=>a(m,o)}))};

package/dist/application/mounted-application-runtime.d.ts

@@ -0,0 +1,4 @@
+import { type AnyConfiguratorExtensionSystems } from '#package/configurator';
+import type { Application } from '#package/domain';
+import { type ApplicationRuntime, type ApplicationRuntimeBootConfig } from '#package/react-sdk';
+export declare const createMountedApplicationRuntime: (application: Application, bootConfig: ApplicationRuntimeBootConfig) => ApplicationRuntime<AnyConfiguratorExtensionSystems>;

package/dist/application/mounted-application-runtime.js

@@ -0,0 +1 @@
+import{createConfiguratorExtensions as o}from"#package/configurator";import{createApplicationRuntime as t}from"#package/react-sdk";export const createMountedApplicationRuntime=(r,a)=>t(r,a,o);

package/dist/application/register-web-component.d.ts

@@ -0,0 +1,2 @@
+/** Defines the custom element of a mounted application, unless its tag is taken. */
+export declare const registerWebComponent: (tag: string, element: CustomElementConstructor) => void;

package/dist/application/register-web-component.js

@@ -0,0 +1 @@
+export const registerWebComponent=(e,t)=>{customElements.get(e)?console.error(`Web component with tag name "${e}" is already registered.`):customElements.define(e,t)};

package/dist/application-spec/core/enhanced-json-value.d.ts

@@ -1,26 +1,6 @@
 import { z } from 'zod';
-import { type EvalMarker } from './markers/eval-marker.js';
-import { type MsgMarker } from './markers/msg-marker.js';
-/**
- * A JSON-serialisable value augmented with Phoenix structural markers:
- * `$msg` (i18n) and `$eval` (self-scoped code).
- *
- * Single shared shape across components, expressions, and defaults — lowered
- * either to TypeScript source via {@link stringifyEnhancedJsonValue} or to a
- * runtime value via {@link resolveEnhancedJsonValue}.
- *
- * Which markers are allowed at a given slot is controlled by
- * {@link EnhancedJsonValueCaps}, not by the type — all markers parse
- * identically, capability checks kick in at lowering time.
- */
-export type EnhancedJsonValue = string | number | boolean | null | MsgMarker | EvalMarker | EnhancedJsonArray | EnhancedJsonObject;
-/** Array form of {@link EnhancedJsonValue} — extracted as a named interface so `z.lazy` can close the recursion. */
-export interface EnhancedJsonArray extends ReadonlyArray<EnhancedJsonValue> {
-}
-/** Object form of {@link EnhancedJsonValue} — extracted for the same reason as {@link EnhancedJsonArray}. */
-export interface EnhancedJsonObject {
-    readonly [key: string]: EnhancedJsonValue;
-}
+import { type EnhancedJsonObject, type EnhancedJsonValue } from '#package/domain';
+export { type EnhancedJsonArray, type EnhancedJsonObject, type EnhancedJsonValue, type SelfAccessor, canonicalEnhancedJsonValueKey, } from '#package/domain';
 /** Historical component-value shape used by domain-spec to import a project module member. */
 export interface ImportRefShape {
     readonly $importRef: {
@@ -63,18 +43,9 @@ export declare const CONSTANT_CAPS: EnhancedJsonValueCaps;
 export interface ImportSink {
     addImport(module: string, member: string): void;
 }
-/** Runtime `self` accessor — shape-agnostic entity state. */
-export type SelfAccessor = object;
 /**
  * Type guard that narrows an {@link EnhancedJsonValue} to the generic
  * {@link EnhancedJsonObject} branch — excludes primitives, arrays, and the
  * known structural markers (`$eval`, `$msg`).
  */
 export declare const isEnhancedJsonObject: (value: EnhancedJsonValue) => value is EnhancedJsonObject;
-/**
- * Deterministic string key for a value — sorted object keys, JSON-encoded.
- * Used by the expression runtime's reference store to preserve an evaluator when the
- * underlying value is structurally unchanged (mirrors the content-hash pattern
- * used for components).
- */
-export declare const canonicalEnhancedJsonValueKey: (value: EnhancedJsonValue) => string;

package/dist/application-spec/core/enhanced-json-value.js

@@ -1 +1 @@
-import{z as e}from"zod";import{evalMarkerSchema as r,isEvalMarker as o}from"./markers/eval-marker.js";import{isMsgMarker as t,msgMarkerSchema as n}from"./markers/msg-marker.js";let s=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>s.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),n,r,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!t(e)&&!o(e);export const canonicalEnhancedJsonValueKey=e=>{let r=e=>{if(null===e||"object"!=typeof e)return e;if(Array.isArray(e))return e.map(r);let o={};for(let t of Object.keys(e).sort())o[t]=r(e[t]);return o};return JSON.stringify(r(e))};
+import{z as e}from"zod";import{evalMarkerSchema as o,isEvalMarker as n,isMsgMarker as a,msgMarkerSchema as r}from"#package/domain";export{canonicalEnhancedJsonValueKey}from"#package/domain";let c=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>c.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),r,o,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!a(e)&&!n(e);

package/dist/application-spec/core/index.d.ts

@@ -1,8 +1,6 @@
+export { ApplicationInstance, FILTER_CRITERION_KEYS, type FilterCriterion, type RelationExpressionParams, type SdkCodeRef, type SdkExpressionImplementation, type SpecComponentFilter as ComponentFilter, isSdkCodeRef, isSdkExpressionImplementation, } from '#package/domain';
 export * from './application-file.js';
-export * from './components/index.js';
-export * from './expressions/index.js';
 export * from './specification-files.js';
-export * from './application-instance.js';
 export * from './spec-diagnostic.js';
 export * from './enhanced-json-schema.js';
 export * from './enhanced-json-value.js';

package/dist/application-spec/core/index.js

@@ -1 +1 @@
-export*from"./application-file.js";export*from"./components/index.js";export*from"./expressions/index.js";export*from"./specification-files.js";export*from"./application-instance.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";
+export{ApplicationInstance,FILTER_CRITERION_KEYS,isSdkCodeRef,isSdkExpressionImplementation}from"#package/domain";export*from"./application-file.js";export*from"./specification-files.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";

package/dist/application-spec/core/markers/index.d.ts

@@ -1,4 +1,4 @@
-export * from './eval-marker.js';
+export { EVAL_MARKER_KEY, type EvalMarker, evalMarkerSchema, isEvalMarker } from '#package/domain';
 export * from './filter-keys.js';
 export * from './msg-marker.js';
 export * from './raw-bind-marker.js';

package/dist/application-spec/core/markers/index.js

@@ -1 +1 @@
-export*from"./eval-marker.js";export*from"./filter-keys.js";export*from"./msg-marker.js";export*from"./raw-bind-marker.js";export*from"./raw-data-ref-marker.js";export*from"./raw-eval-write-marker.js";export*from"./raw-read-marker.js";export*from"./raw-read-write-marker.js";export*from"./raw-write-marker.js";
+export{EVAL_MARKER_KEY,evalMarkerSchema,isEvalMarker}from"#package/domain";export*from"./filter-keys.js";export*from"./msg-marker.js";export*from"./raw-bind-marker.js";export*from"./raw-data-ref-marker.js";export*from"./raw-eval-write-marker.js";export*from"./raw-read-marker.js";export*from"./raw-read-write-marker.js";export*from"./raw-write-marker.js";

package/dist/application-spec/core/markers/msg-marker.d.ts

@@ -1,31 +1,5 @@
-import type { MessageDescriptor } from '@lingui/core';
-import { z } from 'zod';
-/** Key literal for the `$msg` marker in raw YAML. */
-export declare const MSG_MARKER_KEY: '$msg';
-/** Key literal for the optional `$msgId` qualifier on `$msg`. */
-export declare const MSG_ID_MARKER_KEY: '$msgId';
-/**
- * YAML marker produced by `$msg: 'text'` / `$msg: 'text', $msgId: 'id'` entries.
- * `$msgId` is a qualifier on `$msg`, not a standalone marker.
- */
-export interface MsgMarker {
-    readonly $msg: string;
-    readonly $msgId?: string;
-}
-/** Zod decoder for {@link MsgMarker}. Strict — rejects extra keys. */
-export declare const msgMarkerSchema: z.ZodObject<{
-    $msg: z.ZodString;
-    $msgId: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    $msg: string;
-    $msgId?: string | undefined;
-}, {
-    $msg: string;
-    $msgId?: string | undefined;
-}>;
-/** Structural type guard for {@link MsgMarker}. */
-export declare const isMsgMarker: (value: unknown) => value is MsgMarker;
-export declare const createMessageDescriptor: (marker: MsgMarker) => MessageDescriptor;
+import type { MsgMarker } from '#package/domain';
+export { MSG_ID_MARKER_KEY, MSG_MARKER_KEY, type MsgMarker, createMessageDescriptor, isMsgMarker, msgMarkerSchema, } from '#package/domain';
 /**
  * Serializes a {@link MsgMarker} to lingui macro source — `` msg`…` `` or
  * `msg({ id, message })` with `$msgId` — escaping template-literal syntax in

package/dist/application-spec/core/markers/msg-marker.js

@@ -1 +1 @@
-import{generateMessageId as s}from"@lingui/message-utils/generateMessageId";import{z as e}from"zod";export const MSG_MARKER_KEY="$msg";export const MSG_ID_MARKER_KEY="$msgId";export const msgMarkerSchema=e.object({$msg:e.string(),$msgId:e.string().optional()}).strict();export const isMsgMarker=s=>msgMarkerSchema.safeParse(s).success;export const createMessageDescriptor=e=>({id:e.$msgId??s(e.$msg),message:e.$msg});export const stringifyMsgMacroCode=s=>void 0!==s.$msgId?`msg({ id: ${JSON.stringify(s.$msgId)}, message: ${JSON.stringify(s.$msg)} })`:`msg\`${s.$msg.replaceAll("\\","\\\\").replaceAll("`","\\`").replaceAll("${","\\${")}\``;
+export{MSG_ID_MARKER_KEY,MSG_MARKER_KEY,createMessageDescriptor,isMsgMarker,msgMarkerSchema}from"#package/domain";export const stringifyMsgMacroCode=e=>void 0!==e.$msgId?`msg({ id: ${JSON.stringify(e.$msgId)}, message: ${JSON.stringify(e.$msg)} })`:`msg\`${e.$msg.replaceAll("\\","\\\\").replaceAll("`","\\`").replaceAll("${","\\${")}\``;

package/dist/application-spec/core/markers/raw-eval-write-marker.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type EvalMarker } from './eval-marker.js';
+import { type EvalMarker } from '#package/domain';
 import { type RawWriteMarker } from './raw-write-marker.js';
 /**
  * YAML marker produced by `$eval: '…', $write: 'fieldName'` — computed read via

package/dist/application-spec/core/markers/raw-eval-write-marker.js

@@ -1 +1 @@
-import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"./eval-marker.js";import{WRITE_MARKER_KEY as a}from"./raw-write-marker.js";export const rawEvalWriteMarkerSchema=r.object({[e]:r.string(),[a]:r.string()}).strict();export const isRawEvalWriteMarker=r=>rawEvalWriteMarkerSchema.safeParse(r).success;
+import{z as r}from"zod";import{EVAL_MARKER_KEY as a}from"#package/domain";import{WRITE_MARKER_KEY as e}from"./raw-write-marker.js";export const rawEvalWriteMarkerSchema=r.object({[a]:r.string(),[e]:r.string()}).strict();export const isRawEvalWriteMarker=r=>rawEvalWriteMarkerSchema.safeParse(r).success;

package/dist/application-spec/core/markers/raw-read-write-marker.js

@@ -1 +1 @@
-import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"./eval-marker.js";import{bindMarkerDefinition as t}from"./raw-bind-marker.js";import{READ_MARKER_KEY as i,readMarkerDefinition as o}from"./raw-read-marker.js";import{WRITE_MARKER_KEY as a,writeMarkerDefinition as s}from"./raw-write-marker.js";export const rawReadWriteMarkerSchema=r.object({[i]:r.string(),[a]:r.string()}).strict();export const isRawReadWriteMarker=r=>rawReadWriteMarkerSchema.safeParse(r).success;export const readWriteMarkerDefinition={anyOf:[t,{type:"object",properties:{...o.properties??{},...s.properties??{}},required:o.required,additionalProperties:!1},{type:"object",properties:{[e]:{type:"string"},...s.properties??{}},required:[e,...s.required??[]],additionalProperties:!1}]};
+import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"#package/domain";import{bindMarkerDefinition as t}from"./raw-bind-marker.js";import{READ_MARKER_KEY as i,readMarkerDefinition as o}from"./raw-read-marker.js";import{WRITE_MARKER_KEY as a,writeMarkerDefinition as p}from"./raw-write-marker.js";export const rawReadWriteMarkerSchema=r.object({[i]:r.string(),[a]:r.string()}).strict();export const isRawReadWriteMarker=r=>rawReadWriteMarkerSchema.safeParse(r).success;export const readWriteMarkerDefinition={anyOf:[t,{type:"object",properties:{...o.properties??{},...p.properties??{}},required:o.required,additionalProperties:!1},{type:"object",properties:{[e]:{type:"string"},...p.properties??{}},required:[e,...p.required??[]],additionalProperties:!1}]};

package/dist/application-spec/generate-application/code/project-scaffolding.js

@@ -1,6 +1,6 @@
-import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as r,generateApplicationSpecEslintConfig as t,generateApplicationSpecFavicon as i,generateApplicationSpecGitignore as n,generateApplicationSpecPrettierConfig as a,generateApplicationSpecRobotsTxt as o,generateApplicationSpecRootTsconfig as l,generateApplicationSpecTsconfig as s,generateLinguiRcFile as c,generatePhoenixCliSkill as f,generatePhoenixCreateConfiguratorSkill as p,generatePhoenixCreateConfiguratorSkillReferences as d,generatePhoenixFeedbackSkill as m,generatePhoenixReviewSkill as g,generatePhoenixSkill as h,generatePhoenixVariantsSkill as u,stripSdkMarkerContent as j}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let x=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
+import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as i,generateApplicationSpecEslintConfig as r,generateApplicationSpecFavicon as t,generateApplicationSpecGitignore as a,generateApplicationSpecPrettierConfig as o,generateApplicationSpecRobotsTxt as n,generateApplicationSpecRootTsconfig as l,generateApplicationSpecTsconfig as s,generateLinguiRcFile as c,generatePhoenixSkillBundle as d,stripSdkMarkerContent as f}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let p=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
 description: Phoenix SDK project rules
 globs:
 alwaysApply: true
 ---
-`}],P=[".claude/commands/review.md",".cursor/commands/review.md"],v=(e,r)=>e.projectFiles.find(e=>e.file.name===r)?.file.content;export const generateProjectScaffolding=F=>{let E,G,{applicationSpec:b,categorizedFiles:k,sdkVersion:w,projectInGitRepository:L=!0,cliUseWorkspace:S}=F,$=v(k,".gitignore"),y=void 0!==S?S:b.appMetadata.workspace,C=(r=>{let t=[],i=[...P];for(let{path:n,generatedPrefix:a}of x){let o=v(r,n);if(void 0===o)continue;let l=j(o,a);void 0===l?i.push(n):l!==o&&t.push(e(n,l,{format:!1}))}return{strippedFiles:t,removedFiles:i}})(k),M={generatedProjectFiles:(E=[{file:e("tsconfig.json",l()),hasEarlierGenerated:k.hasEarlierGeneratedTsconfig},{file:e("eslint.config.js",t()),hasEarlierGenerated:k.hasEarlierGeneratedEslintConfig},{file:e("prettier.config.js",a()),hasEarlierGenerated:k.hasEarlierGeneratedPrettierConfig}]).filter(e=>e.hasEarlierGenerated).map(e=>e.file),initialProjectFiles:E.filter(e=>!e.hasEarlierGenerated).map(e=>e.file)};return{phoenixFiles:[e("tsconfig.json",s()),e(".linguirc",c(b.configurator.ui.availableLocales),{format:!1})],generatedProjectFiles:[...M.generatedProjectFiles,...L?[e(".gitignore",n($))]:[],...(G=[{name:"phoenix",content:h({checkLatestCanary:r({useWorkspace:y,sdkVersion:w})}),references:[]},{name:"phoenix-cli",content:f(),references:[]},{name:"phoenix-create-configurator",content:p(),references:d()},{name:"phoenix-feedback",content:m(),references:[]},{name:"phoenix-review",content:g(),references:[]},{name:"phoenix-variants",content:u(),references:[]}],agentSkillRoots.flatMap(r=>G.flatMap(t=>[e(`${r}/${t.name}/SKILL.md`,t.content),...t.references.map(i=>e(`${r}/${t.name}/${i.path}`,i.content))]))),...C.strippedFiles],initialProjectFiles:[...M.initialProjectFiles,e("public/favicon.ico",i(),{binary:!0}),e("public/robots.txt",o(),{format:!1})],removedProjectFiles:C.removedFiles}};
+`}],g=[".claude/commands/review.md",".cursor/commands/review.md"],m=(e,i)=>e.projectFiles.find(e=>e.file.name===i)?.file.content;export const generateProjectScaffolding=h=>{let u,j,{applicationSpec:x,categorizedFiles:P,sdkVersion:F,projectInGitRepository:E=!0,cliUseWorkspace:v}=h,G=m(P,".gitignore"),b=void 0!==v?v:x.appMetadata.workspace,k=(i=>{let r=[],t=[...g];for(let{path:a,generatedPrefix:o}of p){let n=m(i,a);if(void 0===n)continue;let l=f(n,o);void 0===l?t.push(a):l!==n&&r.push(e(a,l,{format:!1}))}return{strippedFiles:r,removedFiles:t}})(P),L={generatedProjectFiles:(u=[{file:e("tsconfig.json",l()),hasEarlierGenerated:P.hasEarlierGeneratedTsconfig},{file:e("eslint.config.js",r()),hasEarlierGenerated:P.hasEarlierGeneratedEslintConfig},{file:e("prettier.config.js",o()),hasEarlierGenerated:P.hasEarlierGeneratedPrettierConfig}]).filter(e=>e.hasEarlierGenerated).map(e=>e.file),initialProjectFiles:u.filter(e=>!e.hasEarlierGenerated).map(e=>e.file)};return{phoenixFiles:[e("tsconfig.json",s()),e(".linguirc",c(x.configurator.ui.availableLocales),{format:!1})],generatedProjectFiles:[...L.generatedProjectFiles,...E?[e(".gitignore",a(G))]:[],...(j=d({checkLatestCanary:i({useWorkspace:b,sdkVersion:F})}),agentSkillRoots.flatMap(i=>[e(`${i}/phoenix/SKILL.md`,j.content),...j.references.map(r=>e(`${i}/phoenix/${r.path}`,r.content))])),...k.strippedFiles],initialProjectFiles:[...L.initialProjectFiles,e("public/favicon.ico",t(),{binary:!0}),e("public/robots.txt",n(),{format:!1})],removedProjectFiles:k.removedFiles}};

package/dist/application-spec/generate-application/code/templates/index.d.ts

@@ -37,12 +37,8 @@ export { generateApplicationSpecGlobals } from './globals.js';
 export { generateApplicationSpecHtmlAdminIndex } from './html-admin-index.js';
 export { generateApplicationSpecHtmlIndex } from './html-index.js';
 export { generateLinguiRcFile } from './lingui-rc.js';
-export { generatePhoenixCliSkill } from './skills/phoenix-cli-skill.js';
-export { generatePhoenixCreateConfiguratorSkill, generatePhoenixCreateConfiguratorSkillReferences, } from './skills/phoenix-create-configurator-skill.js';
-export { generatePhoenixFeedbackSkill } from './skills/phoenix-feedback-skill.js';
-export { generatePhoenixReviewSkill } from './skills/phoenix-review-skill.js';
-export { type PhoenixSkillOptions, followsCanaryBuilds, generatePhoenixSkill } from './skills/phoenix-skill.js';
-export { generatePhoenixVariantsSkill } from './skills/phoenix-variants-skill.js';
+export { generatePhoenixSkillBundle } from './skills/phoenix-skill-bundle.js';
+export { type PhoenixSkillOptions, followsCanaryBuilds } from './skills/phoenix-skill.js';
 export { generateApplicationSpecPrettierConfig } from './prettier-config.js';
 export { generateApplicationSpecRobotsTxt } from './robots-txt.js';
 export { generateApplicationSpecRootTsconfig } from './root-tsconfig.js';

package/dist/application-spec/generate-application/code/templates/index.js

@@ -1 +1 @@
-export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generatePhoenixCliSkill}from"./skills/phoenix-cli-skill.js";export{generatePhoenixCreateConfiguratorSkill,generatePhoenixCreateConfiguratorSkillReferences}from"./skills/phoenix-create-configurator-skill.js";export{generatePhoenixFeedbackSkill}from"./skills/phoenix-feedback-skill.js";export{generatePhoenixReviewSkill}from"./skills/phoenix-review-skill.js";export{followsCanaryBuilds,generatePhoenixSkill}from"./skills/phoenix-skill.js";export{generatePhoenixVariantsSkill}from"./skills/phoenix-variants-skill.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecRootTsconfig}from"./root-tsconfig.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecCodeFile}from"./spec-code/index.js";export{generateApplicationSpecMessagesFile}from"./spec-messages/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";
+export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generatePhoenixSkillBundle}from"./skills/phoenix-skill-bundle.js";export{followsCanaryBuilds}from"./skills/phoenix-skill.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecRootTsconfig}from"./root-tsconfig.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecCodeFile}from"./spec-code/index.js";export{generateApplicationSpecMessagesFile}from"./spec-messages/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";

package/dist/application-spec/generate-application/code/templates/skills/phoenix-skill-bundle.d.ts

@@ -0,0 +1,10 @@
+import { type AgentSkillReference } from './agent-skill.js';
+import { type PhoenixSkillOptions } from './phoenix-skill.js';
+/** The discoverable entry point and the documents it ships beside it. */
+interface PhoenixSkillBundle {
+    readonly content: string;
+    readonly references: readonly AgentSkillReference[];
+}
+/** Keeps the existing generators as content owners while changing only discovery and relative routing. */
+export declare const generatePhoenixSkillBundle: (options: PhoenixSkillOptions) => PhoenixSkillBundle;
+export {};

package/dist/application-spec/generate-application/code/templates/skills/phoenix-skill-bundle.js

@@ -0,0 +1,7 @@
+import{renderAgentSkill as e}from"./agent-skill.js";import{generatePhoenixCliSkill as t}from"./phoenix-cli-skill.js";import{generatePhoenixCreateConfiguratorSkill as n,generatePhoenixCreateConfiguratorSkillReferences as r}from"./phoenix-create-configurator-skill.js";import{generatePhoenixFeedbackSkill as i}from"./phoenix-feedback-skill.js";import{generatePhoenixReviewSkill as o}from"./phoenix-review-skill.js";import{generatePhoenixSkill as a}from"./phoenix-skill.js";import{generatePhoenixVariantsSkill as s}from"./phoenix-variants-skill.js";let l=(e,t,n)=>n.reduce((e,n)=>{let r="../".repeat(t.split("/").length-2),i=`[${n.title}](${r}${n.path.slice(11)})`;return e.replaceAll(`\`${n.name}\` skill`,i).replaceAll(`${n.name} skill`,i)},e),c=e=>{let t="\n---\n\n",n=e.content.indexOf(t),r=e.content.slice(0,n).split("\n").find(e=>e.startsWith("description: "));if(-1===n||void 0===r)throw Error(`Cannot emit the ${e.name} guide: its skill frontmatter is missing. Render it with renderAgentSkill.`);return{description:r.slice(13),body:e.content.slice(n+t.length)}};export const generatePhoenixSkillBundle=h=>{let p=[{name:"phoenix",title:"Project guidance",path:"references/project.md",content:a(h),references:[]},{name:"phoenix-create-configurator",title:"Configurator workflow",path:"references/create-configurator/guide.md",content:n(),references:r()},{name:"phoenix-cli",title:"CLI guide",path:"references/cli.md",content:t(),references:[]},{name:"phoenix-review",title:"Code review guide",path:"references/review.md",content:o(),references:[]},{name:"phoenix-variants",title:"Variants guide",path:"references/variants.md",content:s(),references:[]},{name:"phoenix-feedback",title:"Feedback guide",path:"references/feedback.md",content:i(),references:[]}];return{content:e({name:"phoenix",description:"Build, change, inspect, deploy or review a Phoenix configurator project. Use for Phoenix project work, visual alternatives, and platform feedback.",sections:[`# Phoenix
+
+Load the guides for the work in hand before doing that work. Several may apply. Follow their existing instructions; this entry point only routes to them. Reuse guidance already read in the conversation unless sync or an SDK update changed it.`,`## Choose the relevant guidance
+
+| When | Read |
+| --- | --- |
+${p.map(e=>`| ${c(e).description} | [${e.title}](${e.path}) |`).join("\n")}`,"The workflow guide links to product discovery, asset conversion, UX guidance and appearance review at the stages that use them. An isolated code fix needs project guidance and the applicable CLI/review guides; it does not restart the configurator workflow.\n\nEarlier Phoenix skill names refer to these guides: ask for the same task through `phoenix`. Read linked documents when their task applies, not the whole reference tree."]}),references:p.flatMap(e=>[{path:e.path,content:l(c(e).body,e.path,p)},...e.references.map(t=>{let n=`${e.path.slice(0,e.path.lastIndexOf("/")+1)}${t.path}`;return{path:n,content:l(t.content,n,p)}})])}};

package/dist/application-spec/generate-application/code/templates/skills/phoenix-skill.js

@@ -1 +1 @@
-import{renderAgentSkill as e}from"./agent-skill.js";import{sdkGuidanceSections as t}from"./sdk-content.js";export const followsCanaryBuilds=e=>!e.useWorkspace&&e.sdkVersion.includes("-develop.");export const generatePhoenixSkill=({checkLatestCanary:n})=>e({name:"phoenix",description:`Phoenix SDK project conventions, covering project structure, architecture principles, key patterns, file and export rules, webhook membership, versioning the domain model once it is deployed, showing the user the dev preview and the build of a deploy, the run evaluation that follows a live deploy, inspecting the rendered result, and how to search the SDK documentation${n?", and the internal-beta check for the latest canary SDK build":""}. Use before writing or changing specs or source code, or deploying this Phoenix configurator project.`,sections:[t.packageManager,...n?["## Stay on the Latest Canary\nDuring the internal beta this project uses the `canary` build of the SDK, which is published from every change to the platform. Once per conversation, before you change anything, compare the installed version, the `version` in `node_modules/@salsita-ai/sdk/package.json`, with the newest canary:\n```bash\nnpm view @salsita-ai/sdk@canary version\n```\nWhen they differ, tell the user which version you are moving to, then update the SDK, bring the packages it needs next to it in line, and regenerate the project's files:\n```bash\npnpm add @salsita-ai/sdk@canary && pnpm phoenix deps && pnpm install && pnpm phoenix sync\n```\n`sync` rewrites the Phoenix skills, so read the ones you use again after it. When the user runs a globally installed `phoenix`, update that too with `npm install -g @salsita-ai/sdk@canary`. If the project no longer builds after the update, stop and tell the user; the `phoenix-feedback` skill covers reporting it."]:[],t.projectStructure,t.architecturePrinciples,t.keyPatterns,t.fileConventions,t.exportRules,t.webhookMembership,t.doNotEdit,t.modelVersioning,"## Show the Preview While You Work\nThe user should see the configurator change as you build it. Before your first change in a conversation, make sure `pnpm phoenix dev` is running (start it in the background when it is not) and open the address it prints as `Preview: <url>` (also written to `.phoenix/phoenix-dev.log`) in the user's browser: `open '<url>'` on macOS, `xdg-open '<url>'` on Linux, `Start-Process '<url>'` in PowerShell, `start \"\" \"<url>\"` in cmd. Keep the quotes, the shell would otherwise read a `?` in the address as a pattern. The log keeps the lines of earlier runs, so when you have just started dev, wait for the `Preview:` line written after your start and use the last one. Open it once; the preview reloads on every change, so tell the user to keep that tab open instead of opening it again.",t.visualInspection,"## Show the Build After a Deploy\nImmediately before invoking `pnpm phoenix deploy`, refresh `conversation.log` in the project root with the current conversation. Prefer the agent application's native session export when available; do not invent an export command or scan unrelated sessions. Otherwise write the messages still available in context and label the log `reconstructed; incomplete`. Never present a compaction summary as verbatim earlier messages.\n\nUse UTF-8 text with a header naming the agent, export time, source (native export or reconstructed), covered session and known omissions. Preserve user and assistant messages in chronological order, plus tool names, arguments and results when available. Keep each tool result to at most 16 KiB of text, marking truncation explicitly; describe image attachments by reference rather than embedding binary/base64 data, and mark references whose files are not uploaded. Exclude internal instructions, hidden reasoning, credentials and unrelated sensitive content; mark redactions without repeating the removed content. Refresh the current session's log rather than appending duplicate copies or silently carrying over a previous session.\n\nShow the user the exact file to review or redact and obtain approval to include it before deploying; do not ask again when they have already approved that file. If they decline, move it out of the project root before deployment so it cannot be collected. Deploy includes the file in the build's private source archive, downloadable by those authorized to download that build's sources, and leaves it out when extracting build inputs. A missing log warns but does not block deployment. The CLI does not export, redact or validate the transcript's completeness for you.\n\n`pnpm phoenix deploy` starts a build on the server and waits for it to go live. Right after `Build <id> started` it prints `Follow the build in Studio: <url>`. Run the deploy so that you can read its output while it runs, and open that link in the user's browser, quoted as above, as soon as it appears, so they can follow the build they just triggered. When the line is missing, the sign-in is older than the link: tell the user the build is listed under Deployments in Studio, and that `pnpm phoenix login <workspace>` brings the link back.\n\nWhen the deploy reports the configurator live, load the `phoenix-feedback` skill before you write your final message and follow its \"Evaluate the Run\" section, so the user is asked about the run while they are still there. It is asked once per conversation, and only once the user has nothing more to build.","## Code Review\nUse the `phoenix-review` skill to review code changes before committing.",t.sdkDocumentation]});
+import{renderAgentSkill as e}from"./agent-skill.js";import{sdkGuidanceSections as t}from"./sdk-content.js";export const followsCanaryBuilds=e=>!e.useWorkspace&&e.sdkVersion.includes("-develop.");export const generatePhoenixSkill=({checkLatestCanary:n})=>e({name:"phoenix",description:`Phoenix SDK project conventions, covering project structure, architecture principles, key patterns, file and export rules, webhook membership, versioning the domain model once it is deployed, showing the user the dev preview and the build of a deploy, the run evaluation that follows a live deploy, inspecting the rendered result, and how to search the SDK documentation${n?", and the internal-beta check for the latest canary SDK build":""}. Use before writing or changing specs or source code, or deploying this Phoenix configurator project.`,sections:[t.packageManager,...n?["## Stay on the Latest Canary\nDuring the internal beta this project uses the `canary` build of the SDK, which is published from every change to the platform. Once per conversation, before you change anything, compare the installed version, the `version` in `node_modules/@salsita-ai/sdk/package.json`, with the newest canary:\n```bash\nnpm view @salsita-ai/sdk@canary version\n```\nWhen they differ, tell the user which version you are moving to, then update the SDK, bring the packages it needs next to it in line, and regenerate the project's files:\n```bash\npnpm add @salsita-ai/sdk@canary && pnpm phoenix deps && pnpm install && pnpm phoenix sync\n```\n`sync` rewrites the Phoenix skills, so read the ones you use again after it. When the user runs a globally installed `phoenix`, update that too with `npm install -g @salsita-ai/sdk@canary`. If the project no longer builds after the update, stop and tell the user; the `phoenix-feedback` skill covers reporting it."]:[],t.projectStructure,t.architecturePrinciples,t.keyPatterns,t.fileConventions,t.exportRules,t.webhookMembership,t.doNotEdit,t.modelVersioning,"## Show the Preview While You Work\nThe user should see the configurator change as you build it. Before your first change in a conversation, make sure `pnpm phoenix dev` is running (start it in the background when it is not) and open the address it prints as `Preview: <url>` (also written to `.phoenix/phoenix-dev.log`) in the user's browser: `open '<url>'` on macOS, `xdg-open '<url>'` on Linux, `Start-Process '<url>'` in PowerShell, `start \"\" \"<url>\"` in cmd. Keep the quotes, the shell would otherwise read a `?` in the address as a pattern. The log keeps the lines of earlier runs, so when you have just started dev, wait for the `Preview:` line written after your start and use the last one. Open it once; the preview reloads on every change, so tell the user to keep that tab open instead of opening it again. A domain model change is the exception: `pnpm phoenix dev` registers the model with the server only when it starts, and after the change it logs an error that asks for a restart. Restart it, wait for the new `Preview:` line and open that address in place of the old tab, whose address carries the `?cid=` of a configuration saved with the earlier model, which the new model rejects.",t.visualInspection,"## Show the Build After a Deploy\nImmediately before invoking `pnpm phoenix deploy`, refresh `conversation.log` in the project root with the current conversation. Prefer the agent application's native session export when available; do not invent an export command or scan unrelated sessions. Otherwise write the messages still available in context and label the log `reconstructed; incomplete`. Never present a compaction summary as verbatim earlier messages.\n\nUse UTF-8 text with a header naming the agent, export time, source (native export or reconstructed), covered session and known omissions. Preserve user and assistant messages in chronological order, plus tool names, arguments and results when available. Keep each tool result to at most 16 KiB of text, marking truncation explicitly; describe image attachments by reference rather than embedding binary/base64 data, and mark references whose files are not uploaded. Exclude internal instructions, hidden reasoning, credentials and unrelated sensitive content; mark redactions without repeating the removed content. Refresh the current session's log rather than appending duplicate copies or silently carrying over a previous session.\n\nShow the user the exact file to review or redact and obtain approval to include it before deploying; do not ask again when they have already approved that file. If they decline, move it out of the project root before deployment so it cannot be collected. Deploy includes the file in the build's private source archive, downloadable by those authorized to download that build's sources, and leaves it out when extracting build inputs. A missing log warns but does not block deployment. The CLI does not export, redact or validate the transcript's completeness for you.\n\n`pnpm phoenix deploy` starts a build on the server and waits for it to go live. Right after `Build <id> started` it prints `Follow the build in Studio: <url>`. Run the deploy so that you can read its output while it runs, and open that link in the user's browser, quoted as above, as soon as it appears, so they can follow the build they just triggered. When the line is missing, the sign-in is older than the link: tell the user the build is listed under Deployments in Studio, and that `pnpm phoenix login <workspace>` brings the link back.\n\nWhen the deploy reports the configurator live, load the `phoenix-feedback` skill before you write your final message and follow its \"Evaluate the Run\" section, so the user is asked about the run while they are still there. It is asked once per conversation, and only once the user has nothing more to build.","## Code Review\nUse the `phoenix-review` skill to review code changes before committing.",t.sdkDocumentation]});

package/dist/application-spec/generate-application/implementations/phx-application-types.d.ts

@@ -0,0 +1,25 @@
+import { type EnumLike } from '#package/domain';
+import type { RuntimeSpec } from '../runtime-spec/index.js';
+/**
+ * The value of `phx.applicationTypes`: the application's version and published data hash, the JSON
+ * schemas of its data (`undefined` for data the spec leaves out), and its state enums.
+ */
+export interface PhxApplicationTypes {
+    readonly ApplicationVersion: string;
+    readonly PublishedDataHash: string;
+    readonly PublishedData: unknown;
+    readonly SessionData: unknown;
+    readonly FrontendData: unknown;
+    readonly BackendData: unknown;
+    readonly FinalizeData: unknown;
+    readonly PrefetchedFinalizeData: unknown;
+    readonly FinalizeResult: unknown;
+    readonly CallbackData: unknown;
+    readonly NavigationState: EnumLike<string>;
+    readonly ViewState: EnumLike<string>;
+    readonly ToolState: EnumLike<string>;
+    readonly ExportState: EnumLike<string>;
+    readonly AdminNavigationState: EnumLike<string>;
+}
+/** Builds `phx.applicationTypes` from the spec, with the values generated `domain-spec.ts` writes. */
+export declare const createPhxApplicationTypes: (spec: RuntimeSpec) => PhxApplicationTypes;

package/dist/application-spec/generate-application/implementations/phx-application-types.js

@@ -0,0 +1 @@
+import{EnumReflection as a}from"#package/domain";let t=(t,e)=>new a(t,{enum:[...e]});export const createPhxApplicationTypes=a=>{let{dataSchemas:e,states:i}=a.configurator;return{ApplicationVersion:a.appMetadata.applicationVersion,PublishedDataHash:e.publishedDataHash,PublishedData:e.publishedData.runtimeSchema,SessionData:e.sessionData.runtimeSchema,FrontendData:e.frontendData.runtimeSchema,BackendData:e.backendData?.runtimeSchema,FinalizeData:e.finalizeData.runtimeSchema,PrefetchedFinalizeData:e.prefetchedFinalizeData.runtimeSchema,FinalizeResult:e.finalizeResult.runtimeSchema,CallbackData:e.callbackData.runtimeSchema,NavigationState:t("NavigationState",i.navigationStates),ViewState:t("ViewState",i.viewStates),ToolState:t("ToolState",i.toolStates),ExportState:t("ExportState",i.exportStates),AdminNavigationState:t("AdminNavigationState",a.admin.states.navigationStates)}};

package/dist/application-spec/generate-application/implementations/phx-domain.d.ts

@@ -0,0 +1,36 @@
+import type { FactoryDataRuntime } from '../runtime/index.js';
+import type { PhxModel } from './phx-model.js';
+/**
+ * The value of `phx.domain`: the reflections and the factories project code writes its expressions,
+ * invariants, actions, components and recipes with, and the same for the admin domain under `admin`.
+ * The factories carry only the data the spec gives them (aliases, static violations, defaults); their
+ * types come from the project's `globals.d.ts`, which declares every member.
+ */
+export interface PhxDomain extends PhxModel {
+    readonly implementCustomExpressions: unknown;
+    readonly implementCustomInvariants: unknown;
+    readonly implementActions: unknown;
+    readonly createAssistantSetupHandler: unknown;
+    readonly attachComponent: unknown;
+    readonly createRecipe: unknown;
+    readonly admin: PhxModel & {
+        readonly implementCustomExpressions: unknown;
+        readonly implementCustomInvariants: unknown;
+        readonly attachComponent: unknown;
+        readonly createMapPublishedRevisionDataHandler: unknown;
+        readonly createMapPublishedChunkedDataHandler: unknown;
+        readonly createDataRowValidatorHandler: unknown;
+        readonly createSheetValidatorHandler: unknown;
+        readonly createRecipe: unknown;
+    };
+}
+interface PhxDomainInput {
+    readonly model: PhxModel;
+    readonly factoryData: FactoryDataRuntime;
+}
+/**
+ * Builds `phx.domain` from the reflections and the factory data of both domains, with the same
+ * factories and the same data generated `domain-spec.ts` passes them.
+ */
+export declare const createPhxDomain: (configurator: PhxDomainInput, admin: PhxDomainInput) => PhxDomain;
+export {};

package/dist/application-spec/generate-application/implementations/phx-domain.js

@@ -0,0 +1 @@
+import{DomainComponentOpticBuilder as a,createActionFactory as t,createAssistantSetupHandlerFactory as e,createCustomExpressionFactory as o,createCustomInvariantFactory as i,createDataRowValidatorHandler as s,createMapPublishedChunkedDataHandlerFactory as n,createMapPublishedRevisionDataHandlerFactory as m,createRecipeFactory as r,createSheetValidatorHandler as c}from"#package/domain";let l=a=>r(a.aliases,a.entityReflections,a.defaults);export const createPhxDomain=(r,p)=>({...r.model,implementCustomExpressions:o(),implementCustomInvariants:i()(r.factoryData.staticViolations),implementActions:t(),createAssistantSetupHandler:e(),attachComponent:a.from(r.factoryData.aliases),createRecipe:l(r.factoryData),admin:{...p.model,implementCustomExpressions:o(),implementCustomInvariants:i()(p.factoryData.staticViolations),attachComponent:a.from(p.factoryData.aliases),createMapPublishedRevisionDataHandler:m(),createMapPublishedChunkedDataHandler:n(),createDataRowValidatorHandler:s,createSheetValidatorHandler:c,createRecipe:l(p.factoryData)}});

package/dist/application-spec/generate-application/implementations/phx-model.d.ts

@@ -0,0 +1,24 @@
+import type { Expressions } from '../../parse-application-files/index.js';
+import type { RuntimeLatestModelVersion } from '../runtime-spec/index.js';
+import type { AdminModelRuntime, ConfiguratorModelRuntime, SpecCodeMap } from '../runtime/index.js';
+/**
+ * The reflections of one domain that project code reads from `phx.domain` (or `phx.domain.admin`):
+ * `model` holds the entity, alias, common type and shape reflections, `enhancedModel` the enhanced
+ * reflection of every entity and alias, named `$<Name>`.
+ */
+export interface PhxModel {
+    readonly model: Readonly<Record<string, unknown>>;
+    readonly enhancedModel: Readonly<Record<string, unknown>>;
+}
+interface PhxModelSpec {
+    readonly latestModel: RuntimeLatestModelVersion;
+    readonly expressions: Expressions;
+}
+/**
+ * Builds the reflections of one domain from its runtime spec and its model runtime. The entity and
+ * alias reflections and the enhanced entity reflections are the model runtime's own, so the domain
+ * built from the same model runtime validates with the same objects; common types, shapes and
+ * enhanced aliases are built here, in the order generated code lists them.
+ */
+export declare const createPhxModel: (domainSpec: PhxModelSpec, modelRuntime: ConfiguratorModelRuntime | AdminModelRuntime, code: SpecCodeMap | undefined) => PhxModel;
+export {};

package/dist/application-spec/generate-application/implementations/phx-model.js

@@ -0,0 +1 @@
+import{EnhancedAliasReflection as e,EnumReflection as t,SchemaReflection as n}from"#package/domain";import{evaluateReflectionConstants as o}from"../runtime/index.js";let r=e=>e,i=(e,o,i)=>{let l,s=r(i);return void 0!==(l=o.enum)&&l.length>0&&l.every(e=>"string"==typeof e)?new t(e,{...s,enum:[...o.enum]}):new n(e,s)};export const createPhxModel=(t,l,s)=>{let a={...l.entities,...l.aliasReflections};for(let[e,n]of t.latestModel.commonTypes)a[String(e)]=i(String(e),n.schema,n.runtimeSchema);for(let e of t.latestModel.shapes.values()){let t=`${String(e.name)}Shape`;a[t]=new n(t,r(e.runtimeSchema))}let m={};for(let[e,t]of Object.entries(l.$entityReflections))m[`$${e}`]=t;for(let[n,r]of t.latestModel.aliases){let i=String(n);m[`$${i}`]=new e(`$${i}`,r.map(String),o(t.expressions,i,s))}return{model:a,enhancedModel:m}};

package/dist/application-spec/generate-application/implementations/phx.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeReferenceStore } from '../../caching/index.js';
+import type { RuntimeSpec } from '../runtime-spec/index.js';
+import { type SpecCodeModule } from '../runtime/index.js';
+import { type PhxApplicationTypes } from './phx-application-types.js';
+import { type PhxDomain } from './phx-domain.js';
+/** The `phx` values an application's project modules read while they load. */
+export interface Phx {
+    readonly domain: PhxDomain;
+    readonly applicationTypes: PhxApplicationTypes;
+}
+/**
+ * Builds the values of `phx.domain` and `phx.applicationTypes` from an application's runtime spec
+ * (`.phoenix/application-spec.json`, decoded with `decodeRuntimeSpec`) and its generated code module
+ * (`.phoenix/spec-code.ts`): the model reflections of both domains, and the factories with the
+ * static violations, aliases and defaults of the spec.
+ *
+ * It builds the spec's sections in `referenceStore`. The application's `ApplicationRuntime` is
+ * built later in the same store, so `phx.domain.model` holds the reflections the application's
+ * domain validates with. It assigns nothing: the generated entry assigns `phx` before it imports
+ * the project's modules, because a development server renames the global in project files only.
+ */
+export declare const createPhx: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore, specCode?: SpecCodeModule) => Phx;

package/dist/application-spec/generate-application/implementations/phx.js

@@ -0,0 +1 @@
+import{SpecRuntime as o}from"../runtime/index.js";import{createPhxApplicationTypes as t}from"./phx-application-types.js";import{createPhxDomain as a}from"./phx-domain.js";import{createPhxModel as m}from"./phx-model.js";export const createPhx=(r,i,e)=>{let{configurator:n,admin:p}=o(r,i,e);return{domain:a({model:m(r.configurator,n.modelRuntime,e?.configurator),factoryData:n.factoryDataRuntime},{model:m(r.admin,p.modelRuntime,e?.admin),factoryData:p.factoryDataRuntime}),applicationTypes:t(r)}};

package/dist/application-spec/generate-application/index.d.ts

@@ -1,5 +1,7 @@
 export * from './runtime/sections/index.js';
 export * from './runtime/application-runtime.js';
+export { applicationSpecSlice, type ApplicationSpecSliceModules } from './runtime/application-spec-slice.js';
+export { type ApplicationModules, createApplication } from './runtime/create-application.js';
 export * from './runtime/factory-data/index.js';
 export * from './runtime/migrations/index.js';
 export { isConfiguratorModelSchemaCompatible } from './runtime/configurator-runtime/configurator-model-runtime.js';

package/dist/application-spec/generate-application/index.js

@@ -1 +1 @@
-export*from"./runtime/sections/index.js";export*from"./runtime/application-runtime.js";export*from"./runtime/factory-data/index.js";export*from"./runtime/migrations/index.js";export{isConfiguratorModelSchemaCompatible}from"./runtime/configurator-runtime/configurator-model-runtime.js";export*from"./code/index.js";export{generateRuntimeInstance}from"./runtime/generate-runtime-instance.js";
+export*from"./runtime/sections/index.js";export*from"./runtime/application-runtime.js";export{applicationSpecSlice}from"./runtime/application-spec-slice.js";export{createApplication}from"./runtime/create-application.js";export*from"./runtime/factory-data/index.js";export*from"./runtime/migrations/index.js";export{isConfiguratorModelSchemaCompatible}from"./runtime/configurator-runtime/configurator-model-runtime.js";export*from"./code/index.js";export{generateRuntimeInstance}from"./runtime/generate-runtime-instance.js";

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-model-runtime.d.ts

@@ -1,8 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
 import { type $DomainEntity, $DomainEntityReflection, DomainBuilder, type DomainEntity, DomainEntityReflection, RawAliasReflection, SchemaReflection } from '#package/domain';
 import type { RuntimeReferenceStore } from '../../../caching/index.js';
-import type { DataSchemas, Expressions } from '../../../parse-application-files/index.js';
-import type { RuntimeModelVersion, RuntimeResolvedVersions } from '../../runtime-spec/index.js';
+import type { Expressions } from '../../../parse-application-files/index.js';
+import type { RuntimeDataSchemas, RuntimeModelVersion, RuntimeResolvedVersions } from '../../runtime-spec/index.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
 type AnyEntity = DomainEntity<string>;
 type AnyAliases = Record<string, AnyEntity>;
@@ -26,5 +26,5 @@ interface AdminModelRuntimeFields {
     readonly schemaChanged: boolean;
 }
 export type AdminModelRuntime = Branded<'AdminModelRuntime', AdminModelRuntimeFields>;
-export declare const AdminModelRuntime: (domainSpec: AdminModelRuntimeSpec, dataSchemas: DataSchemas, referenceStore: RuntimeReferenceStore, code: SpecCodeMap | undefined) => AdminModelRuntime;
+export declare const AdminModelRuntime: (domainSpec: AdminModelRuntimeSpec, dataSchemas: RuntimeDataSchemas, referenceStore: RuntimeReferenceStore, code: SpecCodeMap | undefined) => AdminModelRuntime;
 export {};

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-runtime.d.ts

@@ -2,13 +2,13 @@ import { Branded } from '@salsita-ai/common/utils';
 import { type ImplementationErrorCollector, type ProjectModule } from '#package/domain';
 import type { RuntimeReferenceStore } from '../../../caching/index.js';
 import type { RuntimeSpec } from '../../runtime-spec/index.js';
-import { FactoryDataRuntime } from '../factory-data/index.js';
+import type { FactoryDataRuntime } from '../factory-data/index.js';
 import { type MigrationModules, MigrationRuntime } from '../migrations/index.js';
 import { ComponentOptics } from '../sections/component-optic.js';
 import { ExpressionRuntime, type InvariantImplementations, type MissingExpression } from '../sections/expression-runtime.js';
 import { PresetRuntime } from '../sections/preset-runtime.js';
 import type { SpecCodeMap } from '../spec-code/index.js';
-import { AdminModelRuntime } from './admin-model-runtime.js';
+import type { AdminModelRuntime } from './admin-model-runtime.js';
 import { AdminStatesRuntime } from './states-runtime.js';
 export type AdminRuntime = Branded<'AdminRuntime', {
     readonly modelRuntime: AdminModelRuntime;
@@ -25,5 +25,7 @@ export type AdminRuntimeResult = {
 } | {
     readonly ok: false;
     readonly missingExpressions: readonly MissingExpression[];
+    /** The migrations the migration modules do not export, as `migrationRuntime.missingMigrations` lists them. */
+    readonly missingMigrations: readonly string[];
 };
 export declare const AdminRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore, expressionModules: readonly ProjectModule[], invariantImplementations: InvariantImplementations, migrationModules: MigrationModules, code: SpecCodeMap | undefined, errors: ImplementationErrorCollector) => AdminRuntimeResult;

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-runtime.js

@@ -1 +1 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{Preset as t,PresetCategory as i,commonAdminCustomExpressions as n,commonAdminViolationExpressions as r}from"#package/domain";import{FactoryDataRuntime as s}from"../factory-data/index.js";import{MigrationRuntime as o}from"../migrations/index.js";import{ComponentOptics as m}from"../sections/component-optic.js";import{ExpressionRuntime as a}from"../sections/expression-runtime.js";import{PresetRuntime as p}from"../sections/preset-runtime.js";import{AdminModelRuntime as u}from"./admin-model-runtime.js";import{AdminStatesRuntime as f}from"./states-runtime.js";let c={Preset:[{evaluate:(e,i,n)=>{let s=n.domain.get$Entity(e,i);return t.assert(s),r.Preset.nameNotEmpty(s)}}]},d={PresetCategory:{$isDraft:{origin:{name:"$isDraft",typeOrAlias:"PresetCategory"},evaluate:(e,t,r)=>{let s=r.domain.get$Entity(e,t);return i.assert(s),n.PresetCategory.$isDraft(s)},meta:{}}}},l=new WeakMap;export const AdminRuntime=(t,i,n,r,g,R,y)=>{let j=u(t.admin,t.configurator.dataSchemas,i,R),k=a(t.admin,i,n,"adminExpressionRuntime",((e,t)=>{if(0===Object.keys(e).length)return c;let i=l.get(t)??new WeakMap;l.set(t,i);let n=i.get(e);if(n)return n;let r={};for(let i of[c,e])for(let[e,n]of Object.entries(i))for(let i of t[e]??[e])r[i]=[...r[i]??[],...n];return i.set(e,r),r})(r,j.aliases),R,y,d);return k.ok?{ok:!0,runtime:e({modelRuntime:j,componentOptics:m(i,{components:t.admin.components,referenceScope:"adminRuntime/componentOptics",modelRuntime:j,code:R}),expressionRuntime:k.runtime,presetRuntime:p(i,{referenceScope:"adminRuntime/presetRuntime",presets:t.admin.presets.presets}),statesRuntime:f(t,i),migrationRuntime:o(i,{referenceScope:"adminRuntime/migrationRuntime",resolvedVersions:t.admin.resolvedVersions,latestEntities:j.entities,migrationModules:g}),factoryDataRuntime:s(i,{referenceScope:"adminRuntime/factoryDataRuntime",invariants:t.admin.invariants,defaults:t.admin.defaults,aliases:j.aliases,entities:j.entities})})}:{ok:!1,missingExpressions:k.missing}};
+import{Branded as e}from"@salsita-ai/common/utils";import{Preset as t,PresetCategory as i,commonAdminCustomExpressions as s,commonAdminViolationExpressions as n}from"#package/domain";import{MigrationRuntime as r}from"../migrations/index.js";import{ComponentOptics as o}from"../sections/component-optic.js";import{ExpressionRuntime as m}from"../sections/expression-runtime.js";import{PresetRuntime as a}from"../sections/preset-runtime.js";import{AdminSpecRuntime as p}from"./admin-spec-runtime.js";import{AdminStatesRuntime as u}from"./states-runtime.js";let c={Preset:[{evaluate:(e,i,s)=>{let r=s.domain.get$Entity(e,i);return t.assert(r),n.Preset.nameNotEmpty(r)}}]},f={PresetCategory:{$isDraft:{origin:{name:"$isDraft",typeOrAlias:"PresetCategory"},evaluate:(e,t,n)=>{let r=n.domain.get$Entity(e,t);return i.assert(r),s.PresetCategory.$isDraft(r)},meta:{}}}},l=new WeakMap;export const AdminRuntime=(t,i,s,n,g,d,R)=>{let{modelRuntime:j,factoryDataRuntime:y}=p(t,i,d),k=m(t.admin,i,s,"adminExpressionRuntime",((e,t)=>{if(0===Object.keys(e).length)return c;let i=l.get(t)??new WeakMap;l.set(t,i);let s=i.get(e);if(s)return s;let n={};for(let i of[c,e])for(let[e,s]of Object.entries(i))for(let i of t[e]??[e])n[i]=[...n[i]??[],...s];return i.set(e,n),n})(n,j.aliases),d,R,f),x=r(i,{referenceScope:"adminRuntime/migrationRuntime",resolvedVersions:t.admin.resolvedVersions,latestEntities:j.entities,migrationModules:g});return k.ok?{ok:!0,runtime:e({modelRuntime:j,componentOptics:o(i,{components:t.admin.components,referenceScope:"adminRuntime/componentOptics",modelRuntime:j,code:d}),expressionRuntime:k.runtime,presetRuntime:a(i,{referenceScope:"adminRuntime/presetRuntime",presets:t.admin.presets.presets}),statesRuntime:u(t,i),migrationRuntime:x,factoryDataRuntime:y})}:{ok:!1,missingExpressions:k.missing,missingMigrations:x.missingMigrations}};

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-spec-runtime.d.ts

@@ -0,0 +1,16 @@
+import { Branded } from '@salsita-ai/common/utils';
+import type { RuntimeReferenceStore } from '../../../caching/index.js';
+import type { RuntimeSpec } from '../../runtime-spec/index.js';
+import { FactoryDataRuntime } from '../factory-data/index.js';
+import type { SpecCodeMap } from '../spec-code/index.js';
+import { AdminModelRuntime } from './admin-model-runtime.js';
+/**
+ * The sections of the admin domain that the spec alone determines: its model and the data of its
+ * `phx.domain.admin` factories. `AdminRuntime` builds its own from this function, so a build of
+ * either in the same reference store returns the same objects.
+ */
+export type AdminSpecRuntime = Branded<'AdminSpecRuntime', {
+    readonly modelRuntime: AdminModelRuntime;
+    readonly factoryDataRuntime: FactoryDataRuntime;
+}>;
+export declare const AdminSpecRuntime: (spec: RuntimeSpec, referenceStore: RuntimeReferenceStore, code: SpecCodeMap | undefined) => AdminSpecRuntime;

package/dist/application-spec/generate-application/runtime/admin-runtime/admin-spec-runtime.js

@@ -0,0 +1 @@
+import{Branded as a}from"@salsita-ai/common/utils";import{FactoryDataRuntime as t}from"../factory-data/index.js";import{AdminModelRuntime as i}from"./admin-model-runtime.js";export const AdminSpecRuntime=(e,n,m)=>{let r=i(e.admin,e.configurator.dataSchemas,n,m);return a({modelRuntime:r,factoryDataRuntime:t(n,{referenceScope:"adminRuntime/factoryDataRuntime",invariants:e.admin.invariants,defaults:e.admin.defaults,aliases:r.aliases,entities:r.entities})})};