amxx-builder 1.7.0 → 1.7.1

package/AGENTS.md

@@ -68,6 +68,7 @@ The opencode bridge plugin (`.opencode/plugin/amxb-skills.js`, generated by `amx
 - Plugin rules (`plugins.rules:`) apply **only to local** `.sma` files, not repo plugins; `plugins.defaults` and `repos[].plugins` apply to all plugins. An effective non-`false` `ini` enables INI generation.
 - Local `amxmodx/` always wins over repo files (intentional override layer, no conflict warning).
 - `.sma` files ARE copied during collect (like any other file) and are also compiled; exclude them per-repo via `exclude_files` if sources should not ship.
+- `amxmodx.exclude_files` (array of glob patterns, default `[]`, relative to the local `amxmodx.dir`) keeps matching files from the project's own local `amxmodx/` out of `build/amxmodx/` and the archive. It does not touch `repos:` files (those use per-repo `exclude_files`) and does not stop compilation of local `.sma` (use `plugins.rules[].enabled: false` for that); watch ignores excluded local files. Distinct from `deploy.exclude`, which protects server files from being overwritten during deploy/watch.
 - `repos:`/`deps:` entries can be satisfied by a **local directory** instead of GitHub: `source: local` + `path` (relative to the manifest dir, or absolute; optional `name` gives the synthetic id `local/<name>`, defaulting to the path basename). A local repo is collected + its `.sma` compiled and may still set `amxmodx_dir` / `plugins` / `exclude` / `exclude_files` / `deps_override` (`repo`/`ref` forbidden; the deprecated `plugins_ini_postfix` is still accepted with a build warning); a local dep contributes `.inc` to `build/_includes/` (`repo`/`ref`/`id`/`url`/`asset` forbidden; object form only, the `owner/repo@ref[:include_path]` string stays git-only). Local sources are unpinned (the working tree is read as-is) so builds are not reproducible, and watch does not follow dirs outside the manifest's `amxmodx/`/`assets/`.
 
 ## GitHub Action release flow

package/README.md

@@ -155,6 +155,22 @@ my-server/
       weapon.wav
 ```
 
+### Исключение локальных файлов
+
+Поле `amxmodx.exclude_files` задаёт массив glob-паттернов. Файлы локальной папки `amxmodx/`, попавшие под паттерн, не копируются в `build/amxmodx/` и не попадают в архив. По умолчанию значение пустое (`[]`), то есть копируется всё. Паттерны считаются от `amxmodx.dir` (по умолчанию `amxmodx`):
+
+```yaml
+amxmodx:
+  exclude_files:
+    - configs/*.cfg
+    - "**/*.ini"
+    - scripting/dev.sma
+```
+
+Поле действует только на собственную локальную папку `amxmodx/` рядом с манифестом. Файлов из `repos:` оно не касается. Для них исключение задаётся на самом репо через `repos[].exclude_files`. Компиляцию локальных `.sma` поле не отменяет. Чтобы полностью пропустить локальный плагин, используйте `plugins.rules[].enabled: false` (см. раздел про плагины). В watch-режиме изменения исключённых локальных файлов игнорируются, поэтому они не деплоятся.
+
+Не путайте с `deploy.exclude`. Это поле не даёт `amxb deploy` и `amxb watch` перезаписывать файлы сервера (например, существующие конфиги). А `amxmodx.exclude_files` просто не кладёт файлы в пакет.
+
 ## Управление плагинами и INI
 
 Секция `plugins:` описывает, какие плагины попадают в INI-файлы, как эти файлы называются и добавлять ли к строке плагина ` debug`. Она состоит из двух частей:

package/defaults/amxbuild.defaults.yml

@@ -7,6 +7,7 @@ version: "1.0.0"
 amxmodx:
   dir: amxmodx
   defines: []
+  exclude_files: []
 
 github:
   token_env: GITHUB_TOKEN

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amxx-builder",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "author": {
     "name": "ArKaNeMaN"
   },
@@ -48,6 +48,7 @@
     "enquirer": "^2.4.1",
     "fast-glob": "^3.3.2",
     "js-yaml": "^4.3.1",
