@wairon/cli 5.1.1-dev.16 → 5.1.1-dev.17

package/dist/index.js

@@ -1092,7 +1092,7 @@ var init_defaults = __esm({
       copilot: ".github/prompts",
       codex: ".codex/agents"
     };
-    WAIRON_VERSION = "5.1.1-dev.16";
+    WAIRON_VERSION = "5.1.1-dev.17";
     GITHUB_REPO = "SYW-Apps/Waffle-AIron";
     ARCHITECT_AGENT_ID = "agent-architect";
     ARCHITECT_TEMPLATE_ID = "architect";
@@ -1406,7 +1406,7 @@ function defaultNarrativeDetail(component) {
   if (componentType === "Portal" || componentType === "Observer" || componentType === "Adapter") {
     return "calls-only";
   }
-  if (componentType === "Store" || componentType === "Index" || componentType === "Registry") {
+  if (componentType === "Store" || componentType === "Index" || componentType === "Query" || componentType === "Registry") {
     return "intent";
   }
   return "full";
@@ -1414,6 +1414,17 @@ function defaultNarrativeDetail(component) {
 function isPattern(component) {
   return PATTERN_TYPES.has(component.componentType);
 }
+function isLogic(component) {
+  const componentType = component.componentType;
+  return componentType === "Orchestrator" || componentType === "Supervisor" || componentType === "Actor" || componentType === "Specialist";
+}
+function holdsState(component) {
+  const componentType = component.componentType;
+  return componentType === "Store" || componentType === "Index" || componentType === "Supervisor" || componentType === "Actor";
+}
+function isRetired(component) {
+  return RETIRED_STEREOTYPES.has(component.componentType);
+}
 function passesIntentFloor(text, methodName) {
   if (!text) return false;
   const t = text.trim();
@@ -1439,7 +1450,7 @@ function implementationSourceFiles(impl) {
   for (const method of impl.methods ?? []) add(method.sourcePath);
   return files;
 }
-var import_zod8, SpecIdSchema, SpecStatusSchema, BoundaryItemSchema, RequirementItemSchema, DatabaseSpecSchema, DiagramConfigSchema, SURFACE_AUDIENCES, SurfaceAudienceSchema, SystemPublicInterfaceSchema, SystemSpecSchema, PublicInterfaceTypeSchema, PublicInterfaceSchema, TrustedLinkSchema, LintAllowSchema, LintConfigSchema, ExtDataSchema, LifecycleEntrypointSchema, SubsystemSpecSchema, ComponentTypeSchema, PATTERN_TYPES, PortalTypeSchema, DispatchBindingSchema, DurabilitySchema, PatternRefSchema, EventBindingSchema, ExternalLinkTypeSchema, ExternalLinkSchema, PortalAuthSchemeSchema, PortalAuthSchema, ComponentSpecSchema, HttpMethodSchema, TransportSchema, EndpointSchema, SEMANTIC_GUARANTEES, GuaranteeSchema, MethodParamSchema, FindingDeclarationSchema, MethodSignatureSchema, INTENT_FLOOR_MIN_CHARS, InterfaceSpecSchema, NarrativeStepTypeSchema, LoopKindSchema, SwitchCaseSchema, CatchClauseSchema, ParallelBranchSchema, NarrativeStepSchema, NarrativeDetailSchema, ConformanceTierSchema, MethodImplementationSchema, ImplementationSpecSchema, TypeKindSchema, TypeFieldSchema, TypeMethodSchema, InvariantSchema, TypeSpecSchema, SurfaceOriginSchema, SurfaceTypeDefSchema, SurfaceContractEntrySchema, SurfaceSnapshotSchema, NamedOpenApiSpecSchema, GroupSpecSchema;
+var import_zod8, SpecIdSchema, SpecStatusSchema, BoundaryItemSchema, RequirementItemSchema, DatabaseSpecSchema, DiagramConfigSchema, SURFACE_AUDIENCES, SurfaceAudienceSchema, SystemPublicInterfaceSchema, SystemSpecSchema, PublicInterfaceTypeSchema, PublicInterfaceSchema, TrustedLinkSchema, LintAllowSchema, LintConfigSchema, ExtDataSchema, LifecycleEntrypointSchema, SubsystemSpecSchema, ComponentTypeSchema, PATTERN_TYPES, RETIRED_STEREOTYPES, PortalTypeSchema, DispatchBindingSchema, DurabilitySchema, DependencyClassSchema, PatternRefSchema, EventBindingSchema, ExternalLinkTypeSchema, ExternalLinkSchema, PortalAuthSchemeSchema, PortalAuthSchema, ComponentSpecSchema, HttpMethodSchema, TransportSchema, EndpointSchema, SEMANTIC_GUARANTEES, GuaranteeSchema, MethodParamSchema, FindingDeclarationSchema, MethodSignatureSchema, INTENT_FLOOR_MIN_CHARS, InterfaceSpecSchema, NarrativeStepTypeSchema, LoopKindSchema, SwitchCaseSchema, CatchClauseSchema, ParallelBranchSchema, NarrativeStepSchema, NarrativeDetailSchema, ConformanceTierSchema, MethodImplementationSchema, ImplementationSpecSchema, TypeKindSchema, TypeFieldSchema, TypeMethodSchema, InvariantSchema, TypeSpecSchema, SurfaceOriginSchema, SurfaceTypeDefSchema, SurfaceContractEntrySchema, SurfaceSnapshotSchema, NamedOpenApiSpecSchema, GroupSpecSchema;
 var init_specs = __esm({
   "src/models/specs.ts"() {
     "use strict";
@@ -1605,21 +1616,28 @@ var init_specs = __esm({
       "Actor",
       "Store",
       "Index",
+      "Query",
+      // Repository member for computed reads over its Store
       "Registry",
       "Adapter",
       "Observer",
-      "Specialist",
       "View",
       // Pure presenter/UI component
       // Patterns (compositions of blocks)
       "Repository",
-      "Gateway",
       "FeatureComponent",
       // Logic Hook + View Presenter pattern
-      "RouterComponent"
+      "RouterComponent",
       // Switch/routing component pattern
+      // Retired stereotypes: still parsed so a tree using them loads and the
+      // rules can report them (STEREOTYPE_RETIRED), never authored new
+      "Specialist",
+      // logic is an Orchestrator with a dependencyClass
+      "Gateway"
+      // a gateway is a Portal with the gateway variant
     ]);
-    PATTERN_TYPES = /* @__PURE__ */ new Set(["Repository", "Gateway", "FeatureComponent", "RouterComponent"]);
+    PATTERN_TYPES = /* @__PURE__ */ new Set(["Repository", "FeatureComponent", "RouterComponent"]);
+    RETIRED_STEREOTYPES = /* @__PURE__ */ new Set(["Specialist", "Gateway"]);
     PortalTypeSchema = import_zod8.z.enum(["HTTP_API", "gRPC", "GraphQL", "MessageBus", "CLI", "NamedPipe", "IPC", "Custom"]);
     DispatchBindingSchema = import_zod8.z.object({
       /** Capability name exactly as dispatched at runtime (e.g. "shadow_module.get"). */
@@ -1632,6 +1650,7 @@ var init_specs = __esm({
       description: import_zod8.z.string().optional()
     });
     DurabilitySchema = import_zod8.z.enum(["ram-projection", "durable", "read-through", "cache"]);
+    DependencyClassSchema = import_zod8.z.enum(["pure", "read"]);
     PatternRefSchema = import_zod8.z.object({
       id: import_zod8.z.string(),
       version: import_zod8.z.string().optional()
@@ -1686,6 +1705,8 @@ var init_specs = __esm({
       dispatch: import_zod8.z.array(DispatchBindingSchema).optional(),
       /** Store-only: whether held state survives restart (see DurabilitySchema). */
       durability: DurabilitySchema.optional(),
+      /** Orchestrator-only: what the logic may depend on; unset means a workflow (see DependencyClassSchema). */
+      dependencyClass: DependencyClassSchema.optional(),
       /** Topics this component publishes to (see EventBindingSchema). */
       emits: import_zod8.z.array(EventBindingSchema).optional(),
       /** Topics this component consumes (see EventBindingSchema) — typical on Observers. */
@@ -1776,9 +1797,10 @@ var init_specs = __esm({
       }).optional(),
       /**
        * The finding codes this method can report, each with its default severity
-       * and summary (see FindingDeclarationSchema). Each declared code must appear
-       * as a string literal in the method's source file (UNREALIZED_FINDING). A
-       * code is declared once per method.
+       * and summary (see FindingDeclarationSchema). Each declared code must be
+       * anchored in the method's source file as a string literal or a
+       * property-access name (UNREALIZED_FINDING). A code is declared once per
+       * method.
        */
       findings: import_zod8.z.array(FindingDeclarationSchema).superRefine((findings, ctx) => {
         const seen = /* @__PURE__ */ new Set();
@@ -14259,28 +14281,52 @@ var init_candidate = __esm({
 function globalVariantsDir() {
   return process.env.WAIRON_VARIANTS_DIR ?? path12.join(os3.homedir(), ".wairon", "variants");
 }
-function readVariantsDir(dir) {
+function builtinVariantsDir() {
+  const candidates = [
+    path12.resolve(__dirname, "..", "templates", "variants"),
+    // src/core & dist/cli
+    path12.resolve(__dirname, "templates", "variants")
+    // dist (library entry)
+  ];
+  return candidates.find((dir) => fs9.existsSync(dir)) ?? candidates[0];
+}
+function projectVariantsDir() {
+  return path12.join(getProjectRoot(), ".wai", "variants");
+}
+function variantFiles(dir) {
   let entries;
   try {
     entries = fs9.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
+  return entries.filter((e) => e.isFile() && /\.ya?ml$/i.test(e.name)).sort((a, b) => a.name.localeCompare(b.name)).map((e) => path12.join(dir, e.name));
+}
+function parseVariants(raw) {
+  if (raw == null) return [];
+  return (Array.isArray(raw) ? raw : [raw]).map((item) => VariantDefSchema.parse(item));
+}
+function reportSkippedFile(file, err) {
+  console.error(`[variants] skipped "${file}": ${err instanceof Error ? err.message : String(err)}`);
+}
+function readVariantsDir(dir) {
   const out = [];
-  for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    if (!e.isFile() || !/\.ya?ml$/i.test(e.name)) continue;
-    const full = path12.join(dir, e.name);
+  for (const file of variantFiles(dir)) {
     try {
-      const raw = readYamlFile(full);
-      if (raw == null) continue;
-      const items = Array.isArray(raw) ? raw : [raw];
-      for (const item of items) out.push(VariantDefSchema.parse(item));
+      out.push(...parseVariants(readYamlFile(file)));
     } catch (err) {
-      console.error(`[variants] skipped "${full}": ${err instanceof Error ? err.message : String(err)}`);
+      reportSkippedFile(file, err);
     }
   }
   return out;
 }
+function mergeById(...layers) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const layer of layers) {
+    for (const v of layer) byId.set(v.id, v);
+  }
+  return [...byId.values()];
+}
 function resolveVariantGuidance(component, allComponents, variantsById) {
   if (!component.variant) return null;
   const def = variantsById.get(component.variant);
@@ -14314,14 +14360,55 @@ function composeVariantGuidance(comps, allComponents, variantsById) {
 }
 function loadProjectVariants() {
   try {
-    const byId = /* @__PURE__ */ new Map();
-    for (const v of readVariantsDir(globalVariantsDir())) byId.set(v.id, v);
-    for (const v of readVariantsDir(path12.join(getProjectRoot(), ".wai", "variants"))) byId.set(v.id, v);
-    return [...byId.values()];
+    return mergeById(
+      readVariantsDir(builtinVariantsDir()),
+      readVariantsDir(globalVariantsDir()),
+      readVariantsDir(projectVariantsDir())
+    );
   } catch {
     return [];
   }
 }
+function listProjectVariants() {
+  return mergeById(readVariantsDir(projectVariantsDir()));
+}
+function rebaseProjectVariants(fromBase, toBase) {
+  const rebased = [];
+  for (const file of variantFiles(projectVariantsDir())) {
+    const content = readFileOrNull(file);
+    if (content === null) continue;
+    let raw;
+    let variants;
+    try {
+      raw = parseYaml(content, file);
+      variants = parseVariants(raw);
+    } catch (err) {
+      reportSkippedFile(file, err);
+      continue;
+    }
+    const matching = variants.filter((v) => v.base === fromBase);
+    if (matching.length === 0) continue;
+    writeFile(file, rebasedText(content, fromBase, toBase, withRebasedEntries(raw, fromBase, toBase)));
+    for (const v of matching) {
+      if (!rebased.includes(v.id)) rebased.push(v.id);
+    }
+  }
+  return rebased;
+}
+function withRebasedEntries(raw, fromBase, toBase) {
+  const rebase = (entry) => entry.base === fromBase ? { ...entry, base: toBase } : entry;
+  return Array.isArray(raw) ? raw.map(rebase) : rebase(raw);
+}
+function rebasedText(content, fromBase, toBase, rebasedContent) {
+  const escaped = fromBase.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const baseLine = new RegExp(`^([ \\t]*(?:-[ \\t]+)?base:[ \\t]*)(["']?)${escaped}\\2(?=[ \\t]*(?:#.*)?$)`, "gm");
+  const edited = content.replace(baseLine, (_line, key, quote) => `${key}${quote}${toBase}${quote}`);
+  try {
+    if (JSON.stringify(parseYaml(edited)) === JSON.stringify(rebasedContent)) return edited;
+  } catch {
+  }
+  return serializeYaml(rebasedContent);
+}
 var fs9, os3, path12, import_zod10, VariantDefSchema;
 var init_variants = __esm({
   "src/core/variants.ts"() {
@@ -14335,7 +14422,7 @@ var init_variants = __esm({
     VariantDefSchema = import_zod10.z.object({
       /** Variant id referenced by a component's `variant` (e.g. "publisher", "org/external-config-adapter"). */
       id: import_zod10.z.string().min(1),
-      /** The core stereotype this variant specializes — authoritative for generic semantics (Adapter, Specialist, …). */
+      /** The core stereotype this variant specializes — authoritative for generic semantics (Adapter, Orchestrator, …). */
       base: import_zod10.z.string().min(1),
       /** How to implement a component of this variant — the recipe the implementer follows and reuses across same-variant components. */
       guidance: import_zod10.z.string().min(1),
@@ -23565,6 +23652,7 @@ __export(src_exports, {
   DEFAULT_TARGET_DIRS: () => DEFAULT_TARGET_DIRS,
   DatabaseSpecSchema: () => DatabaseSpecSchema,
   DeclarativePackSchema: () => DeclarativePackSchema,
+  DependencyClassSchema: () => DependencyClassSchema,
   DesignDepthSchema: () => DesignDepthSchema,
   DiagramConfigSchema: () => DiagramConfigSchema,
   DispatchBindingSchema: () => DispatchBindingSchema,
@@ -23622,6 +23710,7 @@ __export(src_exports, {
   ProjectProfileSelectionSchema: () => ProjectProfileSelectionSchema,
   PublicInterfaceSchema: () => PublicInterfaceSchema,
   PublicInterfaceTypeSchema: () => PublicInterfaceTypeSchema,
+  RETIRED_STEREOTYPES: () => RETIRED_STEREOTYPES,
   RegistrySchema: () => RegistrySchema,
   RequirementItemSchema: () => RequirementItemSchema,
   RulesConfigSchema: () => RulesConfigSchema,
@@ -23772,6 +23861,7 @@ __export(src_exports, {
   hasContext: () => hasContext,
   hasSpecTree: () => hasSpecTree,
   hashGateState: () => hashGateState,
+  holdsState: () => holdsState,
   implementationSourceFiles: () => implementationSourceFiles,
   importSpecTree: () => importSpecTree,
   importSurface: () => importSurface,
@@ -23782,10 +23872,12 @@ __export(src_exports, {
   internalizeSubsystem: () => internalizeSubsystem,
   invalidateSpecCache: () => invalidateSpecCache,
   isDraftSubsystem: () => isDraftSubsystem,
+  isLogic: () => isLogic,
   isOpenApiDocument: () => isOpenApiDocument,
   isPattern: () => isPattern,
   isProjectInitialized: () => isProjectInitialized,
   isProvidedBy: () => isProvidedBy,
+  isRetired: () => isRetired,
   listChainedRoots: () => listChainedRoots,
   listDirectChainedSubprojects: () => listDirectChainedSubprojects,
   listExternalInterfaces: () => listExternalInterfaces,
@@ -23794,6 +23886,7 @@ __export(src_exports, {
   listFreeStandingDomains: () => listFreeStandingDomains,
   listInstalledPacks: () => listInstalledPacks,
   listMountSnapshots: () => listMountSnapshots,
+  listProjectVariants: () => listProjectVariants,
   listResources: () => listResources,
   listRules: () => listRules2,
   listSkillNames: () => listSkillNames,
@@ -23864,6 +23957,7 @@ __export(src_exports, {
   readResource: () => readResource,
   readSkillResource: () => readSkillResource,
   readYamlFile: () => readYamlFile,
+  rebaseProjectVariants: () => rebaseProjectVariants,
   rebaseReference: () => rebaseReference,
   recordProfileSelection: () => recordProfileSelection,
   registerExporter: () => registerExporter,
@@ -24271,6 +24365,7 @@ function loadProjectConfig4() {
   DEFAULT_TARGET_DIRS,
   DatabaseSpecSchema,
   DeclarativePackSchema,
+  DependencyClassSchema,
   DesignDepthSchema,
   DiagramConfigSchema,
   DispatchBindingSchema,
@@ -24328,6 +24423,7 @@ function loadProjectConfig4() {
   ProjectProfileSelectionSchema,
   PublicInterfaceSchema,
   PublicInterfaceTypeSchema,
+  RETIRED_STEREOTYPES,
   RegistrySchema,
   RequirementItemSchema,
   RulesConfigSchema,
@@ -24478,6 +24574,7 @@ function loadProjectConfig4() {
   hasContext,
   hasSpecTree,
   hashGateState,
+  holdsState,
   implementationSourceFiles,
   importSpecTree,
   importSurface,
@@ -24488,10 +24585,12 @@ function loadProjectConfig4() {
   internalizeSubsystem,
   invalidateSpecCache,
   isDraftSubsystem,
+  isLogic,
   isOpenApiDocument,
   isPattern,
   isProjectInitialized,
   isProvidedBy,
+  isRetired,
   listChainedRoots,
   listDirectChainedSubprojects,
   listExternalInterfaces,
@@ -24500,6 +24599,7 @@ function loadProjectConfig4() {
   listFreeStandingDomains,
   listInstalledPacks,
   listMountSnapshots,
+  listProjectVariants,
   listResources,
   listRules,
   listSkillNames,
@@ -24570,6 +24670,7 @@ function loadProjectConfig4() {
   readResource,
   readSkillResource,
   readYamlFile,
+  rebaseProjectVariants,
   rebaseReference,
   recordProfileSelection,
   registerExporter,