ente-cli 0.4.72 → 0.4.73

package/dist/SKILL.md

@@ -157,6 +157,8 @@ 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 50] [--archived] [--json]
 ente entity create "Jane Doe" --type person [--pin "Acme Corp"] [--share-parents --parent-space-grant-fingerprint <token>] [--alias "JD"] [--attr email=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 duplicate <name-or-id> --space <space> [--name "New project"] [--include-exclusive-children] [--json]
 ente entity get "Jane Doe" [--json]
 ente entity update "Jane Doe" [--name "Jane A. Doe"] [--alias-add "Jane"] [--alias-remove "JD"] [--attr role=CEO] [--tag vip] [--description "…"] [--json]
 ente entity rename "Lorey Georg" "Georg Lorey"        # change display name
@@ -523,6 +525,12 @@ Optional schedules accept `intervalHours: 1 | 24` and
 Published threads are native, durable, read-only activities. Their messages
 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 and icon 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. 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 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.
+
 ## Reviewed space changes
 
 `ente space change COMMAND --json` supports `prepare`, `status`, `items`,

package/dist/cli.mjs

@@ -3800,7 +3800,7 @@ async function runCli(cli2, argv, context) {
 }
 
 // ente/version.ts
-var VERSION = "0.4.72";
+var VERSION = "0.4.73";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -11251,6 +11251,10 @@ var AuthProfiles = class extends BaseCommand {
 };
 var AUTH_COMMANDS = [AuthLogin, AuthPair, AuthStatus, AuthLogout, AuthProfiles];
 
+// ../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 and icon, without activities or existing parent links. Optionally recreates exclusive child branches in that same space with exact child names, order and aggregation settings. Shared and archived children are excluded. At most ${MAX_DUPLICATED_ENTITIES} entities including the root; oversized copies fail atomically.`;
+
 // ../packages/shared/src/entity-types.ts
 var ENTITY_TYPE_VALUES = [
   "person",
@@ -11733,6 +11737,7 @@ var PinsList = class extends ProfileCommand {
 var PINS_COMMANDS = [PinsList];
 
 // ente/commands/entity.ts
+var entitiesDuplicate = makeFunctionReference("entities:duplicate");
 var entitiesCreate = makeFunctionReference("entities:create");
 var entitiesFindById = makeFunctionReference(
   "entities:findById"
@@ -11787,6 +11792,26 @@ function toActivityView(rich) {
     shortId: rich.shortId
   };
 }
+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)` });
+  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" });
+  async run() {
+    const caller = await resolveCaller();
+    const entityId = await resolveEntityC(caller, this.nameOrId);
+    const spaceId = await resolveSpaceByNameC(caller, this.space);
+    const data = await caller.mutation(entitiesDuplicate, {
+      entityId,
+      spaceId,
+      name: this.name,
+      includeExclusiveChildren: this.includeExclusiveChildren
+    });
+    this.emitText({ data }, () => `Duplicated ${data.duplicatedCount} entities (${data.entityId})`);
+  }
+};
 var EntityList = class extends ClientCommand {
   static paths = [["entity", "list"]];
   static usage = Command.Usage({ category: "Entity", description: "List or search entities" });
@@ -11813,6 +11838,8 @@ var EntityCreate = class extends ProfileCommand {
   name = options_exports.String();
   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" });
   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"
@@ -11827,11 +11854,15 @@ var EntityCreate = class extends ProfileCommand {
   async run() {
     const caller = await resolveCaller();
     const spaceId = await resolveSpaceByNameC(caller, this.space);
+    if (this.exclusiveParent && !this.parent) throw new Error("--exclusive-parent requires --parent.");
+    if (this.parent && this.pin?.length) throw new Error("Use --parent for atomic child creation, or --pin for legacy parent linking, not both.");
+    const parentEntityId = this.parent ? await resolveEntityC(caller, this.parent) : void 0;
     const attributes = parseAttrs(this.attr);
     const entityId = await caller.mutation(entitiesCreate, {
       spaceId,
       name: this.name,
-      type: this.type
+      type: this.type,
+      ...parentEntityId ? { parentEntityId, exclusiveParent: this.exclusiveParent } : {}
     });
     if (this.alias) for (const a of this.alias) await caller.mutation(entitiesAddAlias, { id: entityId, alias: a });
     if (this.tag) for (const t of this.tag) await caller.mutation(entitiesAddTag, { id: entityId, tag: t });
@@ -12277,6 +12308,7 @@ var ENTITY_COMMANDS = [
   EntityShowCorrection,
   EntityList,
   EntityCreate,
+  EntityDuplicate,
   EntityGet,
   EntityUpdate,
   EntityRename,
@@ -15995,7 +16027,7 @@ Commands:
   ente search <query>          Fuzzy search entities
   ente ask <question>          Natural-language answer (AI synthesis + citations)
   ente query <question>        Deterministic evidence retrieval (no synthesis)
-  ente entity create|get|update|rename|archive|restore|pin|unpin
+  ente entity create|get|update|duplicate|rename|archive|restore|pin|unpin
   ente entity list [--archived]
   ente pins list <entity>      List pins for an entity
   ente task list|get|create|update|done|assign|unassign|set-assignees|clear-assignees
@@ -16026,6 +16058,10 @@ 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 duplicate "Building A" --space "Studio" --name "Building B" --include-exclusive-children
+  Copies shells and exclusive child branches without activities (maximum 100 entities).
   ente entity create "Jane Doe" --type person --pin "Acme Corp" --alias "JD"
   # Add --share-parents when the parent is not already in the new entity's space.