@thinkingai/ae-cli 6.1.17 → 6.1.18

package/dist/{local-data-upload-client-BWHSUQQK.js → local-data-upload-client-4YYHSYD6.js}

@@ -3,8 +3,7 @@ import {
 } from "./chunk-UW5UN47B.js";
 import {
   logger
-} from "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+} from "./chunk-JHENBQ5B.js";
 
 // src/core/local-data-upload-client.ts
 import { createHash } from "crypto";

package/dist/{memory-CHRU2F7W.js → memory-3ORCR7JH.js}

@@ -1,13 +1,13 @@
 import {
   buildCapabilityGatewayUrl,
   callCapabilityApi
-} from "./chunk-P3FGXJTU.js";
-import "./chunk-C4MGVGJW.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+} from "./chunk-ZQ47LWTI.js";
+import "./chunk-SERWF6G5.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/memory/index.ts
 import fs from "fs/promises";

package/dist/{memory-YK33G4T7.js → memory-I2WXDTV2.js}

@@ -1,13 +1,13 @@
 import {
   buildCapabilityGatewayUrl,
   callCapabilityApi
-} from "./chunk-ILIU36SU.js";
+} from "./chunk-OMPRXM3V.js";
 import "./chunk-6EIJSNBD.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/memory/index.ts
 import fs from "fs/promises";

package/dist/{metadata-XXR34N5P.js → metadata-I4C2EWUN.js}

@@ -1,20 +1,20 @@
 import {
   withAsyncArtifactLifecycle
-} from "./chunk-SAU3QFIQ.js";
+} from "./chunk-EFH4XWYC.js";
 import {
   createCapabilityCommand
-} from "./chunk-RGKJGKT7.js";
+} from "./chunk-Y3LOALAV.js";
 import {
   registerCapabilityGatewayRoute
-} from "./chunk-PTE56QPL.js";
-import "./chunk-GT46FPXN.js";
-import "./chunk-P3FGXJTU.js";
-import "./chunk-C4MGVGJW.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+} from "./chunk-3KWQYGYI.js";
+import "./chunk-BYYS3ANB.js";
+import "./chunk-ZQ47LWTI.js";
+import "./chunk-SERWF6G5.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/metadata/shared.ts
 function createCapabilityCommand2(config) {

package/dist/{metadata-UILXHBWF.js → metadata-VUOQJE26.js}

@@ -1,20 +1,20 @@
 import {
   withAsyncArtifactLifecycle
-} from "./chunk-YA6SMTXG.js";
+} from "./chunk-QZ3AS4KK.js";
 import {
   createCapabilityCommand
-} from "./chunk-VR3LCBHW.js";
+} from "./chunk-JRJY5DMJ.js";
 import {
   registerCapabilityGatewayRoute
-} from "./chunk-PTE56QPL.js";
-import "./chunk-GT46FPXN.js";
-import "./chunk-ILIU36SU.js";
+} from "./chunk-3KWQYGYI.js";
+import "./chunk-BYYS3ANB.js";
+import "./chunk-OMPRXM3V.js";
 import "./chunk-6EIJSNBD.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/metadata/shared.ts
 function createCapabilityCommand2(config) {

package/dist/{model-NR3JHFSJ.js → model-HLHIEFMU.js}

@@ -11,13 +11,13 @@ import {
   getClaudeConfigDir,
   getSandboxModels,
   postSandboxModelSelection
-} from "./chunk-VPKZ7I72.js";
+} from "./chunk-QNOLN2LJ.js";
 import "./chunk-6EIJSNBD.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/model/index.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{model-K3KLWIW6.js → model-UGRDX4MW.js}

@@ -11,13 +11,13 @@ import {
   getClaudeConfigDir,
   getSandboxModels,
   postSandboxModelSelection
-} from "./chunk-UOUS37JQ.js";
-import "./chunk-C4MGVGJW.js";
-import "./chunk-4SGZG4XY.js";
-import "./chunk-ZZUOD757.js";
+} from "./chunk-4XXOWOTA.js";
+import "./chunk-SERWF6G5.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/model/index.ts
 import { existsSync, readFileSync } from "fs";

package/dist/personal-semantic-preference-LIPACBDX.js

