ente-cli 0.4.97 → 0.4.98

package/dist/SKILL.md

@@ -162,10 +162,10 @@ ente query "QM system export" [--space <name>] [--entity <name>] [--since <epoch
 # Entities
 ente entity list [--query <text>] [--type person|org|project|topic|place|object] [--space <name>] [--limit <count>] [--projection compact|full] [--archived] [--json]
 ente entity create "Jane Doe" --type person [--pin "Acme Corp"] [--share-parents --parent-space-grant-fingerprint <token>] [--alias "JD"] [--field '{"label":"E-Mail","type":"email","value":"jane@acme.com"}'] [--tag vip] [--description "CTO at Acme"] [--json]
-ente entity create "Leistungsphase 1" --type topic --space "Studio" --parent "Building A" --exclusive-parent [--json]
+ente entity create "Leistungsphase 1" --type topic --space "Studio" --parent "Building A" [--json]
 ente entity duplicate <name-or-id> --space <space> [--name "New project"] [--include-exclusive-children] [--json]
 ente entity get "Jane Doe" [--limit 20] [--hours-back <hours>] [--min-count 5] [--projection compact|full] [--json]
-ente entity update "Jane Doe" [--name "Jane A. Doe"] [--alias-add "Jane"] [--alias-remove "JD"] [--field '{"label":"Job title","type":"job-title","value":"CEO"}'] [--tag vip] [--description "…"] [--json]
+ente entity update "Jane Doe" [--allow-non-exclusive-children | --disallow-non-exclusive-children] [--name "Jane A. Doe"] [--alias-add "Jane"] [--alias-remove "JD"] [--field '{"label":"Job title","type":"job-title","value":"CEO"}'] [--tag vip] [--description "…"] [--json]
 ente entity field add "Jane Doe" --label "Mobilnummer" --type phone --value "+49 1512 3456789" [--json]
 ente entity field update <valueId> --value "new text" [--json]
 ente entity field remove <valueId> [--json]
@@ -631,7 +631,7 @@ appear individually in the timeline; graph content reads include bounded email
 blocks. Use existing activity controls to correct thread space/owners.
 ## Entity creation and duplication
 
-Entity duplication copies the type, name, description, email addresses, icon and enabled bottom-bar tabs in their configured order, database columns/filters/sorts, grouping rules and the calendar-sidebar list/Kanban preference into the selected source space. It never copies activities or existing parents. `--include-exclusive-children` recursively recreates exclusive branches already in that space with exact child names, order and aggregation settings. Selected-child grouping rules refer only to copied aggregation-enabled direct children; excluded children are dropped from the rule. Shared and archived children are excluded. The operation fails atomically above 100 entities including the root. Use parent context or an ID to distinguish same-named phases across projects.
+Entity duplication copies the type, name, description, email addresses, icon and enabled bottom-bar tabs in their configured order, database columns/filters/sorts, grouping rules and the calendar-sidebar list/Kanban preference into the selected source space. It never copies activities or existing parents. `--include-exclusive-children` is the compatibility name for recursively recreating branches whose selected parent is each child’s sole regular parent already in that space with exact child names, order and aggregation settings. Selected-child grouping rules refer only to copied aggregation-enabled direct children; excluded children are dropped from the rule. Classifier-parent branches and archived children are excluded. Extra classifier links are never copied. The operation fails atomically above 100 entities including the root. Use parent context or an ID to distinguish same-named phases across projects.
 
 `entity create --parent` atomically creates and attaches a child. Add `--exclusive-parent` to restrict it to that parent. The parent must already belong to the destination space; this path never shares it or its ancestors. Resolve same-named phases by parent context or ID. Do not combine `--parent` with `--pin`; `--pin` retains the older separate-link behavior.
 
@@ -771,3 +771,12 @@ Entity values use typed `fields`; entity `--attr` and attribute payloads are leg
 several values under one label; use `"value":null` to remove that label's values.
 A field ID selects an existing definition; a new label is owned by the acting
 space. Activity, task and list `--attr` options keep their existing behavior.
+
+Entity parent settings: each child can have one regular parent plus additional
+parents with `allowNonExclusiveChildren: true`. Missing means false. Create or
+update that parent with `--allow-non-exclusive-children`; update it with
+`--disallow-non-exclusive-children` to turn the setting off. Disabling rejects
+conflicting children, including archived or inaccessible ones, without removing
+links. Legacy `--exclusive-parent` is accepted but inert after policy activation;
+it never sets the new parent setting. Existing Space confirmation and cycle
+rules still apply.

package/dist/cli.mjs

@@ -3800,7 +3800,7 @@ async function runCli(cli2, argv, context) {
 }
 
 // ente/version.ts
-var VERSION = "0.4.97";
+var VERSION = "0.4.98";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -32919,6 +32919,7 @@ var entityReadFields = {
   customIcon: icon.optional(),
   customIconColor: external_exports.enum(customIconColorIds).optional(),
   exclusiveParent: external_exports.boolean().optional(),
+  allowNonExclusiveChildren: external_exports.boolean().optional(),
   descriptionPlainText: external_exports.string().optional(),
   fields: external_exports.array(externalFieldValueSchema),
   tags: external_exports.array(external_exports.string()).optional(),
@@ -33012,7 +33013,8 @@ function optionalStringArray(value) {
 // ../packages/shared/src/entity-creation.ts
 var ENTITY_PARENT_INPUT_PROPERTIES = {
   parentEntityId: { type: "string", minLength: 1, description: "Optional direct parent. Must already belong to every destination space. Creation and attachment are atomic." },
-  exclusiveParent: { type: "boolean", description: "With parentEntityId, restrict this child to that one parent. Defaults to false." }
+  exclusiveParent: { type: "boolean", description: "Deprecated compatibility input; ignored after parent-policy activation." },
+  allowNonExclusiveChildren: { type: "boolean", description: "Allow this entity as an additional parent alongside a child\u2019s one regular parent. Defaults to false." }
 };
 var ENTITY_CREATE_INPUT_SCHEMA = {
   type: "object",
@@ -33039,7 +33041,7 @@ function parseEntityCreateInput(args, name4 = "entities_create") {
   if (args.parentEntityId !== void 0 && (typeof args.parentEntityId !== "string" || !args.parentEntityId.trim()))
     return invalid("parentEntityId must be a non-empty string");
   if (args.exclusiveParent !== void 0 && typeof args.exclusiveParent !== "boolean") return invalid("exclusiveParent must be a boolean");
-  if (args.exclusiveParent === true && args.parentEntityId === void 0) return invalid("exclusiveParent requires parentEntityId");
+  if (args.allowNonExclusiveChildren !== void 0 && typeof args.allowNonExclusiveChildren !== "boolean") return invalid("allowNonExclusiveChildren must be a boolean");
   if (typeof args.name !== "string" || !args.name.trim()) return invalid(`${name4} requires non-empty string name`);
   if (args.type !== void 0 && !isEntityType(args.type)) return invalid(`${name4} type must be one of: ${ENTITY_TYPE_VALUES.join(", ")}`);
   const tags = optionalStringArray(args.tags), aliases = optionalStringArray(args.aliases);
@@ -33052,6 +33054,7 @@ function parseEntityCreateInput(args, name4 = "entities_create") {
     name: args.name.trim(),
     ...typeof args.parentEntityId === "string" ? { parentEntityId: args.parentEntityId } : {},
     ...typeof args.exclusiveParent === "boolean" ? { exclusiveParent: args.exclusiveParent } : {},
+    ...typeof args.allowNonExclusiveChildren === "boolean" ? { allowNonExclusiveChildren: args.allowNonExclusiveChildren } : {},
     ...isEntityType(args.type) ? { type: args.type } : {},
     ...description !== void 0 ? { description } : {},
     ...tags ? { tags } : {},
@@ -33063,6 +33066,7 @@ function parseEntityCreateInput(args, name4 = "entities_create") {
 }
 function parseEntityUpdateInput(args, name4 = "entities_update") {
   if (Object.hasOwn(args, "attributes")) return invalid(LEGACY_ENTITY_ATTRIBUTES_ERROR);
+  if (args.allowNonExclusiveChildren !== void 0 && typeof args.allowNonExclusiveChildren !== "boolean") return invalid("allowNonExclusiveChildren must be a boolean");
   if (typeof args.entityId !== "string") return invalid(`${name4} requires string entityId`);
   const tags = optionalStringArray(args.tags), aliases = optionalStringArray(args.aliases);
   const fieldResult = fieldInputSchema.array().safeParse(args.fields);
@@ -33070,6 +33074,7 @@ function parseEntityUpdateInput(args, name4 = "entities_update") {
   const fields3 = fieldResult.success ? fieldResult.data : void 0;
   return { ok: true, value: {
     entityId: args.entityId,
+    ...typeof args.allowNonExclusiveChildren === "boolean" ? { allowNonExclusiveChildren: args.allowNonExclusiveChildren } : {},
     ...typeof args.name === "string" ? { name: args.name } : {},
     ...tags ? { tags } : {},
     ...fields3 ? { fields: fields3 } : {},
@@ -33081,8 +33086,8 @@ function parseEntityUpdateInput(args, name4 = "entities_update") {
 // ../packages/shared/src/entity-write-operations.ts
 var id9 = external_exports.string().min(1).max(128).refine((value) => value.trim() === value, "Copy IDs unchanged");
 var name2 = external_exports.string().trim().min(1);
-var fields = { name: name2.optional(), description: external_exports.string().optional(), tags: external_exports.array(external_exports.string()).optional(), fields: external_exports.array(fieldInputSchema).max(MAX_ENTITY_FIELD_VALUES).optional(), attributes: external_exports.unknown().optional(), aliases: external_exports.array(external_exports.string()).optional() };
-var create = external_exports.strictObject({ ...fields, name: name2, type: external_exports.enum(ENTITY_TYPE_VALUES).default("person"), spaceId: id9.optional(), spaceIds: external_exports.array(id9).min(1).optional(), parentEntityId: id9.optional(), exclusiveParent: external_exports.boolean().optional() }).refine((value) => value.spaceId !== void 0 || value.spaceIds !== void 0, { path: ["spaceId"], message: "Select spaceId or nonempty spaceIds" }).refine((value) => !value.exclusiveParent || value.parentEntityId !== void 0, { path: ["parentEntityId"], message: "exclusiveParent requires parentEntityId" });
+var fields = { allowNonExclusiveChildren: external_exports.boolean().optional(), name: name2.optional(), description: external_exports.string().optional(), tags: external_exports.array(external_exports.string()).optional(), fields: external_exports.array(fieldInputSchema).max(MAX_ENTITY_FIELD_VALUES).optional(), attributes: external_exports.unknown().optional(), aliases: external_exports.array(external_exports.string()).optional() };
+var create = external_exports.strictObject({ ...fields, name: name2, type: external_exports.enum(ENTITY_TYPE_VALUES).default("person"), spaceId: id9.optional(), spaceIds: external_exports.array(id9).min(1).optional(), parentEntityId: id9.optional(), exclusiveParent: external_exports.boolean().optional() }).refine((value) => value.spaceId !== void 0 || value.spaceIds !== void 0, { path: ["spaceId"], message: "Select spaceId or nonempty spaceIds" });
 var entityWriteInputs = {
   createEntity: create,
   updateEntity: external_exports.strictObject({ entityId: id9, spaceId: id9.optional(), ...fields }),
@@ -33140,7 +33145,7 @@ function rejectLegacyEntityAttributes(operation, raw) {
 
 // ../packages/shared/src/entity-duplication.ts
 var MAX_DUPLICATED_ENTITIES = 100;
-var ENTITY_DUPLICATION_DESCRIPTION = `Duplicate an entity shell in a selected space it already belongs to. Copies type, name, description, email addresses, icon, enabled bottom-bar tabs and their order, database columns/filters/sorts, grouping rules and calendar-sidebar list/Kanban preference, without activities or existing parent links. Optionally recreates exclusive child branches in that same space with exact child names, order and aggregation settings. Selected-child grouping rules are remapped to copied aggregation-enabled direct children. Shared and archived children are excluded. At most ${MAX_DUPLICATED_ENTITIES} entities including the root; oversized copies fail atomically.`;
+var ENTITY_DUPLICATION_DESCRIPTION = `Duplicate an entity shell in a selected space it already belongs to. Copies type, name, description, email addresses, icon, enabled bottom-bar tabs and their order, database columns/filters/sorts, grouping rules and calendar-sidebar list/Kanban preference, without activities or existing parent links. Optionally recreates structural child branches in that same space with exact child names, order and aggregation settings. Selected-child grouping rules are remapped to copied aggregation-enabled direct children. Classifier-parent branches and archived children are excluded; additional classifier links are never copied. At most ${MAX_DUPLICATED_ENTITIES} entities including the root; oversized copies fail atomically.`;
 
 // ../packages/shared/src/entity-write-operation-results.ts
 var entityId = external_exports.string().min(1);
@@ -36459,11 +36464,11 @@ var entitiesCreateEntitySpaceLink = makeFunctionReference("entities:createEntity
 var entitiesRemoveFromSpace = makeFunctionReference("entities:removeFromSpace");
 var EntityDuplicate = class extends ProfileCommand {
   static paths = [["entity", "duplicate"]];
-  static usage = Command.Usage({ category: "Entity", description: `Duplicate a shell without activities; optionally copy exclusive child branches (up to ${MAX_DUPLICATED_ENTITIES} entities)` });
+  static usage = Command.Usage({ category: "Entity", description: `Duplicate a shell without activities; optionally copy structural child branches (up to ${MAX_DUPLICATED_ENTITIES} entities)` });
   nameOrId = options_exports.String();
   space = options_exports.String("--space", { required: true, description: "Source and destination space (name or ID)" });
   name = options_exports.String("--name", { description: "Root copy name; children keep their exact names" });
-  includeExclusiveChildren = options_exports.Boolean("--include-exclusive-children", false, { description: "Copy nested exclusive children in the selected space" });
+  includeExclusiveChildren = options_exports.Boolean("--include-exclusive-children", false, { description: "Copy nested children with this sole regular parent in the selected space" });
   async run() {
     requireEntitySelector("duplicateEntity", this.nameOrId, "entityId");
     requireEntitySelector("duplicateEntity", this.space, "spaceId");
@@ -36508,7 +36513,8 @@ var EntityCreate = class extends ClientCommand {
   type = options_exports.String("--type", { required: true, description: `Entity type (${ENTITY_TYPE_VALUES.join(", ")})` });
   space = options_exports.String("--space", { required: true, description: "Space to create in (name or ID)" });
   parent = options_exports.String("--parent", { description: "Create and attach to this parent atomically (name or ID)" });
-  exclusiveParent = options_exports.Boolean("--exclusive-parent", false, { description: "Restrict the new child to --parent" });
+  allowNonExclusiveChildren = options_exports.Boolean("--allow-non-exclusive-children", false, { description: "Allow this entity alongside a child\u2019s regular parent" });
+  exclusiveParent = options_exports.Boolean("--exclusive-parent", false, { description: "Deprecated compatibility option; ignored after parent-policy activation" });
   pin = options_exports.Array("--pin", { description: "Pin to other entities (resolved by name)" });
   shareParents = options_exports.Boolean("--share-parents", false, {
     description: "Share pinned parents and ancestors into this entity's space when required"
@@ -36525,7 +36531,7 @@ var EntityCreate = class extends ClientCommand {
     if (this.attr !== void 0) rejectLegacyEntityAttributes("createEntity", { attributes: this.attr });
     requireEntitySelector("createEntity", this.space, "spaceId");
     if (this.parent !== void 0) requireEntitySelector("createEntity", this.parent, "parentEntityId");
-    const core = parseEntityWriteRequest("createEntity", { name: this.name, type: this.type, spaceId: "pending-space-resolution", parentEntityId: this.parent === void 0 ? void 0 : "pending-parent-resolution", exclusiveParent: this.exclusiveParent }).input;
+    const core = parseEntityWriteRequest("createEntity", { name: this.name, type: this.type, spaceId: "pending-space-resolution", parentEntityId: this.parent === void 0 ? void 0 : "pending-parent-resolution", exclusiveParent: this.exclusiveParent, allowNonExclusiveChildren: this.allowNonExclusiveChildren }).input;
     if (this.parent && this.pin?.length) throw new OperationInputError("createEntity", [{ path: ["parentEntityId"], reason: "custom" }]);
     const fields3 = parseCliFields("createEntity", this.field);
     const type = core.type;
@@ -36537,6 +36543,7 @@ var EntityCreate = class extends ClientCommand {
       name: core.name,
       type,
       fields: fields3,
+      ...this.allowNonExclusiveChildren ? { allowNonExclusiveChildren: true } : {},
       ...parentEntityId ? { parentEntityId, exclusiveParent: this.exclusiveParent } : {}
     }));
     if (this.alias) for (const a of this.alias) await caller.mutation(entitiesAddAlias, { id: entityId2, alias: a });
@@ -36613,6 +36620,8 @@ var EntityUpdate = class extends ClientCommand {
   static paths = [["entity", "update"]];
   static usage = Command.Usage({ category: "Entity", description: "Update an entity" });
   nameOrId = options_exports.String();
+  allowNonExclusiveChildren = options_exports.Boolean("--allow-non-exclusive-children", { description: "Allow children with other regular parents" });
+  disallowNonExclusiveChildren = options_exports.Boolean("--disallow-non-exclusive-children", false, { description: "Require each child to have this as its only regular parent" });
   name = options_exports.String("--name", { description: "Rename the entity" });
   aliasAdd = options_exports.String("--alias-add", { description: "Add an alias" });
   aliasRemove = options_exports.String("--alias-remove", { description: "Remove an alias" });
@@ -36631,6 +36640,11 @@ var EntityUpdate = class extends ClientCommand {
     const current = needsCurrent ? await caller.query(entitiesFindById, { id: entityId2 }) : void 0;
     if (needsCurrent && !current) throw new Error(`Entity not found: ${entityId2}`);
     let didSomething = false;
+    if (this.allowNonExclusiveChildren !== void 0 || this.disallowNonExclusiveChildren) {
+      if (this.allowNonExclusiveChildren && this.disallowNonExclusiveChildren) throw new Error("Choose one parent-setting option");
+      await this.client().entityWrite("updateEntity", { entityId: entityId2, allowNonExclusiveChildren: this.disallowNonExclusiveChildren ? false : this.allowNonExclusiveChildren });
+      didSomething = true;
+    }
     if (this.name !== void 0) {
       projectEntityWriteResult("updateEntityName", await caller.mutation(entitiesUpdateName, { id: entityId2, name: validated.name ?? this.name }));
       didSomething = true;
@@ -41372,8 +41386,11 @@ Run \`ente guide <topic>\` for deep dives: entities, tasks, activities, search,
 Create an entity when its identity or relationships will be useful later.
 
 Creating entities:
-  ente entity create "Leistungsphase 1" --type topic --space "Studio" --parent "Building A" --exclusive-parent
-  Creates and attaches an exclusive child atomically; the parent must already be in that space.
+  ente entity create "Leistungsphase 1" --type topic --space "Studio" --parent "Building A"
+  Creates and attaches a child atomically; the parent must already be in that space.
+  A child permits one regular parent plus additional parents flagged with --allow-non-exclusive-children.
+  Set that flag on the parent with entity create/update; --disallow-non-exclusive-children turns it off.
+  --exclusive-parent is a deprecated compatibility input, ignored after policy activation.
   ente entity duplicate "Building A" --space "Studio" --name "Building B" --include-exclusive-children
   Copies shells, enabled bottom-bar tabs and their order, database columns/filters/sorts, grouping rules and calendar-sidebar preference.
   Selected-child groups point to copied aggregation-enabled direct children; activities are excluded (maximum 100 entities).