@packmind/cli 0.17.0 → 0.18.0

package/main.cjs

@@ -371,32 +371,32 @@ var init_supports_color = __esm({
 });
 
 // node_modules/chalk/source/utilities.js
-function stringReplaceAll(string11, substring, replacer) {
-  let index = string11.indexOf(substring);
+function stringReplaceAll(string12, substring, replacer) {
+  let index = string12.indexOf(substring);
   if (index === -1) {
-    return string11;
+    return string12;
   }
   const substringLength = substring.length;
   let endIndex = 0;
   let returnValue = "";
   do {
-    returnValue += string11.slice(endIndex, index) + substring + replacer;
+    returnValue += string12.slice(endIndex, index) + substring + replacer;
     endIndex = index + substringLength;
-    index = string11.indexOf(substring, endIndex);
+    index = string12.indexOf(substring, endIndex);
   } while (index !== -1);
-  returnValue += string11.slice(endIndex);
+  returnValue += string12.slice(endIndex);
   return returnValue;
 }
-function stringEncaseCRLFWithFirstIndex(string11, prefix, postfix, index) {
+function stringEncaseCRLFWithFirstIndex(string12, prefix, postfix, index) {
   let endIndex = 0;
   let returnValue = "";
   do {
-    const gotCR = string11[index - 1] === "\r";
-    returnValue += string11.slice(endIndex, gotCR ? index - 1 : index) + prefix + (gotCR ? "\r\n" : "\n") + postfix;
+    const gotCR = string12[index - 1] === "\r";
+    returnValue += string12.slice(endIndex, gotCR ? index - 1 : index) + prefix + (gotCR ? "\r\n" : "\n") + postfix;
     endIndex = index + 1;
-    index = string11.indexOf("\n", endIndex);
+    index = string12.indexOf("\n", endIndex);
   } while (index !== -1);
-  returnValue += string11.slice(endIndex);
+  returnValue += string12.slice(endIndex);
   return returnValue;
 }
 var init_utilities = __esm({
@@ -555,26 +555,26 @@ var init_source = __esm({
       builder[IS_EMPTY] = _isEmpty;
       return builder;
     };
-    applyStyle = (self, string11) => {
-      if (self.level <= 0 || !string11) {
-        return self[IS_EMPTY] ? "" : string11;
+    applyStyle = (self, string12) => {
+      if (self.level <= 0 || !string12) {
+        return self[IS_EMPTY] ? "" : string12;
       }
       let styler = self[STYLER];
       if (styler === void 0) {
-        return string11;
+        return string12;
       }
       const { openAll, closeAll } = styler;
-      if (string11.includes("\x1B")) {
+      if (string12.includes("\x1B")) {
         while (styler !== void 0) {
-          string11 = stringReplaceAll(string11, styler.close, styler.open);
+          string12 = stringReplaceAll(string12, styler.close, styler.open);
           styler = styler.parent;
         }
       }
-      const lfIndex = string11.indexOf("\n");
+      const lfIndex = string12.indexOf("\n");
       if (lfIndex !== -1) {
-        string11 = stringEncaseCRLFWithFirstIndex(string11, closeAll, openAll, lfIndex);
+        string12 = stringEncaseCRLFWithFirstIndex(string12, closeAll, openAll, lfIndex);
       }
-      return openAll + string11 + closeAll;
+      return openAll + string12 + closeAll;
     };
     Object.defineProperties(createChalk.prototype, styles2);
     chalk = createChalk();
@@ -767,9 +767,9 @@ var require_findOption = __commonJS({
           continue;
         }
         if (node.type === "shortOptions" && opts.shortNames.length) {
-          for (const option7 of node.options) {
-            if (opts.shortNames.includes(option7.key)) {
-              result.push(option7);
+          for (const option8 of node.options) {
+            if (opts.shortNames.includes(option8.key)) {
+              result.push(option8);
             }
           }
         }
@@ -842,7 +842,7 @@ var require_types = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.boolean = exports2.string = exports2.number = void 0;
-    exports2.optional = optional5;
+    exports2.optional = optional8;
     exports2.array = array3;
     var type_1 = require_type();
     exports2.number = {
@@ -869,7 +869,7 @@ var require_types = __commonJS({
         return false;
       }
     };
-    function optional5(t) {
+    function optional8(t) {
       return {
         ...t,
         defaultValue() {
@@ -1403,9 +1403,9 @@ var require_subcommands = __commonJS({
           let errorMessage = "Not a valid subcommand name";
           const closeOptions = (0, didyoumean_1.default)(str, flatMap(commands, (x) => x.names));
           if (closeOptions) {
-            const option7 = Array.isArray(closeOptions) ? closeOptions[0] : closeOptions;
+            const option8 = Array.isArray(closeOptions) ? closeOptions[0] : closeOptions;
             errorMessage += `
-Did you mean ${chalk_1.default.italic(option7)}?`;
+Did you mean ${chalk_1.default.italic(option8)}?`;
           }
           throw new Error(errorMessage);
         }
@@ -1578,11 +1578,11 @@ var strip_ansi_exports = {};
 __export(strip_ansi_exports, {
   default: () => stripAnsi
 });
-function stripAnsi(string11) {
-  if (typeof string11 !== "string") {
-    throw new TypeError(`Expected a \`string\`, got \`${typeof string11}\``);
+function stripAnsi(string12) {
+  if (typeof string12 !== "string") {
+    throw new TypeError(`Expected a \`string\`, got \`${typeof string12}\``);
   }
-  return string11.replace(regex, "");
+  return string12.replace(regex, "");
 }
 var regex;
 var init_strip_ansi = __esm({
@@ -1781,11 +1781,11 @@ var require_command = __commonJS({
             }
             if (node.type === "forcePositional") {
             } else if (node.type === "shortOptions") {
-              for (const option7 of node.options) {
-                if (context.visitedNodes.has(option7)) {
+              for (const option8 of node.options) {
+                if (context.visitedNodes.has(option8)) {
                   continue;
                 }
-                unknownArguments.push(option7);
+                unknownArguments.push(option8);
               }
             } else {
               unknownArguments.push(node);
@@ -1864,7 +1864,7 @@ var require_option = __commonJS({
       return mod && mod.__esModule ? mod : { "default": mod };
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.option = option7;
+    exports2.option = option8;
     var chalk_1 = __importDefault((init_source(), __toCommonJS(source_exports)));
     var Result = __importStar(require_Result());
     var findOption_1 = require_findOption();
@@ -1940,11 +1940,11 @@ var require_option = __commonJS({
           const valueFromEnv = config.env ? process.env[config.env] : void 0;
           const defaultValueFn = config.defaultValue || config.type.defaultValue;
           const onMissingFn = config.onMissing || config.type.onMissing;
-          const option8 = options[0];
+          const option9 = options[0];
           let rawValue;
           let envPrefix = "";
-          if (option8 === null || option8 === void 0 ? void 0 : option8.value) {
-            rawValue = option8.value.node.raw;
+          if (option9 === null || option9 === void 0 ? void 0 : option9.value) {
+            rawValue = option9.value.node.raw;
           } else if (valueFromEnv !== void 0) {
             rawValue = valueFromEnv;
             envPrefix = `env[${chalk_1.default.italic(config.env)}]: `;
@@ -1979,7 +1979,7 @@ var require_option = __commonJS({
               });
             }
           } else {
-            const raw = (option8 === null || option8 === void 0 ? void 0 : option8.type) === "shortOption" ? `-${option8 === null || option8 === void 0 ? void 0 : option8.key}` : `--${config.long}`;
+            const raw = (option9 === null || option9 === void 0 ? void 0 : option9.type) === "shortOption" ? `-${option9 === null || option9 === void 0 ? void 0 : option9.key}` : `--${config.long}`;
             return Result.err({
               errors: [
                 {
@@ -2001,7 +2001,7 @@ var require_option = __commonJS({
         }
       };
     }
-    function option7(config) {
+    function option8(config) {
       return fullOption({
         type: types_1.string,
         ...config
@@ -2040,12 +2040,12 @@ var require_errorBox = __commonJS({
         if (node.type === "shortOptions") {
           let failed = false;
           let s = "";
-          for (const option7 of node.options) {
-            if (error.nodes.includes(option7)) {
-              s += chalk_1.default.red(option7.raw);
+          for (const option8 of node.options) {
+            if (error.nodes.includes(option8)) {
+              s += chalk_1.default.red(option8.raw);
               failed = true;
             } else {
-              s += chalk_1.default.dim(option7.raw);
+              s += chalk_1.default.dim(option8.raw);
             }
           }
           const prefix = failed ? chalk_1.default.red("-") : chalk_1.default.dim("-");
@@ -3084,8 +3084,8 @@ var require_tokenizer = __commonJS({
         tokens.push(token);
         overallIndex += token.raw.length;
       };
-      for (const [stringIndex, string11] of (0, utils_1.enumerate)(strings)) {
-        const chars = [...string11];
+      for (const [stringIndex, string12] of (0, utils_1.enumerate)(strings)) {
+        const chars = [...string12];
         for (let i = 0; i < chars.length; i++) {
           if (chars[i] === "-" && chars[i + 1] === "-") {
             push({ type: "longPrefix", raw: "--", index: overallIndex });
@@ -3346,15 +3346,15 @@ var require_multiflag = __commonJS({
             longNames: [config.long],
             shortNames: config.short ? [config.short] : []
           }).filter((x) => !visitedNodes.has(x));
-          for (const option7 of options) {
-            visitedNodes.add(option7);
+          for (const option8 of options) {
+            visitedNodes.add(option8);
           }
           const optionValues = [];
           const errors = [];
-          for (const option7 of options) {
-            const decoded = await Result.safeAsync(flag_1.boolean.from((_b = (_a = option7.value) === null || _a === void 0 ? void 0 : _a.node.raw) !== null && _b !== void 0 ? _b : "true"));
+          for (const option8 of options) {
+            const decoded = await Result.safeAsync(flag_1.boolean.from((_b = (_a = option8.value) === null || _a === void 0 ? void 0 : _a.node.raw) !== null && _b !== void 0 ? _b : "true"));
             if (Result.isErr(decoded)) {
-              errors.push({ nodes: [option7], message: decoded.error.message });
+              errors.push({ nodes: [option8], message: decoded.error.message });
             } else {
               optionValues.push(decoded.value);
             }
@@ -3518,16 +3518,16 @@ var require_multioption = __commonJS({
               });
             }
           }
-          for (const option7 of options) {
-            visitedNodes.add(option7);
+          for (const option8 of options) {
+            visitedNodes.add(option8);
           }
           const optionValues = [];
           const errors = [];
           const flagNodes = [];
-          for (const option7 of options) {
-            const providedValue = (_a = option7.value) === null || _a === void 0 ? void 0 : _a.node.raw;
+          for (const option8 of options) {
+            const providedValue = (_a = option8.value) === null || _a === void 0 ? void 0 : _a.node.raw;
             if (providedValue === void 0) {
-              flagNodes.push(option7);
+              flagNodes.push(option8);
               continue;
             }
             optionValues.push(providedValue);
@@ -3852,7 +3852,7 @@ var require_package = __commonJS({
   "apps/cli/package.json"(exports2, module2) {
     module2.exports = {
       name: "@packmind/cli",
-      version: "0.17.0",
+      version: "0.18.0",
       description: "A command-line interface for Packmind linting and code quality checks",
       private: false,
       bin: {
@@ -6399,6 +6399,16 @@ var ChangeProposalGateway = class {
         }
       );
     };
+    this.check = async (command21) => {
+      const { organizationId } = this.httpClient.getAuthContext();
+      return this.httpClient.request(
+        `/api/v0/organizations/${organizationId}/spaces/${command21.spaceId}/change-proposals/check`,
+        {
+          method: "POST",
+          body: { proposals: command21.proposals }
+        }
+      );
+    };
   }
 };
 
@@ -11605,7 +11615,7 @@ var SubmitDiffsUseCase = class {
     this.packmindGateway = packmindGateway;
   }
   async execute(command21) {
-    const { groupedDiffs } = command21;
+    const { groupedDiffs, message } = command21;
     const skipped = [];
     const validDiffs = [];
     for (const group of groupedDiffs) {
@@ -11647,7 +11657,8 @@ var SubmitDiffsUseCase = class {
           type: diff.type,
           artefactId: diff.artifactId,
           payload: diff.payload,
-          captureMode: "commit" /* commit */
+          captureMode: "commit" /* commit */,
+          message
         }))
       });
       submitted += response.created;
@@ -11665,6 +11676,68 @@ var SubmitDiffsUseCase = class {
   }
 };
 
+// apps/cli/src/application/useCases/CheckDiffsUseCase.ts
+var SUPPORTED_ARTIFACT_TYPES2 = /* @__PURE__ */ new Set(["command", "skill", "standard"]);
+var CheckDiffsUseCase = class {
+  constructor(packmindGateway) {
+    this.packmindGateway = packmindGateway;
+  }
+  async execute(command21) {
+    const { groupedDiffs } = command21;
+    const results = [];
+    const validDiffs = [];
+    const invalidDiffs = [];
+    for (const group of groupedDiffs) {
+      for (const diff of group) {
+        if (!SUPPORTED_ARTIFACT_TYPES2.has(diff.artifactType) || !diff.artifactId || !diff.spaceId) {
+          invalidDiffs.push(diff);
+          continue;
+        }
+        validDiffs.push(diff);
+      }
+    }
+    const diffsBySpaceId = /* @__PURE__ */ new Map();
+    for (const diff of validDiffs) {
+      const existing = diffsBySpaceId.get(diff.spaceId) ?? [];
+      existing.push(diff);
+      diffsBySpaceId.set(diff.spaceId, existing);
+    }
+    const checkedMap = /* @__PURE__ */ new Map();
+    for (const [spaceId, diffs] of diffsBySpaceId) {
+      const response = await this.packmindGateway.changeProposals.check({
+        spaceId,
+        proposals: diffs.map((diff) => ({
+          type: diff.type,
+          artefactId: diff.artifactId,
+          payload: diff.payload,
+          captureMode: "commit" /* commit */,
+          message: ""
+        }))
+      });
+      for (const result of response.results) {
+        const diff = diffs[result.index];
+        checkedMap.set(diff, {
+          diff,
+          exists: result.exists,
+          createdAt: result.createdAt,
+          message: result.message
+        });
+      }
+    }
+    for (const group of groupedDiffs) {
+      for (const diff of group) {
+        const checked = checkedMap.get(diff);
+        if (checked) {
+          results.push(checked);
+        } else {
+          results.push({ diff, exists: false, createdAt: null, message: null });
+        }
+      }
+    }
+    return { results };
+  }
+};
+
 // apps/cli/src/PackmindCliHexaFactory.ts
 var PackmindCliHexaFactory = class {
   constructor() {
@@ -11718,7 +11791,8 @@ var PackmindCliHexaFactory = class {
       diffArtefacts: new DiffArtefactsUseCase(
         this.repositories.packmindGateway
       ),
-      submitDiffs: new SubmitDiffsUseCase(this.repositories.packmindGateway)
+      submitDiffs: new SubmitDiffsUseCase(this.repositories.packmindGateway),
+      checkDiffs: new CheckDiffsUseCase(this.repositories.packmindGateway)
     };
   }
 };
@@ -11770,8 +11844,11 @@ var PackmindCliHexa = class {
   async diffArtefacts(command21) {
     return this.hexa.useCases.diffArtefacts.execute(command21);
   }
-  async submitDiffs(groupedDiffs) {
-    return this.hexa.useCases.submitDiffs.execute({ groupedDiffs });
+  async submitDiffs(groupedDiffs, message) {
+    return this.hexa.useCases.submitDiffs.execute({ groupedDiffs, message });
+  }
+  async checkDiffs(groupedDiffs) {
+    return this.hexa.useCases.checkDiffs.execute({ groupedDiffs });
   }
   async listPackages(command21) {
     return this.hexa.useCases.listPackages.execute(command21);
@@ -13873,21 +13950,24 @@ function validatePlaybook(data) {
 }
 
 // apps/cli/src/infra/utils/readPlaybookFile.ts
+function parseAndValidatePlaybook(content) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (e) {
+    return {
+      isValid: false,
+      errors: [
+        `Invalid JSON: ${e instanceof Error ? e.message : "Unknown error"}`
+      ]
+    };
+  }
+  return validatePlaybook(parsed);
+}
 async function readPlaybookFile(filePath) {
   try {
     const content = await fs16.readFile(filePath, "utf-8");
-    let parsed;
-    try {
-      parsed = JSON.parse(content);
-    } catch (e) {
-      return {
-        isValid: false,
-        errors: [
-          `Invalid JSON: ${e instanceof Error ? e.message : "Unknown error"}`
-        ]
-      };
-    }
-    return validatePlaybook(parsed);
+    return parseAndValidatePlaybook(content);
   } catch (e) {
     return {
       isValid: false,
@@ -13898,9 +13978,40 @@ async function readPlaybookFile(filePath) {
   }
 }
 
+// apps/cli/src/infra/utils/readStdin.ts
+async function readStdin(input = process.stdin) {
+  if ("isTTY" in input && input.isTTY) {
+    throw new Error(
+      "No piped input detected. Please provide content via stdin or specify a file path."
+    );
+  }
+  const chunks = [];
+  for await (const chunk of input) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const content = Buffer.concat(chunks).toString("utf-8").trim();
+  if (!content) {
+    throw new Error("Stdin is empty. Please provide JSON content via pipe.");
+  }
+  return content;
+}
+
 // apps/cli/src/infra/commands/createStandardHandler.ts
 async function createStandardHandler(filePath, useCase, originSkill) {
-  const readResult = await readPlaybookFile(filePath);
+  let readResult;
+  if (filePath) {
+    readResult = await readPlaybookFile(filePath);
+  } else {
+    try {
+      const content = await readStdin();
+      readResult = parseAndValidatePlaybook(content);
+    } catch (e) {
+      return {
+        success: false,
+        error: e instanceof Error ? e.message : "Failed to read from stdin"
+      };
+    }
+  }
   if (!readResult.isValid) {
     return {
       success: false,
@@ -13961,12 +14072,12 @@ var CreateStandardFromPlaybookUseCase = class {
 // apps/cli/src/infra/commands/CreateStandardCommand.ts
 var createStandardCommand = (0, import_cmd_ts13.command)({
   name: "create",
-  description: "Create a coding standard from a playbook JSON file",
+  description: "Create a coding standard from a playbook JSON file or stdin",
   args: {
     file: (0, import_cmd_ts13.positional)({
       displayName: "file",
-      description: "Path to the playbook JSON file",
-      type: import_cmd_ts13.string
+      description: "Path to the playbook JSON file (reads from stdin if omitted)",
+      type: (0, import_cmd_ts13.optional)(import_cmd_ts13.string)
     }),
     originSkill: originSkillOption
   },
@@ -14127,21 +14238,24 @@ function validateCommandPlaybook(data) {
 }
 
 // apps/cli/src/infra/utils/readCommandPlaybookFile.ts
+function parseAndValidateCommandPlaybook(content) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (e) {
+    return {
+      isValid: false,
+      errors: [
+        `Invalid JSON: ${e instanceof Error ? e.message : "Unknown error"}`
+      ]
+    };
+  }
+  return validateCommandPlaybook(parsed);
+}
 async function readCommandPlaybookFile(filePath) {
   try {
     const content = await fs17.readFile(filePath, "utf-8");
-    let parsed;
-    try {
-      parsed = JSON.parse(content);
-    } catch (e) {
-      return {
-        isValid: false,
-        errors: [
-          `Invalid JSON: ${e instanceof Error ? e.message : "Unknown error"}`
-        ]
-      };
-    }
-    return validateCommandPlaybook(parsed);
+    return parseAndValidateCommandPlaybook(content);
   } catch (e) {
     return {
       isValid: false,
@@ -14157,7 +14271,20 @@ function buildWebappUrl(host, orgSlug, commandId) {
   return `${host}/org/${orgSlug}/space/global/commands/${commandId}`;
 }
 async function createCommandHandler(filePath, useCase, originSkill) {
-  const readResult = await readCommandPlaybookFile(filePath);
+  let readResult;
+  if (filePath) {
+    readResult = await readCommandPlaybookFile(filePath);
+  } else {
+    try {
+      const content = await readStdin();
+      readResult = parseAndValidateCommandPlaybook(content);
+    } catch (e) {
+      return {
+        success: false,
+        error: e instanceof Error ? e.message : "Failed to read from stdin"
+      };
+    }
+  }
   if (!readResult.isValid) {
     return {
       success: false,
@@ -14232,12 +14359,12 @@ var CreateCommandFromPlaybookUseCase = class {
 // apps/cli/src/infra/commands/CreateCommandCommand.ts
 var createCommandCommand = (0, import_cmd_ts16.command)({
   name: "create",
-  description: "Create a command from a playbook JSON file",
+  description: "Create a command from a playbook JSON file or stdin",
   args: {
     file: (0, import_cmd_ts16.positional)({
       displayName: "file",
-      description: "Path to the command playbook JSON file",
-      type: import_cmd_ts16.string
+      description: "Path to the command playbook JSON file (reads from stdin if omitted)",
+      type: (0, import_cmd_ts16.optional)(import_cmd_ts16.string)
     }),
     originSkill: originSkillOption
   },
@@ -14379,6 +14506,51 @@ function formatContentDiff(oldContent, newContent) {
   };
 }
 
+// apps/cli/src/infra/utils/editorMessage.ts
+var import_child_process4 = require("child_process");
+var import_fs19 = require("fs");
+var import_os2 = require("os");
+var import_path4 = require("path");
+var MAX_MESSAGE_LENGTH = 1024;
+var EDITOR_TEMPLATE = `
+# Enter a message describing the intent behind these changes.
+# Lines starting with '#' will be ignored.
+# An empty message aborts the submission.
+`;
+function openEditorForMessage() {
+  const tmpFile = (0, import_path4.join)((0, import_os2.tmpdir)(), `packmind-msg-${Date.now()}.txt`);
+  try {
+    (0, import_fs19.writeFileSync)(tmpFile, EDITOR_TEMPLATE, "utf-8");
+    const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+    const result = (0, import_child_process4.spawnSync)(editor, [tmpFile], {
+      stdio: "inherit"
+    });
+    if (result.status !== 0) {
+      throw new Error(`Editor exited with status ${result.status}`);
+    }
+    const content = (0, import_fs19.readFileSync)(tmpFile, "utf-8");
+    return content.split("\n").filter((line) => !line.startsWith("#")).join("\n").trim();
+  } finally {
+    try {
+      (0, import_fs19.unlinkSync)(tmpFile);
+    } catch {
+    }
+  }
+}
+function validateMessage(message) {
+  const trimmed = message.trim();
+  if (trimmed.length === 0) {
+    return { valid: false, error: "Message cannot be empty." };
+  }
+  if (trimmed.length > MAX_MESSAGE_LENGTH) {
+    return {
+      valid: false,
+      error: `Message exceeds maximum length of ${MAX_MESSAGE_LENGTH} characters (got ${trimmed.length}).`
+    };
+  }
+  return { valid: true, message: trimmed };
+}
+
 // apps/cli/src/infra/commands/diffArtefactsHandler.ts
 init_source();
 var ARTIFACT_TYPE_LABELS = {
@@ -14461,8 +14633,27 @@ function formatDiffPayload(diff, log) {
     log(line);
   }
 }
-async function diffArtefactsHandler(deps) {
-  const { packmindCliHexa, exit, getCwd, log, error, submit } = deps;
+function formatSubmittedDate(isoDate) {
+  const date = new Date(isoDate);
+  const datePart = date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+  const timePart = date.toLocaleTimeString("en-US", {
+    hour: "numeric",
+    minute: "2-digit",
+    hour12: true
+  });
+  return `${datePart} ${timePart}`;
+}
+function buildSubmittedFooter(submittedDiffs) {
+  const proposalCount = submittedDiffs.length;
+  const proposalWord = proposalCount === 1 ? "change proposal" : "change proposals";
+  return `${proposalCount} ${proposalWord} ignored, run \`packmind-cli diff --include-submitted\` to see what's waiting for validation`;
+}
+async function readConfigAndPackages(deps) {
+  const { packmindCliHexa, exit, getCwd, log, error } = deps;
   const cwd = getCwd();
   let configPackages;
   let configAgents;
@@ -14483,7 +14674,7 @@ async function diffArtefactsHandler(deps) {
     }
     error("\n\u{1F4A1} Please fix the packmind.json file or delete it to continue.");
     exit(1);
-    return { diffsFound: 0 };
+    return null;
   }
   if (configPackages.length === 0) {
     log("Usage: packmind-cli diff");
@@ -14491,37 +14682,219 @@ async function diffArtefactsHandler(deps) {
     log("Compare local command files against the server.");
     log("Configure packages in packmind.json first.");
     exit(0);
-    return { diffsFound: 0 };
+    return null;
   }
-  try {
-    let gitRemoteUrl;
-    let gitBranch;
-    let relativePath;
-    const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(cwd);
-    if (gitRoot) {
-      try {
-        gitRemoteUrl = packmindCliHexa.getGitRemoteUrlFromPath(gitRoot);
-        gitBranch = packmindCliHexa.getCurrentBranch(gitRoot);
-        relativePath = cwd.startsWith(gitRoot) ? cwd.slice(gitRoot.length) : "/";
-        if (!relativePath.startsWith("/")) {
-          relativePath = "/" + relativePath;
-        }
-        if (!relativePath.endsWith("/")) {
-          relativePath = relativePath + "/";
-        }
-      } catch (err) {
-        logWarningConsole(
-          `Failed to collect git info: ${err instanceof Error ? err.message : String(err)}`
-        );
+  return { configPackages, configAgents };
+}
+async function collectGitInfo(deps) {
+  const { packmindCliHexa, exit, getCwd, error } = deps;
+  const cwd = getCwd();
+  let gitRemoteUrl;
+  let gitBranch;
+  let relativePath;
+  const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(cwd);
+  if (gitRoot) {
+    try {
+      gitRemoteUrl = packmindCliHexa.getGitRemoteUrlFromPath(gitRoot);
+      gitBranch = packmindCliHexa.getCurrentBranch(gitRoot);
+      relativePath = cwd.startsWith(gitRoot) ? cwd.slice(gitRoot.length) : "/";
+      if (!relativePath.startsWith("/")) {
+        relativePath = "/" + relativePath;
+      }
+      if (!relativePath.endsWith("/")) {
+        relativePath = relativePath + "/";
       }
+    } catch (err) {
+      logWarningConsole(
+        `Failed to collect git info: ${err instanceof Error ? err.message : String(err)}`
+      );
     }
-    if (!gitRemoteUrl || !gitBranch || !relativePath) {
-      error(
-        "\n\u274C Could not determine git repository info. The diff command requires a git repository with a remote configured."
+  }
+  if (!gitRemoteUrl || !gitBranch || !relativePath) {
+    error(
+      "\n\u274C Could not determine git repository info. The diff command requires a git repository with a remote configured."
+    );
+    exit(1);
+    return null;
+  }
+  return { gitRemoteUrl, gitBranch, relativePath };
+}
+async function handleSubmission(params) {
+  const { packmindCliHexa, unsubmittedItems, messageFlag, exit } = params;
+  const unsubmittedDiffs = unsubmittedItems.map((r) => r.diff);
+  if (unsubmittedDiffs.length === 0) {
+    logInfoConsole("All changes already submitted.");
+    return false;
+  }
+  let message;
+  if (messageFlag !== void 0) {
+    const validation = validateMessage(messageFlag);
+    if (!validation.valid) {
+      logErrorConsole(validation.error);
+      exit(1);
+      return true;
+    }
+    message = validation.message;
+  } else if (process.stdin.isTTY) {
+    const editorMessage = openEditorForMessage();
+    const validation = validateMessage(editorMessage);
+    if (!validation.valid) {
+      logErrorConsole(
+        "Aborting submission: empty message. Use -m to provide a message."
       );
       exit(1);
+      return true;
+    }
+    message = validation.message;
+  } else {
+    logErrorConsole(
+      'Non-interactive mode requires -m flag. Use: packmind-cli diff --submit -m "your message"'
+    );
+    exit(1);
+    return true;
+  }
+  const groupedUnsubmitted = Array.from(
+    groupDiffsByArtefact(unsubmittedDiffs).values()
+  );
+  const result = await packmindCliHexa.submitDiffs(groupedUnsubmitted, message);
+  for (const err of result.errors) {
+    if (err.code === "ChangeProposalPayloadMismatchError") {
+      logErrorConsole(
+        `Failed to submit "${err.name}": ${err.artifactType ?? "artifact"} is outdated, please run \`packmind-cli install\` to update it`
+      );
+    } else {
+      logErrorConsole(`Failed to submit "${err.name}": ${err.message}`);
+    }
+  }
+  if (result.submitted > 0) {
+    const truncatedMessage = message.length > 50 ? message.slice(0, 50) + "..." : message;
+    logInfoConsole(`Message: "${truncatedMessage}"`);
+  }
+  const summaryParts = [];
+  if (result.submitted > 0) {
+    summaryParts.push(`${result.submitted} submitted`);
+  }
+  if (result.alreadySubmitted > 0) {
+    summaryParts.push(`${result.alreadySubmitted} already submitted`);
+  }
+  if (result.errors.length > 0) {
+    const errorWord = result.errors.length === 1 ? "error" : "errors";
+    summaryParts.push(`${result.errors.length} ${errorWord}`);
+  }
+  if (summaryParts.length > 0) {
+    const summaryMessage = `Summary: ${summaryParts.join(", ")}`;
+    if (result.errors.length === 0 && result.alreadySubmitted === 0) {
+      logSuccessConsole(summaryMessage);
+    } else if (result.errors.length > 0 && result.submitted > 0 || result.alreadySubmitted > 0) {
+      logWarningConsole(summaryMessage);
+    } else {
+      logErrorConsole(summaryMessage);
+    }
+  }
+  return false;
+}
+function extractUniqueAndSortedArtefacts(groups) {
+  const typeSortOrder = {
+    command: 0,
+    skill: 1,
+    standard: 2
+  };
+  const uniqueArtefacts = /* @__PURE__ */ new Map();
+  for (const [key, groupDiffs] of groups) {
+    if (!uniqueArtefacts.has(key)) {
+      uniqueArtefacts.set(key, {
+        type: groupDiffs[0].artifactType,
+        name: groupDiffs[0].artifactName
+      });
+    }
+  }
+  const sortedArtefacts = Array.from(uniqueArtefacts.values()).sort(
+    (a, b) => typeSortOrder[a.type] - typeSortOrder[b.type] || a.name.localeCompare(b.name, void 0, { sensitivity: "base" })
+  );
+  return sortedArtefacts;
+}
+function displayDiffs(params) {
+  const {
+    diffsToDisplay,
+    submittedLookup,
+    includeSubmitted,
+    unsubmittedItems,
+    submittedItems,
+    log
+  } = params;
+  log(formatHeader(`
+Changes found:
+`));
+  const groups = groupDiffsByArtefact(diffsToDisplay);
+  for (const [, groupDiffs] of groups) {
+    const { artifactType, artifactName } = groupDiffs[0];
+    const typeLabel = ARTIFACT_TYPE_LABELS[artifactType];
+    log(formatBold(`${typeLabel} "${artifactName}"`));
+    const subGroups = subGroupByChangeContent(groupDiffs);
+    for (const subGroup of subGroups) {
+      for (const diff of subGroup) {
+        log(`  ${formatFilePath(diff.filePath)}`);
+      }
+      const label = CHANGE_PROPOSAL_TYPE_LABELS[subGroup[0].type] ?? "content changed";
+      const checkItem = submittedLookup.get(subGroup[0]);
+      if (includeSubmitted && checkItem?.exists && checkItem.createdAt) {
+        const dateStr = formatSubmittedDate(checkItem.createdAt);
+        const messageSuffix = checkItem.message ? ` "${checkItem.message.length > 50 ? checkItem.message.slice(0, 50) + "..." : checkItem.message}"` : "";
+        log(
+          `  - ${label} ${source_default.dim(`[already submitted on ${dateStr}${messageSuffix}]`)}`
+        );
+      } else {
+        log(`  - ${label}`);
+      }
+      formatDiffPayload(subGroup[0], log);
+    }
+    log("");
+  }
+  const changeCount = diffsToDisplay.length;
+  const changeWord = changeCount === 1 ? "change" : "changes";
+  const sortedArtefacts = extractUniqueAndSortedArtefacts(groups);
+  const artefactCount = sortedArtefacts.length;
+  const artefactWord = artefactCount === 1 ? "artefact" : "artefacts";
+  const allSubmittedSuffix = includeSubmitted && unsubmittedItems.length === 0 ? " (all already submitted)" : "";
+  logWarningConsole(
+    `Summary: ${changeCount} ${changeWord} found on ${artefactCount} ${artefactWord}${allSubmittedSuffix}:`
+  );
+  for (const artefact of sortedArtefacts) {
+    const typeLabel = ARTIFACT_TYPE_LABELS[artefact.type];
+    const key = `${artefact.type}:${artefact.name}`;
+    const artefactDiffs = groups.get(key) ?? [];
+    const allDiffsSubmitted = includeSubmitted && artefactDiffs.length > 0 && artefactDiffs.every((d) => submittedLookup.get(d)?.exists);
+    const suffix = allDiffsSubmitted ? " (all already submitted)" : "";
+    logWarningConsole(`* ${typeLabel} "${artefact.name}"${suffix}`);
+  }
+  if (!includeSubmitted && submittedItems.length > 0) {
+    logInfoConsole(buildSubmittedFooter(submittedItems));
+  }
+  return changeCount;
+}
+async function diffArtefactsHandler(deps) {
+  const {
+    packmindCliHexa,
+    exit,
+    getCwd,
+    log,
+    error,
+    submit,
+    includeSubmitted,
+    message: messageFlag
+  } = deps;
+  const cwd = getCwd();
+  const config = await readConfigAndPackages(deps);
+  if (!config) {
+    return { diffsFound: 0 };
+  }
+  const { configPackages, configAgents } = config;
+  try {
+    const gitInfo = await collectGitInfo(deps);
+    if (!gitInfo) {
       return { diffsFound: 0 };
     }
+    const { gitRemoteUrl, gitBranch, relativePath } = gitInfo;
     const packageCount = configPackages.length;
     const packageWord = packageCount === 1 ? "package" : "packages";
     logInfoConsole(
@@ -14543,85 +14916,43 @@ async function diffArtefactsHandler(deps) {
       exit(0);
       return { diffsFound: 0 };
     }
-    log(formatHeader(`
-Changes found:
-`));
-    const groups = groupDiffsByArtefact(diffs);
-    for (const [, groupDiffs] of groups) {
-      const { artifactType, artifactName } = groupDiffs[0];
-      const typeLabel = ARTIFACT_TYPE_LABELS[artifactType];
-      log(formatBold(`${typeLabel} "${artifactName}"`));
-      const subGroups = subGroupByChangeContent(groupDiffs);
-      for (const subGroup of subGroups) {
-        for (const diff of subGroup) {
-          log(`  ${formatFilePath(diff.filePath)}`);
-        }
-        const label = CHANGE_PROPOSAL_TYPE_LABELS[subGroup[0].type] ?? "content changed";
-        log(`  - ${label}`);
-        formatDiffPayload(subGroup[0], log);
-      }
-      log("");
+    const allGroupedDiffs = Array.from(groupDiffsByArtefact(diffs).values());
+    const checkResult = await packmindCliHexa.checkDiffs(allGroupedDiffs);
+    const submittedItems = checkResult.results.filter((r) => r.exists);
+    const unsubmittedItems = checkResult.results.filter((r) => !r.exists);
+    const diffsToDisplay = includeSubmitted ? diffs : unsubmittedItems.map((r) => r.diff);
+    const submittedLookup = /* @__PURE__ */ new Map();
+    for (const item of checkResult.results) {
+      submittedLookup.set(item.diff, item);
     }
-    const changeCount = diffs.length;
-    const changeWord = changeCount === 1 ? "change" : "changes";
-    const typeSortOrder = {
-      command: 0,
-      skill: 1,
-      standard: 2
-    };
-    const uniqueArtefacts = /* @__PURE__ */ new Map();
-    for (const [key, groupDiffs] of groups) {
-      if (!uniqueArtefacts.has(key)) {
-        uniqueArtefacts.set(key, {
-          type: groupDiffs[0].artifactType,
-          name: groupDiffs[0].artifactName
-        });
+    if (diffsToDisplay.length === 0) {
+      log("No new changes found.");
+      if (submittedItems.length > 0) {
+        logInfoConsole(buildSubmittedFooter(submittedItems));
       }
+      if (submit) {
+        logInfoConsole("All changes already submitted.");
+      }
+      exit(0);
+      return { diffsFound: 0 };
     }
-    const sortedArtefacts = Array.from(uniqueArtefacts.values()).sort(
-      (a, b) => typeSortOrder[a.type] - typeSortOrder[b.type] || a.name.localeCompare(b.name, void 0, { sensitivity: "base" })
-    );
-    const artefactCount = sortedArtefacts.length;
-    const artefactWord = artefactCount === 1 ? "artefact" : "artefacts";
-    logWarningConsole(
-      `Summary: ${changeCount} ${changeWord} found on ${artefactCount} ${artefactWord}:`
-    );
-    for (const artefact of sortedArtefacts) {
-      const typeLabel = ARTIFACT_TYPE_LABELS[artefact.type];
-      logWarningConsole(`* ${typeLabel} "${artefact.name}"`);
-    }
+    const changeCount = displayDiffs({
+      diffsToDisplay,
+      submittedLookup,
+      includeSubmitted,
+      unsubmittedItems,
+      submittedItems,
+      log
+    });
     if (submit) {
-      const groupedDiffs = Array.from(groupDiffsByArtefact(diffs).values());
-      const result = await packmindCliHexa.submitDiffs(groupedDiffs);
-      for (const err of result.errors) {
-        if (err.code === "ChangeProposalPayloadMismatchError") {
-          logErrorConsole(
-            `Failed to submit "${err.name}": ${err.artifactType ?? "artifact"} is outdated, please run \`packmind-cli install\` to update it`
-          );
-        } else {
-          logErrorConsole(`Failed to submit "${err.name}": ${err.message}`);
-        }
-      }
-      const summaryParts = [];
-      if (result.submitted > 0) {
-        summaryParts.push(`${result.submitted} submitted`);
-      }
-      if (result.alreadySubmitted > 0) {
-        summaryParts.push(`${result.alreadySubmitted} already submitted`);
-      }
-      if (result.errors.length > 0) {
-        const errorWord = result.errors.length === 1 ? "error" : "errors";
-        summaryParts.push(`${result.errors.length} ${errorWord}`);
-      }
-      if (summaryParts.length > 0) {
-        const summaryMessage = `Summary: ${summaryParts.join(", ")}`;
-        if (result.errors.length === 0 && result.alreadySubmitted === 0) {
-          logSuccessConsole(summaryMessage);
-        } else if (result.errors.length > 0 && result.submitted > 0 || result.alreadySubmitted > 0) {
-          logWarningConsole(summaryMessage);
-        } else {
-          logErrorConsole(summaryMessage);
-        }
+      const aborted = await handleSubmission({
+        packmindCliHexa,
+        unsubmittedItems,
+        messageFlag,
+        exit
+      });
+      if (aborted) {
+        return { diffsFound: changeCount };
       }
     }
     exit(0);
@@ -14646,9 +14977,19 @@ var diffCommand = (0, import_cmd_ts19.command)({
     submit: (0, import_cmd_ts19.flag)({
       long: "submit",
       description: "Submit detected changes as change proposals"
+    }),
+    includeSubmitted: (0, import_cmd_ts19.flag)({
+      long: "include-submitted",
+      description: "Include already submitted changes in the output"
+    }),
+    message: (0, import_cmd_ts19.option)({
+      long: "message",
+      short: "m",
+      description: "Message describing the intent behind the changes (max 1024 chars)",
+      type: (0, import_cmd_ts19.optional)(import_cmd_ts19.string)
     })
   },
-  handler: async ({ submit }) => {
+  handler: async ({ submit, includeSubmitted, message }) => {
     const packmindLogger = new PackmindLogger("PackmindCLI", "info" /* INFO */);
     const packmindCliHexa = new PackmindCliHexa(packmindLogger);
     await diffArtefactsHandler({
@@ -14657,7 +14998,9 @@ var diffCommand = (0, import_cmd_ts19.command)({
       getCwd: () => process.cwd(),
       log: console.log,
       error: console.error,
-      submit
+      submit,
+      includeSubmitted,
+      message
     });
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@packmind/cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "A command-line interface for Packmind linting and code quality checks",
   "private": false,
   "bin": {