@@ -0,0 +1,239 @@
+import {
+  createCapabilityCommand
+} from "./chunk-JRJY5DMJ.js";
+import {
+  registerCapabilityGatewayRoute
+} from "./chunk-3KWQYGYI.js";
+import "./chunk-BYYS3ANB.js";
+import "./chunk-OMPRXM3V.js";
+import "./chunk-6EIJSNBD.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
+import "./chunk-UW5UN47B.js";
+import "./chunk-JHENBQ5B.js";
+
+// src/commands/personal-semantic-preference/shared.ts
+function createPersonalSemanticPreferenceCommand(config) {
+  return createCapabilityCommand({
+    ...config,
+    cliService: "personal-semantic-preference",
+    gatewayDomain: "analysis"
+  });
+}
+function optionalString(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : value;
+}
+function optionalKeywords(ctx) {
+  if (ctx.str("keywords") === "") {
+    return void 0;
+  }
+  const value = ctx.json("keywords");
+  if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+    throw new Error("--keywords must be a JSON array of strings.");
+  }
+  return value;
+}
+function optionalResourceRefs(ctx) {
+  if (ctx.str("resource-refs") === "") {
+    return void 0;
+  }
+  const value = ctx.json("resource-refs");
+  if (!Array.isArray(value)) {
+    throw new Error("--resource-refs must be a JSON array.");
+  }
+  if (value.length > 50) {
+    throw new Error("--resource-refs must contain at most 50 items.");
+  }
+  const identities = /* @__PURE__ */ new Set();
+  return value.map((item) => {
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      throw new Error("--resource-refs items must be objects.");
+    }
+    const keys = Object.keys(item).sort();
+    if (keys.join(",") !== "display_name,resource_key,resource_type") {
+      throw new Error("--resource-refs items must contain only resource_type, resource_key, and display_name.");
+    }
+    const ref = item;
+    if (typeof ref.resource_type !== "string" || !/^[a-z][a-z0-9_]{0,63}$/i.test(ref.resource_type.trim())) {
+      throw new Error("resource_type must use lower snake_case.");
+    }
+    if (typeof ref.resource_key !== "string" || ref.resource_key.trim().length === 0 || ref.resource_key.trim().length > 255) {
+      throw new Error("resource_key must contain 1 to 255 characters.");
+    }
+    if (typeof ref.display_name !== "string" || ref.display_name.trim().length === 0 || ref.display_name.trim().length > 255) {
+      throw new Error("display_name must contain 1 to 255 characters.");
+    }
+    const normalized = {
+      resource_type: ref.resource_type.trim().toLowerCase(),
+      resource_key: ref.resource_key.trim(),
+      display_name: ref.display_name.trim()
+    };
+    const identity = `${normalized.resource_type}\0${normalized.resource_key}`;
+    if (identities.has(identity)) {
+      throw new Error("--resource-refs must contain unique resource_type and resource_key pairs.");
+    }
+    identities.add(identity);
+    return normalized;
+  });
+}
+function validateContextType(ctx) {
+  const value = ctx.str("context-type");
+  const supported = ["preference", "asset_context", "experience", "background"];
+  if (!supported.includes(value)) {
+    throw new Error(`--context-type must be one of: ${supported.join(", ")}.`);
+  }
+}
+function validatePersonalSemanticWrite(ctx) {
+  validateContextType(ctx);
+  const contextType = ctx.str("context-type");
+  const refs = optionalResourceRefs(ctx);
+  if (contextType === "asset_context" && (!refs || refs.length === 0)) {
+    throw new Error("--resource-refs is required and must be non-empty for --context-type asset_context.");
+  }
+  if (contextType !== "asset_context" && refs && refs.length > 0) {
+    throw new Error("--resource-refs is only allowed with --context-type asset_context.");
+  }
+}
+function compactInput(input) {
+  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
+}
+
+// src/commands/personal-semantic-preference/add.ts
+var personalSemanticPreferenceAdd = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "add",
+  capabilityId: "business_semantics.personal_context.add",
+  description: "Add one personal semantic preference for the authenticated user.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "context-type", type: "string", required: true, desc: "preference | asset_context | experience | background." },
+    { name: "title", type: "string", required: true, desc: "Short preference title.", maxLength: 255 },
+    { name: "summary", type: "string", required: true, desc: "Compact preference summary.", maxLength: 1e3 },
+    { name: "content", type: "string", required: true, desc: "Full personal semantic preference content.", maxLength: 2e4 },
+    { name: "keywords", type: "json", desc: "Optional JSON array of preference keywords." },
+    { name: "resource-refs", type: "json", desc: "Ordered JSON asset references; required only for asset_context." },
+    { name: "fresh-until-at", type: "string", desc: "Optional freshness expiration timestamp: yyyy-MM-dd HH:mm:ss." },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "write",
+  validate: validatePersonalSemanticWrite,
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    context_type: ctx.str("context-type"),
+    title: ctx.str("title"),
+    summary: ctx.str("summary"),
+    content: ctx.str("content"),
+    keywords: optionalKeywords(ctx),
+    resource_refs: optionalResourceRefs(ctx),
+    fresh_until_at: optionalString(ctx, "fresh-until-at"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/delete.ts
+var personalSemanticPreferenceDelete = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "delete",
+  capabilityId: "business_semantics.personal_context.delete",
+  description: "Soft-delete one personal semantic preference using optimistic locking.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "expected-revision", type: "number", required: true, desc: "Revision returned by the latest read.", min: 1 },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "high-risk-write",
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    expected_revision: ctx.num("expected-revision"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/get.ts
+var personalSemanticPreferenceGet = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "get",
+  capabilityId: "business_semantics.personal_context.get",
+  description: "Get one personal semantic preference; use --mark-used only after adopting it.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "mark-used", type: "boolean", desc: "Count this preference as adopted and update its usage heat." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    mark_used: ctx.bool("mark-used")
+  })
+});
+
+// src/commands/personal-semantic-preference/list.ts
+var CAPABILITY_ID = "business_semantics.personal_context.list";
+var personalSemanticPreferenceList = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "list",
+  capabilityId: CAPABILITY_ID,
+  description: "List the current-user lightweight personal semantic preference catalog in one project.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/update.ts
+var personalSemanticPreferenceUpdate = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "update",
+  capabilityId: "business_semantics.personal_context.update",
+  description: "Update one personal semantic preference using optimistic locking.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "expected-revision", type: "number", required: true, desc: "Revision returned by the latest read.", min: 1 },
+    { name: "context-type", type: "string", required: true, desc: "preference | asset_context | experience | background." },
+    { name: "title", type: "string", required: true, desc: "Short preference title.", maxLength: 255 },
+    { name: "summary", type: "string", required: true, desc: "Compact preference summary.", maxLength: 1e3 },
+    { name: "content", type: "string", required: true, desc: "Full replacement content.", maxLength: 2e4 },
+    { name: "keywords", type: "json", desc: "Optional JSON array of preference keywords." },
+    { name: "resource-refs", type: "json", desc: "Ordered JSON asset references; required only for asset_context." },
+    { name: "fresh-until-at", type: "string", desc: "Optional freshness expiration timestamp: yyyy-MM-dd HH:mm:ss." },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "write",
+  validate: validatePersonalSemanticWrite,
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    expected_revision: ctx.num("expected-revision"),
+    context_type: ctx.str("context-type"),
+    title: ctx.str("title"),
+    summary: ctx.str("summary"),
+    content: ctx.str("content"),
+    keywords: optionalKeywords(ctx),
+    resource_refs: optionalResourceRefs(ctx),
+    fresh_until_at: optionalString(ctx, "fresh-until-at"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/index.ts
+registerCapabilityGatewayRoute("personal-semantic-preference", { gatewayDomain: "analysis" });
+var commands = [
+  personalSemanticPreferenceList,
+  personalSemanticPreferenceGet,
+  personalSemanticPreferenceAdd,
+  personalSemanticPreferenceUpdate,
+  personalSemanticPreferenceDelete
+];
+var personal_semantic_preference_default = commands;
+export {
+  personal_semantic_preference_default as default
+};

package/dist/personal-semantic-preference-OEISBRHM.js

@@ -0,0 +1,239 @@
+import {
+  createCapabilityCommand
+} from "./chunk-Y3LOALAV.js";
+import {
+  registerCapabilityGatewayRoute
+} from "./chunk-3KWQYGYI.js";
+import "./chunk-BYYS3ANB.js";
+import "./chunk-ZQ47LWTI.js";
+import "./chunk-SERWF6G5.js";
+import "./chunk-J2DEBMRF.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
+import "./chunk-UW5UN47B.js";
+import "./chunk-JHENBQ5B.js";
+
+// src/commands/personal-semantic-preference/shared.ts
+function createPersonalSemanticPreferenceCommand(config) {
+  return createCapabilityCommand({
+    ...config,
+    cliService: "personal-semantic-preference",
+    gatewayDomain: "analysis"
+  });
+}
+function optionalString(ctx, name) {
+  const value = ctx.str(name);
+  return value === "" ? void 0 : value;
+}
+function optionalKeywords(ctx) {
+  if (ctx.str("keywords") === "") {
+    return void 0;
+  }
+  const value = ctx.json("keywords");
+  if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+    throw new Error("--keywords must be a JSON array of strings.");
+  }
+  return value;
+}
+function optionalResourceRefs(ctx) {
+  if (ctx.str("resource-refs") === "") {
+    return void 0;
+  }
+  const value = ctx.json("resource-refs");
+  if (!Array.isArray(value)) {
+    throw new Error("--resource-refs must be a JSON array.");
+  }
+  if (value.length > 50) {
+    throw new Error("--resource-refs must contain at most 50 items.");
+  }
+  const identities = /* @__PURE__ */ new Set();
+  return value.map((item) => {
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      throw new Error("--resource-refs items must be objects.");
+    }
+    const keys = Object.keys(item).sort();
+    if (keys.join(",") !== "display_name,resource_key,resource_type") {
+      throw new Error("--resource-refs items must contain only resource_type, resource_key, and display_name.");
+    }
+    const ref = item;
+    if (typeof ref.resource_type !== "string" || !/^[a-z][a-z0-9_]{0,63}$/i.test(ref.resource_type.trim())) {
+      throw new Error("resource_type must use lower snake_case.");
+    }
+    if (typeof ref.resource_key !== "string" || ref.resource_key.trim().length === 0 || ref.resource_key.trim().length > 255) {
+      throw new Error("resource_key must contain 1 to 255 characters.");
+    }
+    if (typeof ref.display_name !== "string" || ref.display_name.trim().length === 0 || ref.display_name.trim().length > 255) {
+      throw new Error("display_name must contain 1 to 255 characters.");
+    }
+    const normalized = {
+      resource_type: ref.resource_type.trim().toLowerCase(),
+      resource_key: ref.resource_key.trim(),
+      display_name: ref.display_name.trim()
+    };
+    const identity = `${normalized.resource_type}\0${normalized.resource_key}`;
+    if (identities.has(identity)) {
+      throw new Error("--resource-refs must contain unique resource_type and resource_key pairs.");
+    }
+    identities.add(identity);
+    return normalized;
+  });
+}
+function validateContextType(ctx) {
+  const value = ctx.str("context-type");
+  const supported = ["preference", "asset_context", "experience", "background"];
+  if (!supported.includes(value)) {
+    throw new Error(`--context-type must be one of: ${supported.join(", ")}.`);
+  }
+}
+function validatePersonalSemanticWrite(ctx) {
+  validateContextType(ctx);
+  const contextType = ctx.str("context-type");
+  const refs = optionalResourceRefs(ctx);
+  if (contextType === "asset_context" && (!refs || refs.length === 0)) {
+    throw new Error("--resource-refs is required and must be non-empty for --context-type asset_context.");
+  }
+  if (contextType !== "asset_context" && refs && refs.length > 0) {
+    throw new Error("--resource-refs is only allowed with --context-type asset_context.");
+  }
+}
+function compactInput(input) {
+  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
+}
+
+// src/commands/personal-semantic-preference/add.ts
+var personalSemanticPreferenceAdd = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "add",
+  capabilityId: "business_semantics.personal_context.add",
+  description: "Add one personal semantic preference for the authenticated user.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "context-type", type: "string", required: true, desc: "preference | asset_context | experience | background." },
+    { name: "title", type: "string", required: true, desc: "Short preference title.", maxLength: 255 },
+    { name: "summary", type: "string", required: true, desc: "Compact preference summary.", maxLength: 1e3 },
+    { name: "content", type: "string", required: true, desc: "Full personal semantic preference content.", maxLength: 2e4 },
+    { name: "keywords", type: "json", desc: "Optional JSON array of preference keywords." },
+    { name: "resource-refs", type: "json", desc: "Ordered JSON asset references; required only for asset_context." },
+    { name: "fresh-until-at", type: "string", desc: "Optional freshness expiration timestamp: yyyy-MM-dd HH:mm:ss." },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "write",
+  validate: validatePersonalSemanticWrite,
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    context_type: ctx.str("context-type"),
+    title: ctx.str("title"),
+    summary: ctx.str("summary"),
+    content: ctx.str("content"),
+    keywords: optionalKeywords(ctx),
+    resource_refs: optionalResourceRefs(ctx),
+    fresh_until_at: optionalString(ctx, "fresh-until-at"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/delete.ts
+var personalSemanticPreferenceDelete = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "delete",
+  capabilityId: "business_semantics.personal_context.delete",
+  description: "Soft-delete one personal semantic preference using optimistic locking.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "expected-revision", type: "number", required: true, desc: "Revision returned by the latest read.", min: 1 },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "high-risk-write",
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    expected_revision: ctx.num("expected-revision"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/get.ts
+var personalSemanticPreferenceGet = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "get",
+  capabilityId: "business_semantics.personal_context.get",
+  description: "Get one personal semantic preference; use --mark-used only after adopting it.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "mark-used", type: "boolean", desc: "Count this preference as adopted and update its usage heat." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    mark_used: ctx.bool("mark-used")
+  })
+});
+
+// src/commands/personal-semantic-preference/list.ts
+var CAPABILITY_ID = "business_semantics.personal_context.list";
+var personalSemanticPreferenceList = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "list",
+  capabilityId: CAPABILITY_ID,
+  description: "List the current-user lightweight personal semantic preference catalog in one project.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/update.ts
+var personalSemanticPreferenceUpdate = createPersonalSemanticPreferenceCommand({
+  resource: "",
+  command: "update",
+  capabilityId: "business_semantics.personal_context.update",
+  description: "Update one personal semantic preference using optimistic locking.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p", min: 1 },
+    { name: "id", type: "string", required: true, desc: "Preference ID returned by list/add." },
+    { name: "expected-revision", type: "number", required: true, desc: "Revision returned by the latest read.", min: 1 },
+    { name: "context-type", type: "string", required: true, desc: "preference | asset_context | experience | background." },
+    { name: "title", type: "string", required: true, desc: "Short preference title.", maxLength: 255 },
+    { name: "summary", type: "string", required: true, desc: "Compact preference summary.", maxLength: 1e3 },
+    { name: "content", type: "string", required: true, desc: "Full replacement content.", maxLength: 2e4 },
+    { name: "keywords", type: "json", desc: "Optional JSON array of preference keywords." },
+    { name: "resource-refs", type: "json", desc: "Ordered JSON asset references; required only for asset_context." },
+    { name: "fresh-until-at", type: "string", desc: "Optional freshness expiration timestamp: yyyy-MM-dd HH:mm:ss." },
+    { name: "request-id", type: "string", desc: "Optional idempotency key; generated when omitted.", maxLength: 128 }
+  ],
+  risk: "write",
+  validate: validatePersonalSemanticWrite,
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    id: ctx.str("id"),
+    expected_revision: ctx.num("expected-revision"),
+    context_type: ctx.str("context-type"),
+    title: ctx.str("title"),
+    summary: ctx.str("summary"),
+    content: ctx.str("content"),
+    keywords: optionalKeywords(ctx),
+    resource_refs: optionalResourceRefs(ctx),
+    fresh_until_at: optionalString(ctx, "fresh-until-at"),
+    request_id: optionalString(ctx, "request-id")
+  })
+});
+
+// src/commands/personal-semantic-preference/index.ts
+registerCapabilityGatewayRoute("personal-semantic-preference", { gatewayDomain: "analysis" });
+var commands = [
+  personalSemanticPreferenceList,
+  personalSemanticPreferenceGet,
+  personalSemanticPreferenceAdd,
+  personalSemanticPreferenceUpdate,
+  personalSemanticPreferenceDelete
+];
+var personal_semantic_preference_default = commands;
+export {
+  personal_semantic_preference_default as default
+};