+    "micromatch": "^4.0.8",
     "simple-git": "^3.22.0"
   },
   "files": [

package/skills/amxb-migration/SKILL.md

@@ -435,8 +435,10 @@ AMXB_LOCAL_SOURCES='Org/Repo=../Repo' amxb build
    - локальная папка `amxmodx/` всегда выигрывает у файлов из репо
      (намеренный слой переопределения, предупреждений нет);
    - `.sma`-файлы **и копируются** в пакет (как любые файлы), **и
-     компилируются**; если исходники не должны попадать в архив — исключить
-     их (для репо — `exclude:`/`exclude_files:` в правиле репозитория);
+     компилируются**; если исходники не должны попадать в архив, их можно
+     исключить: для репо через `exclude:`/`exclude_files:` в правиле
+     репозитория, для локальной `amxmodx/` через `amxmodx.exclude_files`
+     (glob-паттерны относительно `amxmodx.dir`);
    - README.md попадает в архив только при `output.readme: true` (дефолт);
    - агент-доки и скиллы проекта можно объявить верхнеуровневыми `docs:`
      (файлы) и `skills:` (одиночный файл либо папка с `SKILL.md` +

package/src/collector.js

@@ -82,7 +82,7 @@ async function collectAll(manifest, repoLocalDirs, buildDir) {
     const files = await glob('**/*', {
       cwd: localAmxmodxDir,
       onlyFiles: true,
-      ignore: [],
+      ignore: manifest.amxmodx.exclude_files || [],
     });
     for (const f of files) {
       const dest = path.join(amxmodxBuildDir, f);

package/src/manifest.js

@@ -71,6 +71,9 @@ function parseManifest(manifestPath) {
       defines: (raw.amxmodx && Array.isArray(raw.amxmodx.defines))
         ? raw.amxmodx.defines.map(String)
         : [],
+      exclude_files: (raw.amxmodx && Array.isArray(raw.amxmodx.exclude_files))
+        ? raw.amxmodx.exclude_files.map(String)
+        : [],
     },
     github: { token_env: tokenEnv, tokens, token, ssh },
     globalDeps,

package/src/watcher.js

@@ -3,6 +3,7 @@
 const fs     = require('fs');
 const path   = require('path');
 const crypto = require('crypto');
+const micromatch = require('micromatch');
 const logger = require('./logger');
 
 const fileHashes = new Map();
@@ -16,6 +17,22 @@ function contentChanged(filePath) {
   return true;
 }
 
+/**
+ * True when a path under the project's local `amxmodx/` dir matches one of the
+ * `amxmodx.exclude_files` patterns. `relPath` is relative to `amxmodx.dir`;
+ * patterns follow the same forward-slash convention as `repos[].exclude_files`.
+ * Missing/empty patterns → false (default behavior: nothing excluded).
+ *
+ * @param {string} relPath
+ * @param {string[]} [patterns]
+ * @returns {boolean}
+ */
+function isExcludedLocalAmxmodx(relPath, patterns) {
+  if (!Array.isArray(patterns) || patterns.length === 0) return false;
+  const normalized = String(relPath).split(path.sep).join('/');
+  return micromatch.isMatch(normalized, patterns, { dot: true });
+}
+
 /**
  * Starts watching local project files for changes.
  *
@@ -83,6 +100,10 @@ function startWatch(manifest, manifestPath, handlers) {
       const section   = inAmxmodx ? 'amxmodx' : 'assets';
       const baseDir   = inAmxmodx ? localAmxmodxDir : localAssetsDir;
       let relToBase   = path.relative(baseDir, absPath);
+      if (inAmxmodx && isExcludedLocalAmxmodx(relToBase, manifest.amxmodx.exclude_files || [])) {
+        logger.dim(`  skip (excluded): ${rel}`);
+        return;
+      }
       if (inAmxmodx && caseNorm(relToBase).endsWith('.inc')) return; // includes are never deployed
       if (inAmxmodx && caseNorm(relToBase).endsWith('.sma')) {
         // A deleted .sma should remove its compiled output, not the source copy.
@@ -111,6 +132,11 @@ function startWatch(manifest, manifestPath, handlers) {
     const baseDir   = inAmxmodx ? localAmxmodxDir : localAssetsDir;
     const relToBase = path.relative(baseDir, absPath);
 
+    if (inAmxmodx && isExcludedLocalAmxmodx(relToBase, manifest.amxmodx.exclude_files || [])) {
+      logger.dim(`  skip (excluded): ${rel}`);
+      return;
+    }
+
     if (inAmxmodx && caseNorm(filePath).endsWith('.sma')) {
       logger.step(`Changed: ${rel}`);
       safeCall(() => handlers.onSmaChange(absPath));
@@ -132,4 +158,4 @@ function startWatch(manifest, manifestPath, handlers) {
   return watcher;
 }
 
-module.exports = { startWatch };
+module.exports = { startWatch, isExcludedLocalAmxmodx };