@packmind/cli 0.21.1 → 0.22.0

package/main.cjs

@@ -3852,7 +3852,7 @@ var require_package = __commonJS({
   "apps/cli/package.json"(exports2, module2) {
     module2.exports = {
       name: "@packmind/cli",
-      version: "0.21.1",
+      version: "0.22.0",
       description: "A command-line interface for Packmind linting and code quality checks",
       private: false,
       bin: {
@@ -4265,6 +4265,13 @@ var createDistributionId = brandedIdFactory();
 // packages/types/src/deployments/DistributedPackageId.ts
 var createDistributedPackageId = brandedIdFactory();
 
+// packages/types/src/deployments/events/ArtefactRemovedFromPackageEvent.ts
+var ArtefactRemovedFromPackageEvent = class extends UserEvent {
+  static {
+    this.eventName = "deployments.artefact.removed";
+  }
+};
+
 // packages/types/src/deployments/events/ArtifactsPulledEvent.ts
 var ArtifactsPulledEvent = class extends UserEvent {
   static {
@@ -5131,6 +5138,7 @@ var ExecuteSingleFileAstUseCase = class _ExecuteSingleFileAstUseCase {
 
 // apps/cli/src/application/services/GitService.ts
 var import_child_process = require("child_process");
+var import_fs = require("fs");
 var path = __toESM(require("path"));
 
 // apps/cli/src/application/utils/pathUtils.ts
@@ -5157,30 +5165,30 @@ var GitService = class {
     this.gitRunner = gitRunner;
     this.logger = logger2;
   }
-  getGitRepositoryRoot(path22) {
+  getGitRepositoryRoot(path25) {
     try {
       const { stdout } = this.gitRunner("rev-parse --show-toplevel", {
-        cwd: path22
+        cwd: path25
       });
       const gitRoot = stdout.trim();
       this.logger.debug("Resolved git repository root", {
-        inputPath: path22,
+        inputPath: path25,
         gitRoot
       });
       return gitRoot;
     } catch (error) {
       if (error instanceof Error) {
         throw new Error(
-          `Failed to get Git repository root. The path '${path22}' does not appear to be inside a Git repository.
+          `Failed to get Git repository root. The path '${path25}' does not appear to be inside a Git repository.
 ${error.message}`
         );
       }
       throw new Error("Failed to get Git repository root: Unknown error");
     }
   }
-  tryGetGitRepositoryRoot(path22) {
+  tryGetGitRepositoryRoot(path25) {
     try {
-      return this.getGitRepositoryRoot(path22);
+      return this.getGitRepositoryRoot(path25);
     } catch {
       return null;
     }
@@ -5467,15 +5475,10 @@ ${error.message}`
    */
   countFileLines(filePath) {
     try {
-      const stdout = (0, import_child_process.execSync)(`wc -l < "${filePath}"`, { encoding: "utf-8" });
-      const count = parseInt(stdout.trim(), 10);
-      if (count === 0) {
-        const content = (0, import_child_process.execSync)(`head -c 1 "${filePath}"`, {
-          encoding: "utf-8"
-        });
-        return content.length > 0 ? 1 : 0;
-      }
-      return count;
+      const content = (0, import_fs.readFileSync)(filePath, "utf-8");
+      if (content.length === 0) return 0;
+      const newlines = (content.match(/\n/g) ?? []).length;
+      return content.endsWith("\n") ? newlines : newlines + 1;
     } catch {
       return 0;
     }
@@ -5541,6 +5544,13 @@ function formatCommand(text) {
 }
 
 // apps/cli/src/application/services/ListFiles.ts
+var DEFAULT_EXCLUDES = [
+  "node_modules",
+  "dist",
+  "*.min.*",
+  "*.map",
+  ".git"
+];
 var ListFiles = class {
   async listFilesInDirectory(directoryPath, extensions, excludes = [], skipHidden = true) {
     const results = [];
@@ -5605,28 +5615,28 @@ var ListFiles = class {
     }
     const normalizedPath = path2.normalize(filePath).replace(/\\/g, "/");
     for (const exclude of excludes) {
-      if (this.matchesGlobPattern(normalizedPath, exclude)) {
+      if (matchesGlobPattern(normalizedPath, exclude)) {
         return true;
       }
     }
     return false;
   }
-  matchesGlobPattern(filePath, pattern) {
-    if (!pattern.includes("*") && !pattern.includes("/")) {
-      const pathSegments = filePath.split("/");
-      return pathSegments.some((segment) => segment === pattern);
-    }
-    let regexPattern = pattern.replace(/\*\*/g, "__DOUBLE_STAR__").replace(/\*/g, "[^/]*").replace(/__DOUBLE_STAR__/g, ".*").replace(/\//g, "\\/");
-    if (!pattern.startsWith("**/")) {
-      regexPattern = "(^|/)" + regexPattern;
-    }
-    if (!pattern.endsWith("/**")) {
-      regexPattern = regexPattern + "($|/)";
-    }
-    const regex2 = new RegExp(regexPattern);
-    return regex2.test(filePath);
-  }
 };
+function matchesGlobPattern(filePath, pattern) {
+  if (!pattern.includes("*") && !pattern.includes("/")) {
+    const pathSegments = filePath.split("/");
+    return pathSegments.some((segment) => segment === pattern);
+  }
+  let regexPattern = pattern.replace(/[.[\](){}^$+?|\\]/g, "\\$&").replace(/\*\*/g, "__DOUBLE_STAR__").replace(/\*/g, "[^/]*").replace(/__DOUBLE_STAR__/g, ".*").replace(/\//g, "\\/");
+  if (!pattern.startsWith("**/")) {
+    regexPattern = "(^|/)" + regexPattern;
+  }
+  if (!pattern.endsWith("/**")) {
+    regexPattern = regexPattern + "($|/)";
+  }
+  const regex2 = new RegExp(regexPattern);
+  return regex2.test(filePath);
+}
 
 // apps/cli/src/application/useCases/ListFilesInDirectoryUseCase.ts
 var ListFilesInDirectoryUseCase = class {
@@ -5746,7 +5756,8 @@ var LintFilesAgainstRuleUseCase = class {
       standardSlug,
       ruleId,
       language,
-      diffMode
+      diffMode,
+      ignorePatterns
     } = command22;
     this.logger.debug(
       `Starting linting: path="${userPath}", draftMode=${!!draftMode}, standardSlug="${standardSlug || "N/A"}", ruleId="${ruleId || "N/A"}", language="${language || "N/A"}", diffMode="${diffMode ?? "none"}"`
@@ -5814,10 +5825,14 @@ var LintFilesAgainstRuleUseCase = class {
         }
       }
     }
+    const excludes = [...DEFAULT_EXCLUDES];
+    if (ignorePatterns?.length) {
+      excludes.push(...ignorePatterns);
+    }
     let files = isFile ? [{ path: absoluteLintPath }] : await this.services.listFiles.listFilesInDirectory(
       absoluteLintPath,
       [],
-      ["node_modules", "dist", ".min.", ".map.", ".git"]
+      excludes
     );
     if (modifiedFiles) {
       const modifiedFilesSet = new Set(modifiedFiles);
@@ -5911,6 +5926,7 @@ var LintFilesAgainstRuleUseCase = class {
     }).catch(() => {
     });
     const violations = [];
+    let scopeMatchCount = 0;
     for (const file of files) {
       const fileViolations = [];
       const relativeFilePath = pathStartsWith(file.path, effectiveRoot) ? file.path.substring(effectiveRoot.length) : file.path;
@@ -5947,6 +5963,7 @@ var LintFilesAgainstRuleUseCase = class {
               `File "${normalizedFilePath}" matches target/scope - processing standard "${standard.name}"`
             );
           }
+          scopeMatchCount++;
           for (const rule of standard.rules) {
             for (const activeProgram of rule.activeDetectionPrograms) {
               try {
@@ -6014,6 +6031,11 @@ var LintFilesAgainstRuleUseCase = class {
         });
       }
     }
+    if (isFile && scopeMatchCount === 0) {
+      logInfoConsole(
+        `File "${absoluteUserPath}" is out of scope for the requested rule/standard \u2014 no violations will be reported.`
+      );
+    }
     let filteredViolations = violations;
     if (diffMode === "lines" /* LINES */ && modifiedLines) {
       filteredViolations = this.services.diffViolationFilterService.filterByLines(
@@ -6111,7 +6133,7 @@ var LintFilesFromConfigUseCase = class {
     return pattern;
   }
   async execute(command22) {
-    const { path: userPath, diffMode } = command22;
+    const { path: userPath, diffMode, ignorePatterns } = command22;
     this.logger.debug(
       `Starting local linting: path="${userPath}", diffMode="${diffMode ?? "none"}"`
     );
@@ -6185,10 +6207,14 @@ var LintFilesFromConfigUseCase = class {
         `Using config: ${config.absoluteTargetPath}/packmind.json (target: ${config.targetPath})`
       );
     }
+    const excludes = [...DEFAULT_EXCLUDES];
+    if (ignorePatterns?.length) {
+      excludes.push(...ignorePatterns);
+    }
     let files = isFile ? [{ path: absoluteUserPath }] : await this.services.listFiles.listFilesInDirectory(
       absoluteUserPath,
       [],
-      ["node_modules", "dist", ".min.", ".map.", ".git"]
+      excludes
     );
     if (modifiedFiles) {
       const modifiedFilesSet = new Set(modifiedFiles);
@@ -6434,10 +6460,10 @@ var PackmindHttpClient = class {
       return null;
     }
   }
-  async request(path22, options = {}) {
+  async request(path25, options = {}) {
     const { host } = this.getAuthContext();
     const { method = "GET", body } = options;
-    const url = `${host}${path22}`;
+    const url = `${host}${path25}`;
     try {
       const response = await fetch(url, {
         method,
@@ -6831,6 +6857,19 @@ var DeploymentGateway = class {
         }
       );
     };
+    this.getContentByVersions = async (command22) => {
+      const { organizationId } = this.httpClient.getAuthContext();
+      return this.httpClient.request(
+        `/api/v0/organizations/${organizationId}/content-by-versions`,
+        {
+          method: "POST",
+          body: {
+            artifacts: command22.artifacts,
+            ...command22.agents !== void 0 && { agents: command22.agents }
+          }
+        }
+      );
+    };
     this.notifyDistribution = async (command22) => {
       const { organizationId } = this.httpClient.getAuthContext();
       return this.httpClient.request(
@@ -6950,7 +6989,7 @@ var ParserInitializationError = class extends Error {
 
 // packages/linter-ast/src/core/BaseParser.ts
 var import_path = require("path");
-var import_fs = require("fs");
+var import_fs2 = require("fs");
 var BaseParser = class _BaseParser {
   constructor() {
     this.initialized = false;
@@ -6998,7 +7037,7 @@ var BaseParser = class _BaseParser {
     return (fileName) => {
       for (const dir of wasmDirs) {
         const fullPath = (0, import_path.join)(dir, fileName);
-        if ((0, import_fs.existsSync)(fullPath)) {
+        if ((0, import_fs2.existsSync)(fullPath)) {
           return fullPath;
         }
       }
@@ -7036,7 +7075,7 @@ var BaseParser = class _BaseParser {
 
 // packages/linter-ast/src/parsers/TypeScriptParser.ts
 var TreeSitter = __toESM(require("web-tree-sitter"));
-var import_fs2 = require("fs");
+var import_fs3 = require("fs");
 var TypeScriptParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7046,7 +7085,7 @@ var TypeScriptParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("typescript");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs2.existsSync)(wasmPath)) {
+        if ((0, import_fs3.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter.Language.load(wasmPath);
             break;
@@ -7129,7 +7168,7 @@ var TypeScriptParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/JavaScriptParser.ts
 var TreeSitter2 = __toESM(require("web-tree-sitter"));
-var import_fs3 = require("fs");
+var import_fs4 = require("fs");
 var JavaScriptParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7139,7 +7178,7 @@ var JavaScriptParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("javascript");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs3.existsSync)(wasmPath)) {
+        if ((0, import_fs4.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter2.Language.load(wasmPath);
             break;
@@ -7222,7 +7261,7 @@ var JavaScriptParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/CPPParser.ts
 var TreeSitter3 = __toESM(require("web-tree-sitter"));
-var import_fs4 = require("fs");
+var import_fs5 = require("fs");
 var CPPParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7232,7 +7271,7 @@ var CPPParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("cpp");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs4.existsSync)(wasmPath)) {
+        if ((0, import_fs5.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter3.Language.load(wasmPath);
             break;
@@ -7303,7 +7342,7 @@ var CPPParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/GoParser.ts
 var TreeSitter4 = __toESM(require("web-tree-sitter"));
-var import_fs5 = require("fs");
+var import_fs6 = require("fs");
 var GoParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7313,7 +7352,7 @@ var GoParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("go");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs5.existsSync)(wasmPath)) {
+        if ((0, import_fs6.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter4.Language.load(wasmPath);
             break;
@@ -7384,7 +7423,7 @@ var GoParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/KotlinParser.ts
 var TreeSitter5 = __toESM(require("web-tree-sitter"));
-var import_fs6 = require("fs");
+var import_fs7 = require("fs");
 var KotlinParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7394,7 +7433,7 @@ var KotlinParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("kotlin");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs6.existsSync)(wasmPath)) {
+        if ((0, import_fs7.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter5.Language.load(wasmPath);
             break;
@@ -7471,7 +7510,7 @@ var KotlinParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/CSSParser.ts
 var TreeSitter6 = __toESM(require("web-tree-sitter"));
-var import_fs7 = require("fs");
+var import_fs8 = require("fs");
 var CSSParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7481,7 +7520,7 @@ var CSSParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("css");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs7.existsSync)(wasmPath)) {
+        if ((0, import_fs8.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter6.Language.load(wasmPath);
             break;
@@ -7552,7 +7591,7 @@ var CSSParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/CSharpParser.ts
 var TreeSitter7 = __toESM(require("web-tree-sitter"));
-var import_fs8 = require("fs");
+var import_fs9 = require("fs");
 var CSharpParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7562,7 +7601,7 @@ var CSharpParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("c_sharp");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs8.existsSync)(wasmPath)) {
+        if ((0, import_fs9.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter7.Language.load(wasmPath);
             break;
@@ -7639,7 +7678,7 @@ var CSharpParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/PHPParser.ts
 var TreeSitter8 = __toESM(require("web-tree-sitter"));
-var import_fs9 = require("fs");
+var import_fs10 = require("fs");
 var PHPParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7651,7 +7690,7 @@ var PHPParser = class extends BaseParser {
         BaseParser.getLanguageWasmPaths("php")
       );
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs9.existsSync)(wasmPath)) {
+        if ((0, import_fs10.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter8.Language.load(wasmPath);
             break;
@@ -7723,7 +7762,7 @@ var PHPParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/PythonParser.ts
 var TreeSitter9 = __toESM(require("web-tree-sitter"));
-var import_fs10 = require("fs");
+var import_fs11 = require("fs");
 var PythonParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7733,7 +7772,7 @@ var PythonParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("python");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs10.existsSync)(wasmPath)) {
+        if ((0, import_fs11.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter9.Language.load(wasmPath);
             break;
@@ -7810,7 +7849,7 @@ var PythonParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/RubyParser.ts
 var TreeSitter10 = __toESM(require("web-tree-sitter"));
-var import_fs11 = require("fs");
+var import_fs12 = require("fs");
 var RubyParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7820,7 +7859,7 @@ var RubyParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("ruby");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs11.existsSync)(wasmPath)) {
+        if ((0, import_fs12.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter10.Language.load(wasmPath);
             break;
@@ -7897,7 +7936,7 @@ var RubyParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/JSONParser.ts
 var TreeSitter11 = __toESM(require("web-tree-sitter"));
-var import_fs12 = require("fs");
+var import_fs13 = require("fs");
 var JSONParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7907,7 +7946,7 @@ var JSONParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("json");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs12.existsSync)(wasmPath)) {
+        if ((0, import_fs13.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter11.Language.load(wasmPath);
             break;
@@ -7984,7 +8023,7 @@ var JSONParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/HTMLParser.ts
 var TreeSitter12 = __toESM(require("web-tree-sitter"));
-var import_fs13 = require("fs");
+var import_fs14 = require("fs");
 var HTMLParser = class extends BaseParser {
   async initialize() {
     try {
@@ -7994,7 +8033,7 @@ var HTMLParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("html");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs13.existsSync)(wasmPath)) {
+        if ((0, import_fs14.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter12.Language.load(wasmPath);
             break;
@@ -8071,7 +8110,7 @@ var HTMLParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/JavaParser.ts
 var TreeSitter13 = __toESM(require("web-tree-sitter"));
-var import_fs14 = require("fs");
+var import_fs15 = require("fs");
 var JavaParser = class extends BaseParser {
   async initialize() {
     try {
@@ -8081,7 +8120,7 @@ var JavaParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("java");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs14.existsSync)(wasmPath)) {
+        if ((0, import_fs15.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter13.Language.load(wasmPath);
             break;
@@ -8158,7 +8197,7 @@ var JavaParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/SwiftParser.ts
 var TreeSitter14 = __toESM(require("web-tree-sitter"));
-var import_fs15 = require("fs");
+var import_fs16 = require("fs");
 var SwiftParser = class extends BaseParser {
   async initialize() {
     try {
@@ -8168,7 +8207,7 @@ var SwiftParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("swift");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs15.existsSync)(wasmPath)) {
+        if ((0, import_fs16.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter14.Language.load(wasmPath);
             break;
@@ -8245,7 +8284,7 @@ var SwiftParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/SCSSParser.ts
 var TreeSitter15 = __toESM(require("web-tree-sitter"));
-var import_fs16 = require("fs");
+var import_fs17 = require("fs");
 var SCSSParser = class extends BaseParser {
   async initialize() {
     try {
@@ -8255,7 +8294,7 @@ var SCSSParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("scss");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs16.existsSync)(wasmPath)) {
+        if ((0, import_fs17.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter15.Language.load(wasmPath);
             break;
@@ -8332,7 +8371,7 @@ var SCSSParser = class extends BaseParser {
 
 // packages/linter-ast/src/parsers/YAMLParser.ts
 var TreeSitter16 = __toESM(require("web-tree-sitter"));
-var import_fs17 = require("fs");
+var import_fs18 = require("fs");
 var YAMLParser = class extends BaseParser {
   async initialize() {
     try {
@@ -8342,7 +8381,7 @@ var YAMLParser = class extends BaseParser {
       });
       const wasmPaths = BaseParser.getLanguageWasmPaths("yaml");
       for (const wasmPath of wasmPaths) {
-        if ((0, import_fs17.existsSync)(wasmPath)) {
+        if ((0, import_fs18.existsSync)(wasmPath)) {
           try {
             lang = await TreeSitter16.Language.load(wasmPath);
             break;
@@ -9346,6 +9385,36 @@ function parseSkillMd(content) {
   };
 }
 
+// apps/cli/src/application/utils/resolveArtefactFromPath.ts
+function resolveArtefactFromPath(filePath) {
+  const normalized = normalizePath(filePath);
+  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
+    if (paths.command && normalized.includes(paths.command)) {
+      return {
+        artifactType: "command",
+        codingAgent: agent
+      };
+    }
+  }
+  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
+    if (paths.standard && normalized.includes(paths.standard)) {
+      return {
+        artifactType: "standard",
+        codingAgent: agent
+      };
+    }
+  }
+  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
+    if (paths.skill && normalized.includes(paths.skill)) {
+      return {
+        artifactType: "skill",
+        codingAgent: agent
+      };
+    }
+  }
+  return null;
+}
+
 // apps/cli/src/application/useCases/InstallPackagesUseCase.ts
 var fs4 = __toESM(require("fs/promises"));
 var path5 = __toESM(require("path"));
@@ -9382,8 +9451,9 @@ function parsePermissionString(permString) {
 
 // apps/cli/src/application/useCases/InstallPackagesUseCase.ts
 var InstallPackagesUseCase = class {
-  constructor(packmindGateway) {
+  constructor(packmindGateway, lockFileRepository) {
     this.packmindGateway = packmindGateway;
+    this.lockFileRepository = lockFileRepository;
   }
   async execute(command22) {
     const baseDirectory = command22.baseDirectory || process.cwd();
@@ -9450,12 +9520,76 @@ var InstallPackagesUseCase = class {
           result.errors.push(`Failed to delete ${file.path}: ${errorMsg}`);
         }
       }
+      const lockFile = this.buildLockFile(
+        filteredCreateOrUpdate,
+        command22.packagesSlugs,
+        command22.cliVersion,
+        command22.agents,
+        response.targetId,
+        response.resolvedAgents
+      );
+      if (Object.keys(lockFile.artifacts).length > 0) {
+        try {
+          await this.lockFileRepository.write(baseDirectory, lockFile);
+        } catch (error) {
+          const errorMsg = error instanceof Error ? error.message : String(error);
+          result.errors.push(`Failed to write lock file: ${errorMsg}`);
+        }
+      } else {
+        try {
+          await this.lockFileRepository.delete(baseDirectory);
+        } catch (error) {
+          const errorMsg = error instanceof Error ? error.message : String(error);
+          result.errors.push(`Failed to delete lock file: ${errorMsg}`);
+        }
+      }
     } catch (error) {
       const errorMsg = error instanceof Error ? error.message : String(error);
       result.errors.push(`Failed to install packages: ${errorMsg}`);
     }
     return result;
   }
+  buildLockFile(files, packageSlugs, cliVersion, commandAgents, targetId, resolvedAgents) {
+    const artifacts = {};
+    for (const file of files) {
+      if (!file.artifactType || !file.artifactName || !file.artifactSlug || !file.artifactId || file.artifactVersion === void 0 || !file.spaceId) {
+        continue;
+      }
+      const artifactKey = `${file.artifactType}:${file.artifactSlug}`;
+      if (!artifacts[artifactKey]) {
+        artifacts[artifactKey] = {
+          type: file.artifactType,
+          name: file.artifactName,
+          id: file.artifactId,
+          version: file.artifactVersion,
+          spaceId: file.spaceId,
+          packageIds: file.packageIds ?? [],
+          files: []
+        };
+      }
+      const resolved = resolveArtefactFromPath(file.path);
+      if (resolved) {
+        const isSkillDefinition = resolved.artifactType === "skill" && !file.skillFileId;
+        artifacts[artifactKey].files.push({
+          path: file.path,
+          agent: resolved.codingAgent,
+          ...isSkillDefinition ? { isSkillDefinition: true } : {}
+        });
+      }
+    }
+    const agents = [
+      ...commandAgents?.length ? commandAgents : resolvedAgents ?? []
+    ].sort((a, b) => a.localeCompare(b));
+    return {
+      lockfileVersion: 1,
+      packageSlugs: [...packageSlugs].sort((a, b) => a.localeCompare(b)),
+      agents,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      cliVersion: cliVersion ?? "unknown",
+      ...targetId ? { targetId } : {},
+      artifacts
+    };
+  }
   async createOrUpdateFile(baseDirectory, file, result, skillFilePermissions) {
     const fullPath = path5.join(baseDirectory, file.path);
     const directory = path5.dirname(fullPath);
@@ -9541,12 +9675,12 @@ var InstallPackagesUseCase = class {
   }
   async deleteFile(baseDirectory, filePath, result) {
     const fullPath = path5.join(baseDirectory, filePath);
-    const stat5 = await fs4.stat(fullPath).catch(() => null);
-    if (stat5?.isDirectory()) {
+    const stat7 = await fs4.stat(fullPath).catch(() => null);
+    if (stat7?.isDirectory()) {
       await fs4.rm(fullPath, { recursive: true, force: true });
       result.filesDeleted++;
       await this.removeEmptyParentDirectories(fullPath, baseDirectory);
-    } else if (stat5?.isFile()) {
+    } else if (stat7?.isFile()) {
       await fs4.unlink(fullPath);
       result.filesDeleted++;
       await this.removeEmptyParentDirectories(fullPath, baseDirectory);
@@ -9958,10 +10092,10 @@ async function defaultPromptForCode() {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve9) => {
+  return new Promise((resolve11) => {
     rl.question("Enter the login code from the browser: ", (answer) => {
       rl.close();
-      resolve9(answer.trim());
+      resolve11(answer.trim());
     });
   });
 }
@@ -9995,7 +10129,7 @@ async function defaultExchangeCodeForApiKey(code, host) {
   return await response.json();
 }
 function defaultStartCallbackServer() {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve11, reject) => {
     let timeoutId = null;
     const server = http.createServer((req, res) => {
       res.setHeader("Access-Control-Allow-Origin", "*");
@@ -10008,7 +10142,7 @@ function defaultStartCallbackServer() {
         if (timeoutId) {
           clearTimeout(timeoutId);
         }
-        resolve9(code);
+        resolve11(code);
         setImmediate(() => {
           server.close();
         });
@@ -10085,8 +10219,8 @@ var LogoutUseCase = class {
   constructor(deps) {
     this.deps = {
       getCredentialsPath: deps?.getCredentialsPath ?? getCredentialsPath,
-      fileExists: deps?.fileExists ?? ((path22) => fs7.existsSync(path22)),
-      deleteFile: deps?.deleteFile ?? ((path22) => fs7.unlinkSync(path22)),
+      fileExists: deps?.fileExists ?? ((path25) => fs7.existsSync(path25)),
+      deleteFile: deps?.deleteFile ?? ((path25) => fs7.unlinkSync(path25)),
       hasEnvVar: deps?.hasEnvVar ?? (() => !!process.env[ENV_VAR_NAME2])
     };
   }
@@ -10666,6 +10800,61 @@ var ConfigFileRepository = class {
   }
 };
 
+// apps/cli/src/infra/repositories/LockFileRepository.ts
+var fs10 = __toESM(require("fs/promises"));
+var path10 = __toESM(require("path"));
+var LockFileRepository = class {
+  constructor() {
+    this.LOCK_FILENAME = "packmind-lock.json";
+  }
+  async read(baseDirectory) {
+    const lockFilePath = this.getLockFilePath(baseDirectory);
+    try {
+      const content = await fs10.readFile(lockFilePath, "utf-8");
+      const parsed = JSON.parse(content);
+      if (!this.isValidLockFile(parsed)) {
+        logWarningConsole(`Malformed lock file: ${lockFilePath}`);
+        return null;
+      }
+      return parsed;
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return null;
+      }
+      if (error instanceof SyntaxError) {
+        logWarningConsole(`Malformed lock file: ${lockFilePath}`);
+        return null;
+      }
+      throw error;
+    }
+  }
+  async write(baseDirectory, lockFile) {
+    const lockFilePath = this.getLockFilePath(baseDirectory);
+    const content = JSON.stringify(lockFile, null, 2) + "\n";
+    await fs10.writeFile(lockFilePath, content, "utf-8");
+  }
+  async delete(baseDirectory) {
+    const lockFilePath = this.getLockFilePath(baseDirectory);
+    try {
+      await fs10.unlink(lockFilePath);
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
+  }
+  isValidLockFile(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+      return false;
+    }
+    const obj = data;
+    return typeof obj.cliVersion === "string" && typeof obj.installedAt === "string" && Array.isArray(obj.packageSlugs) && Array.isArray(obj.agents) && (obj.targetId === void 0 || typeof obj.targetId === "string") && typeof obj.artifacts === "object" && obj.artifacts !== null && !Array.isArray(obj.artifacts);
+  }
+  getLockFilePath(baseDirectory) {
+    return path10.join(baseDirectory, this.LOCK_FILENAME);
+  }
+};
+
 // apps/cli/src/application/useCases/ListStandardsUseCase.ts
 var ListStandardsUseCase = class {
   constructor(packmindGateway) {
@@ -10723,7 +10912,7 @@ function normalizeLineEndings(content) {
 }
 
 // apps/cli/src/infra/utils/binaryDetection.ts
-var path10 = __toESM(require("path"));
+var path11 = __toESM(require("path"));
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   // Images
   ".png",
@@ -10781,7 +10970,7 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".sqlite3"
 ]);
 function isBinaryExtension(filePath) {
-  const ext = path10.extname(filePath).toLowerCase();
+  const ext = path11.extname(filePath).toLowerCase();
   return BINARY_EXTENSIONS.has(ext);
 }
 function isBinaryBuffer(buffer) {
@@ -10821,9 +11010,9 @@ async function readSkillDirectory(dirPath) {
       if (entry.isDirectory()) {
         await readDir(fullPath, basePath);
       } else if (entry.isFile()) {
-        const stat5 = await import_promises.default.stat(fullPath);
-        if (stat5.size > MAX_FILE_SIZE_BYTES) {
-          const fileSizeMB = (stat5.size / (1024 * 1024)).toFixed(2);
+        const stat7 = await import_promises.default.stat(fullPath);
+        if (stat7.size > MAX_FILE_SIZE_BYTES) {
+          const fileSizeMB = (stat7.size / (1024 * 1024)).toFixed(2);
           throw new Error(
             `File "${relativePath}" is ${fileSizeMB} MB which exceeds the maximum allowed size of ${MAX_FILE_SIZE_MB} MB per file.`
           );
@@ -10842,7 +11031,7 @@ async function readSkillDirectory(dirPath) {
           relativePath: normalizedPath,
           content,
           size: Buffer.byteLength(content, isBinary ? "base64" : "utf-8"),
-          permissions: modeToPermissionStringOrDefault(stat5.mode),
+          permissions: modeToPermissionStringOrDefault(stat7.mode),
           isBase64: isBinary
         });
       }
@@ -10900,8 +11089,8 @@ var UploadSkillUseCase = class {
 
 // apps/cli/src/application/useCases/diffStrategies/CommandDiffStrategy.ts
 var import_diff2 = require("diff");
-var fs11 = __toESM(require("fs/promises"));
-var path12 = __toESM(require("path"));
+var fs12 = __toESM(require("fs/promises"));
+var path13 = __toESM(require("path"));
 
 // apps/cli/src/application/utils/stripFrontmatter.ts
 var FRONTMATTER_DELIMITER2 = "---";
@@ -10928,10 +11117,10 @@ var CommandDiffStrategy = class {
     return file.artifactType === "command";
   }
   async diff(file, baseDirectory) {
-    const fullPath = path12.join(baseDirectory, file.path);
+    const fullPath = path13.join(baseDirectory, file.path);
     let localContent;
     try {
-      localContent = await fs11.readFile(fullPath, "utf-8");
+      localContent = await fs12.readFile(fullPath, "utf-8");
     } catch {
       return [];
     }
@@ -10963,8 +11152,8 @@ var CommandDiffStrategy = class {
 
 // apps/cli/src/application/useCases/diffStrategies/SkillDiffStrategy.ts
 var import_diff3 = require("diff");
-var fs12 = __toESM(require("fs/promises"));
-var path13 = __toESM(require("path"));
+var fs13 = __toESM(require("fs/promises"));
+var path14 = __toESM(require("path"));
 var SkillDiffStrategy = class {
   supports(file) {
     return file.artifactType === "skill";
@@ -10978,7 +11167,7 @@ var SkillDiffStrategy = class {
   async diffNewFiles(skillFolders, serverFiles, baseDirectory) {
     const diffs = [];
     for (const folder of skillFolders) {
-      const folderPath = path13.join(baseDirectory, folder);
+      const folderPath = path14.join(baseDirectory, folder);
       const localFiles = await this.listFilesRecursively(folderPath);
       const serverPathsInFolder = new Set(
         serverFiles.filter((f) => f.path.startsWith(folder + "/")).map((f) => f.path)
@@ -10997,7 +11186,7 @@ var SkillDiffStrategy = class {
         if (serverPathsInFolder.has(filePath)) {
           continue;
         }
-        const fullPath = path13.join(baseDirectory, filePath);
+        const fullPath = path14.join(baseDirectory, filePath);
         const localRead = await this.tryReadFileBinaryAware(fullPath);
         if (localRead === null) {
           continue;
@@ -11024,7 +11213,7 @@ var SkillDiffStrategy = class {
     return diffs;
   }
   async diffSkillMd(file, baseDirectory) {
-    const fullPath = path13.join(baseDirectory, file.path);
+    const fullPath = path14.join(baseDirectory, file.path);
     const localContent = await this.tryReadFile(fullPath);
     if (localContent === null) {
       return [];
@@ -11076,7 +11265,7 @@ var SkillDiffStrategy = class {
       return [];
     }
     const skillFileId = createSkillFileId(file.skillFileId);
-    const fullPath = path13.join(baseDirectory, file.path);
+    const fullPath = path14.join(baseDirectory, file.path);
     const localRead = await this.tryReadFileBinaryAware(fullPath);
     const fileRelativePath = this.computeRelativePath(file.path, skillFolders);
     if (localRead === null) {
@@ -11261,14 +11450,14 @@ var SkillDiffStrategy = class {
   }
   async tryReadFile(filePath) {
     try {
-      return await fs12.readFile(filePath, "utf-8");
+      return await fs13.readFile(filePath, "utf-8");
     } catch {
       return null;
     }
   }
   async tryReadFileBinaryAware(filePath) {
     try {
-      const buffer = await fs12.readFile(filePath);
+      const buffer = await fs13.readFile(filePath);
       if (isBinaryFile(filePath, buffer)) {
         return { content: buffer.toString("base64"), isBase64: true };
       }
@@ -11280,19 +11469,19 @@ var SkillDiffStrategy = class {
   async listFilesRecursively(dirPath, prefix = "") {
     let entries;
     try {
-      entries = await fs12.readdir(dirPath);
+      entries = await fs13.readdir(dirPath);
     } catch {
       return [];
     }
     const files = [];
     for (const entry of entries) {
-      const fullPath = path13.join(dirPath, entry);
-      const stat5 = await this.tryStatFile(fullPath);
-      if (!stat5) {
+      const fullPath = path14.join(dirPath, entry);
+      const stat7 = await this.tryStatFile(fullPath);
+      if (!stat7) {
         continue;
       }
       const relativePath = prefix ? `${prefix}/${entry}` : entry;
-      if (stat5.isDirectory) {
+      if (stat7.isDirectory) {
         const subFiles = await this.listFilesRecursively(
           fullPath,
           relativePath
@@ -11306,16 +11495,16 @@ var SkillDiffStrategy = class {
   }
   async tryStatFile(filePath) {
     try {
-      const stat5 = await fs12.stat(filePath);
-      return { isDirectory: stat5.isDirectory() };
+      const stat7 = await fs13.stat(filePath);
+      return { isDirectory: stat7.isDirectory() };
     } catch {
       return null;
     }
   }
   async tryGetPermissions(filePath) {
     try {
-      const stat5 = await fs12.stat(filePath);
-      return modeToPermissionStringOrDefault(stat5.mode);
+      const stat7 = await fs13.stat(filePath);
+      return modeToPermissionStringOrDefault(stat7.mode);
     } catch {
       return null;
     }
@@ -11330,8 +11519,8 @@ var SkillDiffStrategy = class {
 };
 
 // apps/cli/src/application/useCases/diffStrategies/StandardDiffStrategy.ts
-var fs13 = __toESM(require("fs/promises"));
-var path14 = __toESM(require("path"));
+var fs14 = __toESM(require("fs/promises"));
+var path15 = __toESM(require("path"));
 
 // apps/cli/src/application/utils/parseStandardMd.ts
 var DEPLOYER_PARSERS = [
@@ -11626,10 +11815,10 @@ var StandardDiffStrategy = class {
     return file.artifactType === "standard";
   }
   async diff(file, baseDirectory) {
-    const fullPath = path14.join(baseDirectory, file.path);
+    const fullPath = path15.join(baseDirectory, file.path);
     let localContent;
     try {
-      localContent = await fs13.readFile(fullPath, "utf-8");
+      localContent = await fs14.readFile(fullPath, "utf-8");
     } catch {
       return [];
     }
@@ -11744,8 +11933,9 @@ var StandardDiffStrategy = class {
 
 // apps/cli/src/application/useCases/DiffArtefactsUseCase.ts
 var DiffArtefactsUseCase = class {
-  constructor(packmindGateway) {
+  constructor(packmindGateway, lockFileRepository) {
     this.packmindGateway = packmindGateway;
+    this.lockFileRepository = lockFileRepository;
     this.strategies = [
       new CommandDiffStrategy(),
       new SkillDiffStrategy(),
@@ -11754,13 +11944,7 @@ var DiffArtefactsUseCase = class {
   }
   async execute(command22) {
     const baseDirectory = command22.baseDirectory || process.cwd();
-    const response = await this.packmindGateway.deployment.getDeployed({
-      packagesSlugs: command22.packagesSlugs,
-      gitRemoteUrl: command22.gitRemoteUrl,
-      gitBranch: command22.gitBranch,
-      relativePath: command22.relativePath,
-      agents: command22.agents
-    });
+    const response = await this.fetchContent(command22, baseDirectory);
     const filteredFiles = response.fileUpdates.createOrUpdate.filter(
       (file) => file.path !== "packmind.json"
     );
@@ -11795,7 +11979,37 @@ var DiffArtefactsUseCase = class {
         diffs.push(...newFileDiffs);
       }
     }
-    return diffs.map((diff) => ({ ...diff, targetId: response.targetId }));
+    return diffs.map((diff) => ({
+      ...diff,
+      targetId: response.targetId ? createTargetId(response.targetId) : void 0
+    }));
+  }
+  async fetchContent(command22, baseDirectory) {
+    const lockFile = await this.lockFileRepository.read(baseDirectory);
+    if (lockFile) {
+      try {
+        const response = await this.packmindGateway.deployment.getContentByVersions({
+          artifacts: Object.values(lockFile.artifacts),
+          agents: lockFile.agents
+        });
+        return {
+          ...response,
+          targetId: lockFile.targetId
+        };
+      } catch (error) {
+        const statusCode = error.statusCode;
+        if (statusCode !== 404) {
+          throw error;
+        }
+      }
+    }
+    return this.packmindGateway.deployment.getDeployed({
+      packagesSlugs: command22.packagesSlugs,
+      gitRemoteUrl: command22.gitRemoteUrl,
+      gitBranch: command22.gitBranch,
+      relativePath: command22.relativePath,
+      agents: command22.agents
+    });
   }
   prefixSkillFolders(skillFolders, relativePath) {
     if (!relativePath) return skillFolders;
@@ -11956,7 +12170,8 @@ var PackmindCliHexaFactory = class {
   constructor() {
     this.repositories = {
       packmindGateway: new PackmindGateway(loadApiKey()),
-      configFileRepository: new ConfigFileRepository()
+      configFileRepository: new ConfigFileRepository(),
+      lockFileRepository: new LockFileRepository()
     };
     this.services = {
       listFiles: new ListFiles(),
@@ -11979,7 +12194,8 @@ var PackmindCliHexaFactory = class {
         this.repositories
       ),
       installPackages: new InstallPackagesUseCase(
-        this.repositories.packmindGateway
+        this.repositories.packmindGateway,
+        this.repositories.lockFileRepository
       ),
       installDefaultSkills: new InstallDefaultSkillsUseCase(this.repositories),
       listPackages: new ListPackagesUseCase(this.repositories.packmindGateway),
@@ -12002,7 +12218,8 @@ var PackmindCliHexaFactory = class {
         gateway: this.repositories.packmindGateway
       }),
       diffArtefacts: new DiffArtefactsUseCase(
-        this.repositories.packmindGateway
+        this.repositories.packmindGateway,
+        this.repositories.lockFileRepository
       ),
       submitDiffs: new SubmitDiffsUseCase(this.repositories.packmindGateway),
       checkDiffs: new CheckDiffsUseCase(this.repositories.packmindGateway)
@@ -12187,6 +12404,9 @@ var PackmindCliHexa = class {
   async installDefaultSkills(command22) {
     return this.hexa.useCases.installDefaultSkills.execute(command22);
   }
+  async readLockFile(baseDirectory) {
+    return this.hexa.repositories.lockFileRepository.read(baseDirectory);
+  }
   getPackmindGateway() {
     return this.hexa.repositories.packmindGateway;
   }
@@ -12285,8 +12505,55 @@ var HumanReadableLogger = class {
 };
 
 // apps/cli/src/infra/commands/LinterCommand.ts
+var pathModule2 = __toESM(require("path"));
+
+// apps/cli/src/infra/commands/lintHandler.ts
+var fs16 = __toESM(require("fs/promises"));
 var pathModule = __toESM(require("path"));
 
+// apps/cli/src/application/services/PackmindIgnoreReader.ts
+var fs15 = __toESM(require("fs/promises"));
+var path16 = __toESM(require("path"));
+var IGNORE_FILENAME = ".packmindignore";
+var PackmindIgnoreReader = class {
+  async readIgnorePatterns(startDirectory, stopDirectory) {
+    const patterns = [];
+    const normalizedStart = path16.resolve(startDirectory);
+    const normalizedStop = stopDirectory ? path16.resolve(stopDirectory) : null;
+    if (normalizedStop === null) {
+      const ignoreFile = path16.join(normalizedStart, IGNORE_FILENAME);
+      return this.parseIgnoreFile(ignoreFile);
+    }
+    let currentDir = normalizedStart;
+    while (true) {
+      const ignoreFile = path16.join(currentDir, IGNORE_FILENAME);
+      const filePatterns = await this.parseIgnoreFile(ignoreFile);
+      patterns.push(...filePatterns);
+      if (currentDir === normalizedStop) {
+        break;
+      }
+      const parentDir = path16.dirname(currentDir);
+      if (parentDir === currentDir) {
+        break;
+      }
+      currentDir = parentDir;
+    }
+    return patterns;
+  }
+  async parseIgnoreFile(filePath) {
+    let content;
+    try {
+      content = await fs15.readFile(filePath, "utf-8");
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        return [];
+      }
+      throw err;
+    }
+    return content.split("\n").map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  }
+};
+
 // apps/cli/src/infra/commands/lintHandler.ts
 var SEVERITY_LEVELS = {
   ["warning" /* WARNING */]: 0,
@@ -12297,7 +12564,7 @@ function isNotLoggedInError(error) {
 }
 async function lintHandler(args2, deps) {
   const {
-    path: path22,
+    path: path25,
     draft,
     rule,
     language,
@@ -12312,20 +12579,52 @@ async function lintHandler(args2, deps) {
     humanReadableLogger,
     ideLintLogger,
     resolvePath,
-    exit
+    exit,
+    packmindIgnoreReader = new PackmindIgnoreReader()
   } = deps;
   if (draft && !rule) {
     throw new Error("option --rule is required to use --draft mode");
   }
   const startedAt = Date.now();
-  const targetPath = path22 ?? ".";
+  const targetPath = path25 ?? ".";
   const absolutePath = resolvePath(targetPath);
-  if (diff) {
-    const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(absolutePath);
-    if (!gitRoot) {
-      throw new Error(
-        "The --changed-files and --changed-lines options require the project to be in a Git repository"
+  let stats;
+  try {
+    stats = await fs16.stat(absolutePath);
+  } catch (err) {
+    const isNotFound = err.code === "ENOENT";
+    const message = isNotFound ? `File or directory "${absolutePath}" does not exist` : `Cannot access "${absolutePath}": ${err.message}`;
+    logErrorConsole(message);
+    exit(1);
+    return;
+  }
+  const isFile = stats.isFile();
+  const directoryForOps = isFile ? pathModule.dirname(absolutePath) : absolutePath;
+  const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(directoryForOps);
+  if (diff && !gitRoot) {
+    throw new Error(
+      "The --changed-files and --changed-lines options require the project to be in a Git repository"
+    );
+  }
+  let ignorePatterns = [];
+  try {
+    ignorePatterns = await packmindIgnoreReader.readIgnorePatterns(
+      directoryForOps,
+      gitRoot
+    );
+  } catch (err) {
+    logWarningConsole(
+      `Failed to read .packmindignore: ${err.message}`
+    );
+  }
+  if (isFile && ignorePatterns.length > 0) {
+    const relPath = pathModule.relative(gitRoot ?? directoryForOps, absolutePath).replace(/\\/g, "/");
+    if (ignorePatterns.some((p) => matchesGlobPattern(relPath, p))) {
+      logWarningConsole(
+        `File "${absolutePath}" is excluded by .packmindignore`
       );
+      exit(0);
+      return;
     }
   }
   let violations = [];
@@ -12337,14 +12636,14 @@ async function lintHandler(args2, deps) {
         standardSlug: rule?.standardSlug,
         ruleId: rule?.ruleId,
         language,
-        diffMode: diff
+        diffMode: diff,
+        ignorePatterns
       });
       violations = result.violations;
     } else {
-      const stopDirectory = await packmindCliHexa.tryGetGitRepositoryRoot(absolutePath);
       const hierarchicalConfig = await packmindCliHexa.readHierarchicalConfig(
-        absolutePath,
-        stopDirectory
+        directoryForOps,
+        gitRoot
       );
       if (!hierarchicalConfig.hasConfigs) {
         throw new Error(
@@ -12353,7 +12652,8 @@ async function lintHandler(args2, deps) {
       }
       const result = await packmindCliHexa.lintFilesFromConfig({
         path: absolutePath,
-        diffMode: diff
+        diffMode: diff,
+        ignorePatterns
       });
       violations = result.violations;
     }
@@ -12537,7 +12837,7 @@ var lintCommand = (0, import_cmd_ts.command)({
       packmindCliHexa: new PackmindCliHexa(packmindLogger),
       humanReadableLogger: new HumanReadableLogger(),
       ideLintLogger: new IDELintLogger(),
-      resolvePath: (targetPath) => pathModule.isAbsolute(targetPath) ? targetPath : pathModule.resolve(process.cwd(), targetPath),
+      resolvePath: (targetPath) => pathModule2.isAbsolute(targetPath) ? targetPath : pathModule2.resolve(process.cwd(), targetPath),
       exit: (code) => process.exit(code)
     };
     await lintHandler({ ...args2, diff }, deps);
@@ -12545,7 +12845,7 @@ var lintCommand = (0, import_cmd_ts.command)({
 });
 
 // apps/cli/src/wasm-runtime.ts
-var import_fs18 = require("fs");
+var import_fs19 = require("fs");
 var import_path3 = require("path");
 var import_os = require("os");
 
@@ -12577,20 +12877,20 @@ function hasEmbeddedWasmFiles() {
   return Object.keys(EMBEDDED_WASM_FILES).length > 0;
 }
 function extractWasmFiles() {
-  if (wasmExtractedDir && (0, import_fs18.existsSync)(wasmExtractedDir)) {
+  if (wasmExtractedDir && (0, import_fs19.existsSync)(wasmExtractedDir)) {
     return wasmExtractedDir;
   }
   const tempDir = (0, import_path3.join)((0, import_os.tmpdir)(), `packmind-wasm-${process.pid}`);
-  if (!(0, import_fs18.existsSync)(tempDir)) {
-    (0, import_fs18.mkdirSync)(tempDir, { recursive: true });
+  if (!(0, import_fs19.existsSync)(tempDir)) {
+    (0, import_fs19.mkdirSync)(tempDir, { recursive: true });
   }
   for (const [filename, base64Data] of Object.entries(EMBEDDED_WASM_FILES)) {
     const wasmPath = (0, import_path3.join)(tempDir, filename);
-    if ((0, import_fs18.existsSync)(wasmPath)) {
+    if ((0, import_fs19.existsSync)(wasmPath)) {
       continue;
     }
     const wasmBuffer = Buffer.from(base64Data, "base64");
-    (0, import_fs18.writeFileSync)(wasmPath, wasmBuffer);
+    (0, import_fs19.writeFileSync)(wasmPath, wasmBuffer);
   }
   wasmExtractedDir = tempDir;
   process.on("exit", () => {
@@ -12600,8 +12900,8 @@ function extractWasmFiles() {
 
 // apps/cli/src/main.ts
 var import_dotenv = require("dotenv");
-var fs19 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
+var fs23 = __toESM(require("fs"));
+var path24 = __toESM(require("path"));
 
 // apps/cli/src/infra/commands/InstallCommand.ts
 var import_cmd_ts2 = __toESM(require_cjs());
@@ -12884,8 +13184,9 @@ async function executeInstallForDirectory(directory, deps) {
       packagesSlugs: configPackages,
       previousPackagesSlugs: configPackages,
       // Pass for consistency
-      agents: configAgents
+      agents: configAgents,
       // Pass agents from config if present
+      cliVersion: CLI_VERSION
     });
     const parts = [];
     if (result.recipesCount > 0) parts.push(`${result.recipesCount} commands`);
@@ -13038,8 +13339,9 @@ async function installPackagesHandler(args2, deps) {
       gitRemoteUrl,
       gitBranch,
       relativePath,
-      agents: configAgents
+      agents: configAgents,
       // Pass agents from config if present (overrides org-level)
+      cliVersion: CLI_VERSION
     });
     const parts = [];
     if (result.recipesCount > 0) parts.push(`${result.recipesCount} commands`);
@@ -13180,11 +13482,17 @@ async function uninstallPackagesHandler(args2, deps) {
     };
   }
   let configPackages;
+  let configAgents;
   let configFileExists = false;
   try {
     configFileExists = await packmindCliHexa.configExists(cwd);
-    const config = await packmindCliHexa.readConfig(cwd);
-    configPackages = config.packages;
+    const fullConfig = await packmindCliHexa.readFullConfig(cwd);
+    if (fullConfig) {
+      configPackages = fullConfig.packages;
+      configAgents = fullConfig.agents;
+    } else {
+      configPackages = {};
+    }
   } catch (err) {
     error("\u274C Failed to read packmind.json");
     if (err instanceof Error) {
@@ -13253,7 +13561,9 @@ async function uninstallPackagesHandler(args2, deps) {
       const result = await packmindCliHexa.installPackages({
         baseDirectory: cwd,
         packagesSlugs: [],
-        previousPackagesSlugs: Object.keys(configPackages)
+        previousPackagesSlugs: Object.keys(configPackages),
+        agents: configAgents,
+        cliVersion: CLI_VERSION
       });
       log(`
 removed ${result.filesDeleted} files`);
@@ -13273,7 +13583,9 @@ removed ${result.filesDeleted} files`);
       const result = await packmindCliHexa.installPackages({
         baseDirectory: cwd,
         packagesSlugs: remainingPackages,
-        previousPackagesSlugs: Object.keys(configPackages)
+        previousPackagesSlugs: Object.keys(configPackages),
+        agents: configAgents,
+        cliVersion: CLI_VERSION
       });
       if (result.recipesCount > 0 || result.standardsCount > 0) {
         log(
@@ -13676,13 +13988,13 @@ Credentials are loaded from (in order of priority):`);
 
 // apps/cli/src/infra/commands/SetupMcpCommand.ts
 var import_cmd_ts7 = __toESM(require_cjs());
-var fs15 = __toESM(require("fs"));
+var fs18 = __toESM(require("fs"));
 var readline2 = __toESM(require("readline"));
 var inquirer = __toESM(require("inquirer"));
 
 // apps/cli/src/application/services/AgentDetectionService.ts
-var fs14 = __toESM(require("fs"));
-var path15 = __toESM(require("path"));
+var fs17 = __toESM(require("fs"));
+var path17 = __toESM(require("path"));
 var os4 = __toESM(require("os"));
 var import_child_process3 = require("child_process");
 var AgentDetectionService = class {
@@ -13709,16 +14021,16 @@ var AgentDetectionService = class {
     return this.isCommandAvailable("claude");
   }
   isCursorAvailable() {
-    const cursorConfigDir = path15.join(os4.homedir(), ".cursor");
-    return fs14.existsSync(cursorConfigDir);
+    const cursorConfigDir = path17.join(os4.homedir(), ".cursor");
+    return fs17.existsSync(cursorConfigDir);
   }
   isVSCodeAvailable() {
-    const vscodeDir = path15.join(this.projectDir, ".vscode");
-    return fs14.existsSync(vscodeDir);
+    const vscodeDir = path17.join(this.projectDir, ".vscode");
+    return fs17.existsSync(vscodeDir);
   }
   isContinueAvailable() {
-    const continueDir = path15.join(this.projectDir, ".continue");
-    return fs14.existsSync(continueDir);
+    const continueDir = path17.join(this.projectDir, ".continue");
+    return fs17.existsSync(continueDir);
   }
   isCommandAvailable(command22) {
     try {
@@ -13757,8 +14069,8 @@ var ALL_AGENTS2 = [
   { type: "continue", name: "Continue.dev" }
 ];
 async function promptAgentsWithReadline(choices) {
-  const input = fs15.createReadStream("/dev/tty");
-  const output = fs15.createWriteStream("/dev/tty");
+  const input = fs18.createReadStream("/dev/tty");
+  const output = fs18.createWriteStream("/dev/tty");
   const rl = readline2.createInterface({
     input,
     output
@@ -13772,7 +14084,7 @@ async function promptAgentsWithReadline(choices) {
   output.write("\n");
   const preselected = choices.map((c, i) => c.checked ? i + 1 : null).filter((i) => i !== null);
   const defaultValue = preselected.length > 0 ? preselected.join(",") : "1,2,3";
-  return new Promise((resolve9) => {
+  return new Promise((resolve11) => {
     rl.question(
       `Enter numbers separated by commas (default: ${defaultValue}): `,
       (answer) => {
@@ -13783,7 +14095,7 @@ async function promptAgentsWithReadline(choices) {
         const numbersStr = trimmed === "" ? defaultValue : trimmed;
         const numbers = numbersStr.split(",").map((s) => parseInt(s.trim(), 10)).filter((n) => !isNaN(n) && n >= 1 && n <= choices.length);
         const selectedAgents = numbers.map((n) => choices[n - 1].value);
-        resolve9(selectedAgents);
+        resolve11(selectedAgents);
       }
     );
   });
@@ -14126,7 +14438,7 @@ var import_cmd_ts15 = __toESM(require_cjs());
 var import_cmd_ts13 = __toESM(require_cjs());
 
 // apps/cli/src/infra/utils/readPlaybookFile.ts
-var fs16 = __toESM(require("fs/promises"));
+var fs19 = __toESM(require("fs/promises"));
 
 // apps/cli/src/domain/entities/PlaybookDTO.ts
 var import_zod = require("zod");
@@ -14179,7 +14491,7 @@ function parseAndValidatePlaybook(content) {
 }
 async function readPlaybookFile(filePath) {
   try {
-    const content = await fs16.readFile(filePath, "utf-8");
+    const content = await fs19.readFile(filePath, "utf-8");
     return parseAndValidatePlaybook(content);
   } catch (e) {
     return {
@@ -14415,7 +14727,7 @@ var import_cmd_ts18 = __toESM(require_cjs());
 var import_cmd_ts16 = __toESM(require_cjs());
 
 // apps/cli/src/infra/utils/readCommandPlaybookFile.ts
-var fs17 = __toESM(require("fs/promises"));
+var fs20 = __toESM(require("fs/promises"));
 
 // apps/cli/src/domain/entities/CommandPlaybookDTO.ts
 var import_zod2 = require("zod");
@@ -14467,7 +14779,7 @@ function parseAndValidateCommandPlaybook(content) {
 }
 async function readCommandPlaybookFile(filePath) {
   try {
-    const content = await fs17.readFile(filePath, "utf-8");
+    const content = await fs20.readFile(filePath, "utf-8");
     return parseAndValidateCommandPlaybook(content);
   } catch (e) {
     return {
@@ -14692,9 +15004,13 @@ var commandsCommand = (0, import_cmd_ts18.subcommands)({
 });
 
 // apps/cli/src/infra/commands/DiffCommand.ts
-var import_fs20 = require("fs");
+var import_fs21 = require("fs");
 var import_cmd_ts19 = __toESM(require_cjs());
 
+// apps/cli/src/infra/commands/diffArtefactsHandler.ts
+var nodePath = __toESM(require("path"));
+var fs21 = __toESM(require("fs/promises"));
+
 // apps/cli/src/infra/utils/diffFormatter.ts
 var import_diff4 = require("diff");
 init_source();
@@ -14722,7 +15038,7 @@ 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_fs20 = require("fs");
 var import_os2 = require("os");
 var import_path4 = require("path");
 var MAX_MESSAGE_LENGTH = 1024;
@@ -14734,7 +15050,7 @@ var EDITOR_TEMPLATE = `
 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");
+    (0, import_fs20.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"
@@ -14742,11 +15058,11 @@ function openEditorForMessage() {
     if (result.status !== 0) {
       throw new Error(`Editor exited with status ${result.status}`);
     }
-    const content = (0, import_fs19.readFileSync)(tmpFile, "utf-8");
+    const content = (0, import_fs20.readFileSync)(tmpFile, "utf-8");
     return content.split("\n").filter((line) => !line.startsWith("#")).join("\n").trim();
   } finally {
     try {
-      (0, import_fs19.unlinkSync)(tmpFile);
+      (0, import_fs20.unlinkSync)(tmpFile);
     } catch {
     }
   }
@@ -14866,72 +15182,49 @@ function buildSubmittedFooter(submittedDiffs) {
   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;
-  try {
-    const fullConfig = await packmindCliHexa.readFullConfig(cwd);
-    if (fullConfig) {
-      configPackages = Object.keys(fullConfig.packages);
-      configAgents = fullConfig.agents;
-    } else {
-      configPackages = [];
-    }
-  } catch (err) {
-    error("ERROR Failed to parse packmind.json");
-    if (err instanceof Error) {
-      error(`ERROR ${err.message}`);
-    } else {
-      error(`ERROR ${String(err)}`);
-    }
-    error("\n\u{1F4A1} Please fix the packmind.json file or delete it to continue.");
-    exit(1);
-    return null;
+async function findTargetDirectories(searchPath, packmindCliHexa) {
+  const targets = [];
+  const exists = await packmindCliHexa.configExists(searchPath);
+  if (exists) {
+    targets.push(searchPath);
   }
-  if (configPackages.length === 0) {
-    log("Usage: packmind-cli diff");
-    log("");
-    log("Compare local command files against the server.");
-    log("Configure packages in packmind.json first.");
-    exit(0);
-    return null;
+  const descendants = await packmindCliHexa.findDescendantConfigs(searchPath);
+  for (const dir of descendants) {
+    if (!targets.includes(dir)) {
+      targets.push(dir);
+    }
   }
-  return { configPackages, configAgents };
+  return targets;
+}
+function computeRelativePath(targetAbsDir, gitRoot) {
+  const rel = nodePath.relative(gitRoot, targetAbsDir);
+  if (rel.startsWith("..")) return "/";
+  return rel ? `/${rel}/` : "/";
 }
 async function collectGitInfo(deps) {
-  const { packmindCliHexa, exit, getCwd, error } = deps;
+  const { packmindCliHexa, exit, getCwd } = 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 || !gitRoot) {
+    logErrorConsole(
+      "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 };
+  return { gitRemoteUrl, gitBranch, gitRoot };
 }
 async function handleSubmission(params) {
   const { packmindCliHexa, unsubmittedItems, messageFlag, exit } = params;
@@ -15030,6 +15323,7 @@ function extractUniqueAndSortedArtefacts(groups) {
 function displayDiffs(params) {
   const {
     diffsToDisplay,
+    displayPathMap,
     submittedLookup,
     includeSubmitted,
     unsubmittedItems,
@@ -15047,7 +15341,7 @@ Changes found:
     const subGroups = subGroupByChangeContent(groupDiffs);
     for (const subGroup of subGroups) {
       for (const diff of subGroup) {
-        log(`  ${formatFilePath(diff.filePath)}`);
+        log(`  ${formatFilePath(displayPathMap.get(diff) ?? diff.filePath)}`);
       }
       const label = CHANGE_PROPOSAL_TYPE_LABELS[subGroup[0].type] ?? "content changed";
       const checkItem = submittedLookup.get(subGroup[0]);
@@ -15092,37 +15386,96 @@ async function diffArtefactsHandler(deps) {
     exit,
     getCwd,
     log,
-    error,
     submit,
     includeSubmitted,
     message: messageFlag
   } = deps;
   const cwd = getCwd();
-  const config = await readConfigAndPackages(deps);
-  if (!config) {
+  const searchPath = nodePath.resolve(cwd, deps.path ?? ".");
+  if (deps.path !== void 0) {
+    try {
+      await fs21.stat(searchPath);
+    } catch {
+      logErrorConsole(`Path does not exist: ${searchPath}`);
+      exit(1);
+      return { diffsFound: 0 };
+    }
+  }
+  let targetDirs;
+  try {
+    targetDirs = await findTargetDirectories(searchPath, packmindCliHexa);
+  } catch (err) {
+    logErrorConsole(
+      `Failed to discover target directories: ${err instanceof Error ? err.message : String(err)}`
+    );
+    exit(1);
+    return { diffsFound: 0 };
+  }
+  if (targetDirs.length === 0) {
+    const hierarchicalConfig = await packmindCliHexa.readHierarchicalConfig(
+      cwd,
+      null
+    );
+    if (!hierarchicalConfig.hasConfigs) {
+      logErrorConsole(
+        "Not inside a Packmind project. No packmind.json found in the current directory or any parent directory."
+      );
+      exit(1);
+    } else {
+      log("No Packmind targets found under the current directory.");
+      exit(0);
+    }
     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(
-      `Comparing ${packageCount} ${packageWord}: ${configPackages.join(", ")}...`
-    );
-    const diffs = await packmindCliHexa.diffArtefacts({
-      baseDirectory: cwd,
-      packagesSlugs: configPackages,
-      gitRemoteUrl,
-      gitBranch,
-      relativePath,
-      agents: configAgents
-    });
-    if (diffs.length === 0) {
+    const { gitRemoteUrl, gitBranch, gitRoot } = gitInfo;
+    const targetResults = [];
+    for (const targetDir of targetDirs) {
+      const config = await packmindCliHexa.readFullConfig(targetDir);
+      if (!config) continue;
+      const configPackages = Object.keys(config.packages);
+      if (configPackages.length === 0) continue;
+      const relativePath = computeRelativePath(targetDir, gitRoot);
+      const targetRelativePath = nodePath.relative(cwd, targetDir);
+      if (targetDirs.length > 1) {
+        log("");
+        logInfoConsole(`Target: ${targetRelativePath}`);
+      }
+      const packageCount = configPackages.length;
+      const packageWord = packageCount === 1 ? "package" : "packages";
+      logInfoConsole(
+        `Comparing ${packageCount} ${packageWord}: ${configPackages.join(", ")}...`
+      );
+      const diffs = await packmindCliHexa.diffArtefacts({
+        baseDirectory: targetDir,
+        packagesSlugs: configPackages,
+        gitRemoteUrl,
+        gitBranch,
+        relativePath,
+        agents: config.agents
+      });
+      targetResults.push({ targetRelativePath, diffs });
+    }
+    if (targetResults.length === 0) {
+      log("No packages configured in any target.");
+      exit(0);
+      return { diffsFound: 0 };
+    }
+    const displayPathMap = /* @__PURE__ */ new Map();
+    for (const { targetRelativePath, diffs } of targetResults) {
+      for (const diff of diffs) {
+        displayPathMap.set(
+          diff,
+          targetRelativePath ? `${targetRelativePath}/${diff.filePath}` : diff.filePath
+        );
+      }
+    }
+    const allDiffs = targetResults.flatMap((r) => r.diffs);
+    if (allDiffs.length === 0) {
       log("No changes found.");
       if (submit) {
         logInfoConsole("No changes to submit.");
@@ -15130,11 +15483,11 @@ async function diffArtefactsHandler(deps) {
       exit(0);
       return { diffsFound: 0 };
     }
-    const allGroupedDiffs = Array.from(groupDiffsByArtefact(diffs).values());
+    const allGroupedDiffs = Array.from(groupDiffsByArtefact(allDiffs).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 diffsToDisplay = includeSubmitted ? allDiffs : unsubmittedItems.map((r) => r.diff);
     const submittedLookup = /* @__PURE__ */ new Map();
     for (const item of checkResult.results) {
       submittedLookup.set(item.diff, item);
@@ -15152,6 +15505,7 @@ async function diffArtefactsHandler(deps) {
     }
     const changeCount = displayDiffs({
       diffsToDisplay,
+      displayPathMap,
       submittedLookup,
       includeSubmitted,
       unsubmittedItems,
@@ -15172,11 +15526,10 @@ async function diffArtefactsHandler(deps) {
     exit(0);
     return { diffsFound: changeCount };
   } catch (err) {
-    error("\n\u274C Failed to diff:");
     if (err instanceof Error) {
-      error(`   ${err.message}`);
+      logErrorConsole(err.message);
     } else {
-      error(`   ${String(err)}`);
+      logErrorConsole(String(err));
     }
     exit(1);
     return { diffsFound: 0 };
@@ -15184,40 +15537,10 @@ async function diffArtefactsHandler(deps) {
 }
 
 // apps/cli/src/infra/commands/diffAddHandler.ts
-var path17 = __toESM(require("path"));
-
-// apps/cli/src/application/utils/resolveArtefactFromPath.ts
-function resolveArtefactFromPath(filePath) {
-  const normalized = normalizePath(filePath);
-  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
-    if (paths.command && normalized.includes(paths.command)) {
-      return {
-        artifactType: "command",
-        codingAgent: agent
-      };
-    }
-  }
-  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
-    if (paths.standard && normalized.includes(paths.standard)) {
-      return {
-        artifactType: "standard",
-        codingAgent: agent
-      };
-    }
-  }
-  for (const [agent, paths] of Object.entries(CODING_AGENT_ARTEFACT_PATHS)) {
-    if (paths.skill && normalized.includes(paths.skill)) {
-      return {
-        artifactType: "skill",
-        codingAgent: agent
-      };
-    }
-  }
-  return null;
-}
+var path20 = __toESM(require("path"));
 
 // apps/cli/src/application/utils/parseCommandFile.ts
-var path16 = __toESM(require("path"));
+var path18 = __toESM(require("path"));
 var FRONTMATTER_DELIMITER3 = "---";
 function parseCommandFile(content, filePath) {
   content = normalizeLineEndings(content);
@@ -15269,7 +15592,7 @@ function stripYamlQuotes2(value) {
   return value;
 }
 function extractFilenameSlug(filePath) {
-  let basename2 = path16.basename(filePath);
+  let basename2 = path18.basename(filePath);
   if (basename2.endsWith(".prompt.md")) {
     basename2 = basename2.slice(0, -".prompt.md".length);
   } else if (basename2.endsWith(".md")) {
@@ -15350,6 +15673,23 @@ function parseSkillDirectory(files) {
   return { success: true, payload };
 }
 
+// apps/cli/src/application/utils/findNearestConfigDir.ts
+var path19 = __toESM(require("path"));
+async function findNearestConfigDir(startDir, packmindCliHexa) {
+  let current = startDir;
+  while (true) {
+    const exists = await packmindCliHexa.configExists(current);
+    if (exists) {
+      return current;
+    }
+    const parent = path19.dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+
 // apps/cli/src/infra/commands/diffAddHandler.ts
 async function diffAddHandler(deps) {
   const {
@@ -15358,7 +15698,7 @@ async function diffAddHandler(deps) {
     message: messageFlag,
     exit,
     getCwd,
-    readFile: readFile10,
+    readFile: readFile12,
     readSkillDirectory: readSkillDirectory2
   } = deps;
   if (!filePath) {
@@ -15366,7 +15706,7 @@ async function diffAddHandler(deps) {
     exit(1);
     return;
   }
-  const absolutePath = path17.resolve(getCwd(), filePath);
+  const absolutePath = path20.resolve(getCwd(), filePath);
   const artefactResult = resolveArtefactFromPath(absolutePath);
   if (!artefactResult) {
     logErrorConsole(
@@ -15377,7 +15717,7 @@ async function diffAddHandler(deps) {
   }
   let diffResult;
   if (artefactResult.artifactType === "skill") {
-    const dirPath = absolutePath.endsWith("SKILL.md") ? path17.dirname(absolutePath) : absolutePath;
+    const dirPath = absolutePath.endsWith("SKILL.md") ? path20.dirname(absolutePath) : absolutePath;
     let files;
     try {
       files = await readSkillDirectory2(dirPath);
@@ -15405,7 +15745,7 @@ async function diffAddHandler(deps) {
   } else {
     let content;
     try {
-      content = readFile10(absolutePath);
+      content = readFile12(absolutePath);
     } catch (err) {
       if (isErrnoException(err) && err.code === "EISDIR") {
         logErrorConsole(
@@ -15459,18 +15799,25 @@ async function diffAddHandler(deps) {
     return;
   }
   const space = await packmindCliHexa.getPackmindGateway().spaces.getGlobal();
+  const fileDir = artefactResult.artifactType === "skill" ? absolutePath.endsWith("SKILL.md") ? path20.dirname(path20.dirname(absolutePath)) : path20.dirname(absolutePath) : path20.dirname(absolutePath);
+  const targetDir = await findNearestConfigDir(fileDir, packmindCliHexa);
+  if (!targetDir) {
+    logErrorConsole(
+      "Not inside a Packmind project. No packmind.json found in any parent directory."
+    );
+    exit(1);
+    return;
+  }
   let targetId;
   try {
-    const cwd = getCwd();
-    const fullConfig = await packmindCliHexa.readFullConfig(cwd);
+    const fullConfig = await packmindCliHexa.readFullConfig(targetDir);
     const configPackages = fullConfig ? Object.keys(fullConfig.packages) : [];
-    const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(cwd);
+    const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(targetDir);
     if (gitRoot && configPackages.length > 0) {
       const gitRemoteUrl = packmindCliHexa.getGitRemoteUrlFromPath(gitRoot);
       const gitBranch = packmindCliHexa.getCurrentBranch(gitRoot);
-      let relativePath = cwd.startsWith(gitRoot) ? cwd.slice(gitRoot.length) : "/";
-      if (!relativePath.startsWith("/")) relativePath = "/" + relativePath;
-      if (!relativePath.endsWith("/")) relativePath = relativePath + "/";
+      const rel = path20.relative(gitRoot, targetDir);
+      const relativePath = rel.startsWith("..") ? "/" : rel ? `/${rel}/` : "/";
       const deployedContent = await packmindCliHexa.getPackmindGateway().deployment.getDeployed({
         packagesSlugs: configPackages,
         gitRemoteUrl,
@@ -15588,12 +15935,46 @@ function isErrnoException(err) {
 }
 
 // apps/cli/src/infra/commands/diffRemoveHandler.ts
-var path18 = __toESM(require("path"));
+var path21 = __toESM(require("path"));
 var ARTIFACT_TYPE_LABELS2 = {
   command: "command",
   standard: "standard",
   skill: "skill"
 };
+function findArtifactInLockFile(lockFile, filePathForComparison, expectedArtifactType) {
+  if (!lockFile.targetId) {
+    return null;
+  }
+  for (const entry of Object.values(lockFile.artifacts)) {
+    if (entry.type !== expectedArtifactType) {
+      continue;
+    }
+    const matchingFile = entry.files.find(
+      (f) => normalizePath(f.path) === filePathForComparison
+    );
+    if (matchingFile && entry.packageIds.length > 0) {
+      return {
+        artifactId: entry.id,
+        spaceId: entry.spaceId,
+        packageIds: entry.packageIds,
+        artifactName: entry.name,
+        targetId: lockFile.targetId
+      };
+    }
+  }
+  return null;
+}
+function computeFilePathRelativeToTarget(absoluteFilePath, cwd, gitRoot) {
+  const relGitRoot = path21.relative(gitRoot, absoluteFilePath);
+  const relativeToGitRoot = relGitRoot.startsWith("..") ? absoluteFilePath : relGitRoot;
+  let normalizedFilePath = normalizePath(relativeToGitRoot);
+  if (normalizedFilePath.startsWith("/")) {
+    normalizedFilePath = normalizedFilePath.slice(1);
+  }
+  const relCwd = path21.relative(gitRoot, cwd);
+  const relativePathPrefix = relCwd.startsWith("..") ? "" : relCwd ? relCwd + "/" : "";
+  return relativePathPrefix.length > 0 && normalizedFilePath.startsWith(relativePathPrefix) ? normalizedFilePath.slice(relativePathPrefix.length) : normalizedFilePath;
+}
 async function diffRemoveHandler(deps) {
   const {
     packmindCliHexa,
@@ -15613,7 +15994,7 @@ async function diffRemoveHandler(deps) {
     return;
   }
   const cwd = getCwd();
-  const absolutePath = path18.resolve(cwd, filePath);
+  const absolutePath = path21.resolve(cwd, filePath);
   const artefactResult = resolveArtefactFromPath(absolutePath);
   if (!artefactResult) {
     logErrorConsole(
@@ -15622,18 +16003,27 @@ async function diffRemoveHandler(deps) {
     exit(1);
     return;
   }
-  const matchPath = artefactResult.artifactType === "skill" ? absolutePath.endsWith("SKILL.md") ? absolutePath : path18.join(absolutePath, "SKILL.md") : absolutePath;
-  const skillDirPath = artefactResult.artifactType === "skill" ? absolutePath.endsWith("SKILL.md") ? path18.dirname(absolutePath) : absolutePath : void 0;
+  const matchPath = artefactResult.artifactType === "skill" ? absolutePath.endsWith("SKILL.md") ? absolutePath : path21.join(absolutePath, "SKILL.md") : absolutePath;
+  const skillDirPath = artefactResult.artifactType === "skill" ? absolutePath.endsWith("SKILL.md") ? path21.dirname(absolutePath) : absolutePath : void 0;
   const existsCheckPath = skillDirPath ?? absolutePath;
   if (!existsSync25(existsCheckPath)) {
     logErrorConsole(`File or directory does not exist: ${filePath}`);
     exit(1);
     return;
   }
+  const fileDir = skillDirPath ? path21.dirname(skillDirPath) : path21.dirname(absolutePath);
+  const targetDir = await findNearestConfigDir(fileDir, packmindCliHexa);
+  if (!targetDir) {
+    logErrorConsole(
+      "Not inside a Packmind project. No packmind.json found in any parent directory."
+    );
+    exit(1);
+    return;
+  }
   let configPackages;
   let configAgents;
   try {
-    const fullConfig = await packmindCliHexa.readFullConfig(cwd);
+    const fullConfig = await packmindCliHexa.readFullConfig(targetDir);
     if (fullConfig) {
       configPackages = Object.keys(fullConfig.packages);
       configAgents = fullConfig.agents;
@@ -15660,70 +16050,87 @@ async function diffRemoveHandler(deps) {
     exit(1);
     return;
   }
-  let gitRemoteUrl;
-  let gitBranch;
-  let relativePath;
-  const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(cwd);
-  if (gitRoot) {
+  const gitRoot = await packmindCliHexa.tryGetGitRepositoryRoot(targetDir);
+  let metadata = null;
+  const lockFile = await packmindCliHexa.readLockFile(targetDir);
+  if (lockFile) {
+    const lockFilePathForComparison = gitRoot ? computeFilePathRelativeToTarget(matchPath, targetDir, gitRoot) : normalizePath(path21.relative(targetDir, matchPath));
+    metadata = findArtifactInLockFile(
+      lockFile,
+      lockFilePathForComparison,
+      artefactResult.artifactType
+    );
+  }
+  if (!metadata) {
+    if (!gitRoot) {
+      logErrorConsole(
+        "\n\u274C Could not determine git repository info. The diff command requires a git repository with a remote configured."
+      );
+      exit(1);
+      return;
+    }
+    let gitRemoteUrl;
+    let gitBranch;
+    let relativePath;
     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 + "/";
-      }
+      const rel = path21.relative(gitRoot, targetDir);
+      relativePath = rel.startsWith("..") ? "/" : rel ? `/${rel}/` : "/";
     } catch (err) {
       logErrorConsole(
         `Failed to collect git info: ${err instanceof Error ? err.message : String(err)}`
       );
     }
-  }
-  if (!gitRemoteUrl || !gitBranch || !relativePath) {
-    logErrorConsole(
-      "\n\u274C Could not determine git repository info. The diff command requires a git repository with a remote configured."
-    );
-    exit(1);
-    return;
-  }
-  const deployedContent = await packmindCliHexa.getPackmindGateway().deployment.getDeployed({
-    packagesSlugs: configPackages,
-    gitRemoteUrl,
-    gitBranch,
-    relativePath,
-    agents: configAgents
-  });
-  const relativeToGitRoot = matchPath.startsWith(gitRoot) ? matchPath.slice(gitRoot.length) : matchPath;
-  let normalizedFilePath = normalizePath(relativeToGitRoot);
-  if (normalizedFilePath.startsWith("/")) {
-    normalizedFilePath = normalizedFilePath.slice(1);
-  }
-  const relativePathPrefix = relativePath.startsWith("/") ? relativePath.slice(1) : relativePath;
-  const filePathForComparison = relativePathPrefix.length > 0 && normalizedFilePath.startsWith(relativePathPrefix) ? normalizedFilePath.slice(relativePathPrefix.length) : normalizedFilePath;
-  const deployedFile = deployedContent.fileUpdates.createOrUpdate.find(
-    (file) => normalizePath(file.path) === filePathForComparison
-  );
-  if (!deployedFile) {
-    const artifactTypeLabel = ARTIFACT_TYPE_LABELS2[artefactResult.artifactType];
-    logErrorConsole(`This ${artifactTypeLabel} does not come from Packmind`);
-    exit(1);
-    return;
-  }
-  if (!deployedFile.artifactId || !deployedFile.spaceId) {
-    logErrorConsole(
-      "Missing artifact metadata. Cannot create change proposal for removal."
+    if (!gitRemoteUrl || !gitBranch || !relativePath) {
+      logErrorConsole(
+        "\n\u274C Could not determine git repository info. The diff command requires a git repository with a remote configured."
+      );
+      exit(1);
+      return;
+    }
+    const deployedContent = await packmindCliHexa.getPackmindGateway().deployment.getDeployed({
+      packagesSlugs: configPackages,
+      gitRemoteUrl,
+      gitBranch,
+      relativePath,
+      agents: configAgents
+    });
+    const filePathForComparison = computeFilePathRelativeToTarget(
+      matchPath,
+      targetDir,
+      gitRoot
     );
-    exit(1);
-    return;
-  }
-  if (!deployedContent.targetId || !deployedFile.packageIds) {
-    logErrorConsole(
-      "Missing target or package information. Cannot create change proposal for removal."
+    const deployedFile = deployedContent.fileUpdates.createOrUpdate.find(
+      (file) => normalizePath(file.path) === filePathForComparison
     );
-    exit(1);
-    return;
+    if (!deployedFile) {
+      const artifactTypeLabel = ARTIFACT_TYPE_LABELS2[artefactResult.artifactType];
+      logErrorConsole(`This ${artifactTypeLabel} does not come from Packmind`);
+      exit(1);
+      return;
+    }
+    if (!deployedFile.artifactId || !deployedFile.spaceId) {
+      logErrorConsole(
+        "Missing artifact metadata. Cannot create change proposal for removal."
+      );
+      exit(1);
+      return;
+    }
+    if (!deployedContent.targetId || !deployedFile.packageIds) {
+      logErrorConsole(
+        "Missing target or package information. Cannot create change proposal for removal."
+      );
+      exit(1);
+      return;
+    }
+    metadata = {
+      artifactId: deployedFile.artifactId,
+      spaceId: deployedFile.spaceId,
+      packageIds: deployedFile.packageIds,
+      artifactName: deployedFile.artifactName || artefactResult.artifactType,
+      targetId: deployedContent.targetId
+    };
   }
   let message;
   if (messageFlag !== void 0) {
@@ -15757,14 +16164,13 @@ async function diffRemoveHandler(deps) {
     filePath: absolutePath,
     type: changeProposalType,
     payload: {
-      targetId: deployedContent.targetId,
-      packageIds: deployedFile.packageIds.map(createPackageId)
+      packageIds: metadata.packageIds.map(createPackageId)
     },
-    artifactName: deployedFile.artifactName || artefactResult.artifactType,
+    artifactName: metadata.artifactName,
     artifactType: artefactResult.artifactType,
-    artifactId: deployedFile.artifactId,
-    spaceId: deployedFile.spaceId,
-    targetId: deployedContent.targetId
+    artifactId: metadata.artifactId,
+    spaceId: metadata.spaceId,
+    targetId: createTargetId(metadata.targetId)
   };
   const result = await packmindCliHexa.submitDiffs([[diff]], message);
   for (const err of result.errors) {
@@ -15816,37 +16222,45 @@ var diffCommand = (0, import_cmd_ts19.command)({
       description: "Message describing the intent behind the changes (max 1024 chars)",
       type: (0, import_cmd_ts19.optional)(import_cmd_ts19.string)
     }),
+    path: (0, import_cmd_ts19.option)({
+      long: "path",
+      short: "p",
+      description: "Path to analyze (relative to current directory)",
+      type: (0, import_cmd_ts19.optional)(import_cmd_ts19.string)
+    }),
     positionals: (0, import_cmd_ts19.restPositionals)({
       type: import_cmd_ts19.string,
       displayName: "args",
       description: "Subcommand and arguments (e.g., add <path>, remove <path>)"
     })
   },
-  handler: async ({ submit, includeSubmitted, message, positionals }) => {
+  handler: async ({ submit, includeSubmitted, message, path: path25, positionals }) => {
     const packmindLogger = new PackmindLogger("PackmindCLI", "info" /* INFO */);
     const packmindCliHexa = new PackmindCliHexa(packmindLogger);
     if (positionals[0] === "add") {
+      const addFilePath = path25 && positionals[1] ? `${path25}/${positionals[1]}`.replace(/\/+/g, "/") : positionals[1];
       await diffAddHandler({
         packmindCliHexa,
-        filePath: positionals[1],
+        filePath: addFilePath,
         message,
         exit: process.exit,
         getCwd: () => process.cwd(),
-        readFile: (p) => (0, import_fs20.readFileSync)(p, "utf-8"),
+        readFile: (p) => (0, import_fs21.readFileSync)(p, "utf-8"),
         readSkillDirectory
       });
       return;
     }
     if (positionals[0] === "remove" || positionals[0] === "rm") {
+      const removeFilePath = path25 && positionals[1] ? `${path25}/${positionals[1]}`.replace(/\/+/g, "/") : positionals[1];
       await diffRemoveHandler({
         packmindCliHexa,
-        filePath: positionals[1],
+        filePath: removeFilePath,
         message,
         exit: process.exit,
         getCwd: () => process.cwd(),
-        existsSync: (p) => (0, import_fs20.existsSync)(p),
-        unlinkSync: (p) => (0, import_fs20.unlinkSync)(p),
-        rmSync: (p, opts) => (0, import_fs20.rmSync)(p, opts)
+        existsSync: (p) => (0, import_fs21.existsSync)(p),
+        unlinkSync: (p) => (0, import_fs21.unlinkSync)(p),
+        rmSync: (p, opts) => (0, import_fs21.rmSync)(p, opts)
       });
       return;
     }
@@ -15855,10 +16269,10 @@ var diffCommand = (0, import_cmd_ts19.command)({
       exit: process.exit,
       getCwd: () => process.cwd(),
       log: console.log,
-      error: console.error,
       submit,
       includeSubmitted,
-      message
+      message,
+      path: path25
     });
   }
 });
@@ -16236,8 +16650,8 @@ var import_cmd_ts25 = __toESM(require_cjs());
 var import_cmd_ts24 = __toESM(require_cjs());
 
 // apps/cli/src/application/services/AgentArtifactDetectionService.ts
-var fs18 = __toESM(require("fs/promises"));
-var path19 = __toESM(require("path"));
+var fs22 = __toESM(require("fs/promises"));
+var path22 = __toESM(require("path"));
 var AGENT_ARTIFACT_CHECKS = [
   { agent: "claude", paths: [".claude"] },
   { agent: "cursor", paths: [".cursor"] },
@@ -16255,7 +16669,7 @@ var AgentArtifactDetectionService = class {
     const detected = [];
     for (const check of AGENT_ARTIFACT_CHECKS) {
       for (const relativePath of check.paths) {
-        const fullPath = path19.join(baseDirectory, relativePath);
+        const fullPath = path22.join(baseDirectory, relativePath);
         const exists = await this.pathExists(fullPath);
         if (exists) {
           detected.push({
@@ -16270,7 +16684,7 @@ var AgentArtifactDetectionService = class {
   }
   async pathExists(filePath) {
     try {
-      await fs18.access(filePath);
+      await fs22.access(filePath);
       return true;
     } catch {
       return false;
@@ -16352,7 +16766,7 @@ async function promptAgentsWithReadline2(choices) {
   output.write("\n");
   const preselected = choices.map((c, i) => c.checked ? i + 1 : null).filter((i) => i !== null);
   const defaultValue = preselected.length > 0 ? preselected.join(",") : "1,2,3";
-  return new Promise((resolve9) => {
+  return new Promise((resolve11) => {
     rl.question(
       `Enter numbers separated by commas (default: ${defaultValue}): `,
       (answer) => {
@@ -16361,7 +16775,7 @@ async function promptAgentsWithReadline2(choices) {
         const numbersStr = trimmed === "" ? defaultValue : trimmed;
         const numbers = numbersStr.split(",").map((s) => parseInt(s.trim(), 10)).filter((n) => !isNaN(n) && n >= 1 && n <= choices.length);
         const selectedAgents = numbers.map((n) => choices[n - 1].value);
-        resolve9(selectedAgents);
+        resolve11(selectedAgents);
       }
     );
   });
@@ -16512,7 +16926,7 @@ var import_cmd_ts27 = __toESM(require_cjs());
 // apps/cli/src/infra/commands/updateHandler.ts
 var import_path5 = __toESM(require("path"));
 var import_child_process5 = require("child_process");
-var import_fs21 = require("fs");
+var import_fs22 = require("fs");
 var import_promises2 = require("stream/promises");
 var import_stream = require("stream");
 var import_semver = __toESM(require("semver"));
@@ -16579,11 +16993,11 @@ URL: ${url}`
     throw new Error("No response body received");
   }
   const nodeReadable = import_stream.Readable.fromWeb(res.body);
-  const fileStream = (0, import_fs21.createWriteStream)(targetPath);
+  const fileStream = (0, import_fs22.createWriteStream)(targetPath);
   await (0, import_promises2.pipeline)(nodeReadable, fileStream);
-  const stats = (0, import_fs21.statSync)(targetPath);
+  const stats = (0, import_fs22.statSync)(targetPath);
   if (stats.size < 1e6) {
-    (0, import_fs21.unlinkSync)(targetPath);
+    (0, import_fs22.unlinkSync)(targetPath);
     throw new Error(
       `Downloaded file is too small (${stats.size} bytes). The download may have failed.`
     );
@@ -16604,13 +17018,13 @@ async function updateViaExecutableReplace(deps, version) {
   const tempPath = currentPath + ".update-tmp";
   try {
     await downloadExecutable(deps.fetchFn, version, platformSuffix, tempPath);
-    (0, import_fs21.renameSync)(tempPath, currentPath);
+    (0, import_fs22.renameSync)(tempPath, currentPath);
     if (deps.platform !== "win32") {
-      (0, import_fs21.chmodSync)(currentPath, 493);
+      (0, import_fs22.chmodSync)(currentPath, 493);
     }
   } catch (error) {
     try {
-      (0, import_fs21.unlinkSync)(tempPath);
+      (0, import_fs22.unlinkSync)(tempPath);
     } catch {
     }
     throw error;
@@ -16622,7 +17036,7 @@ function isLocalNpmPackage(scriptPath) {
 }
 function isHomebrewInstall(executablePath) {
   try {
-    const realPath = (0, import_fs21.realpathSync)(executablePath);
+    const realPath = (0, import_fs22.realpathSync)(executablePath);
     return realPath.includes("/Cellar/");
   } catch {
     return false;
@@ -16732,20 +17146,20 @@ function findEnvFile() {
   const currentDir = process.cwd();
   const gitService = new GitService();
   const gitRoot = gitService.getGitRepositoryRootSync(currentDir);
-  const filesystemRoot = path21.parse(currentDir).root;
+  const filesystemRoot = path24.parse(currentDir).root;
   const stopDir = gitRoot ?? filesystemRoot;
   let searchDir = currentDir;
-  let parentDir = path21.dirname(searchDir);
+  let parentDir = path24.dirname(searchDir);
   while (searchDir !== parentDir) {
-    const envPath2 = path21.join(searchDir, ".env");
-    if (fs19.existsSync(envPath2)) {
+    const envPath2 = path24.join(searchDir, ".env");
+    if (fs23.existsSync(envPath2)) {
       return envPath2;
     }
     if (searchDir === stopDir) {
       return null;
     }
     searchDir = parentDir;
-    parentDir = path21.dirname(searchDir);
+    parentDir = path24.dirname(searchDir);
   }
   return null;
 }