@dzhechkov/harness-core 0.8.11 → 0.8.21

package/dist/claude-hooks-assets.js

@@ -0,0 +1,208 @@
+/**
+ * The Claude-side destructive-command guard, as an INSTALLABLE asset
+ * (feature `destructive-command-guard`, task T8, cross-family review round 3, finding P1-1).
+ *
+ * ## Why this file exists
+ *
+ * The guard shipped as one file committed at this repository's root, registered in this
+ * repository's `.claude/settings.json`. MEASURED 2026-09-05, running the documented command in a
+ * clean project — `dz setup --target claude-code --project <tmp>`:
+ *   the written `.claude/settings.json` carries SessionStart / SessionEnd / PreCompact and no
+ *   `PreToolUse` key at all, and `.claude/hooks/` does not exist.
+ * So the advertised Claude-side guard protected exactly one checkout: ours. A guard that only ever
+ * guards its author is a demo.
+ *
+ * Setup therefore has to install BOTH halves into the consumer project — the body and the registry
+ * entry — and the body must come from the INSTALLED package, never from a path inside our
+ * repository, which a consumer does not have.
+ *
+ * ## Why the body carries an absolute path
+ *
+ * The emitted hook runs from `<consumer>/.claude/hooks/`, where `require('@dzhechkov/harness-core')`
+ * cannot resolve: Node resolves a bare specifier upward from the FILE, and the package is not above
+ * that file in a global install. The body therefore resolves by PATH, and the LAST candidate is the
+ * absolute location of the installation that emitted it (see `harness-core-location.ts` for the
+ * measurement that forced this). Project-local candidates come FIRST, so a consumer that installed
+ * harness-core itself keeps using its own copy and is never pinned to ours.
+ *
+ * The generated text is behaviourally identical to this repository's own
+ * `.claude/hooks/destructive-guard.cjs`, and a test drives BOTH bodies through the same matrix
+ * rather than trusting that they stayed alike.
+ *
+ * @packageDocumentation
+ */
+import { harnessCoreDistDir } from './harness-core-location.js';
+/** Bump when the emitted BODY changes. Unlike Codex, Claude has no trust gate — this is provenance. */
+export const DZ_CLAUDE_HOOK_VERSION = 1;
+/**
+ * The OWNERSHIP marker. A file carrying this line is one dz wrote and may replace; a file without it
+ * belongs to the consumer and is never overwritten without `--force`.
+ *
+ * MEASURED 2026-09-05, before this existed: a hand-authored
+ * `.claude/hooks/destructive-guard.cjs` was replaced by a routine `dz setup` run, no `--force`
+ * involved — the one path in setup that was not additive. Ownership is asserted by a MARKER rather
+ * than by a hash of the bytes we wrote, because an UPGRADE must still be able to replace an older
+ * dz body; the cost of that choice is stated in the emitted file itself, on the marker line.
+ */
+export const CLAUDE_DESTRUCTIVE_HOOK_MARKER = 'dz-managed-hook: destructive-guard';
+/** Is this file body one dz owns? Absence of the marker is the consumer's claim to the file. */
+export function isDzManagedHookBody(body) {
+    return body.includes(CLAUDE_DESTRUCTIVE_HOOK_MARKER);
+}
+/** Where the body is installed inside a consumer project, and what the registry entry points at. */
+export const CLAUDE_DESTRUCTIVE_HOOK_RELPATH = '.claude/hooks/destructive-guard.cjs';
+/**
+ * The command Claude Code runs — the EXACT documented placeholder, never a shell-only variant.
+ *
+ * Relative to the project rather than absolute: the settings file is committed by consumers and
+ * shared across machines, and an absolute path in it breaks for every collaborator. The BODY may
+ * carry an absolute fallback because it is generated per machine; the SETTINGS entry may not.
+ *
+ * WHY THE EXACT TOKEN [DOC, code.claude.com/docs/en/hooks, read 2026-09-06]. `${CLAUDE_PROJECT_DIR}`
+ * is a PLACEHOLDER Claude Code substitutes itself — "Use these placeholders to reference hook
+ * scripts relative to the project or plugin root, regardless of the working directory when the hook
+ * runs: ${CLAUDE_PROJECT_DIR}: the project root where the session started" — and the documentation
+ * describes NO default syntax. The previous `${CLAUDE_PROJECT_DIR:-.}` is therefore not the
+ * placeholder at all; it worked only where a POSIX shell happened to expand the variable, and on a
+ * host where Claude Code's own substitution is what fills the token in, it stays literal and the
+ * hook cannot be found. NOT REPRODUCED LIVE: there is no Windows host here, so the Windows half of
+ * this is documentation plus the reviewer's report, not a measurement of mine.
+ *
+ * MEASURED here (POSIX `sh`, 2026-09-06), which is the part that IS checkable: with the variable
+ * set the two forms are identical (`/tmp/x/p`); with it unset the exact token yields `/p` while the
+ * old form yielded `./p`. So on the only path this change can degrade — a hand-run command with no
+ * variable and no substitution — the failure is a loud "cannot find module", never a silent pass.
+ * The fallback that matters (finding the DECIDER) lives inside the body, where it can actually run.
+ */
+export const CLAUDE_DESTRUCTIVE_HOOK_COMMAND = 'node "${CLAUDE_PROJECT_DIR}/' + CLAUDE_DESTRUCTIVE_HOOK_RELPATH + '"';
+/** The PreToolUse matcher. Bash only — the decider skips every other tool without reading it. */
+export const CLAUDE_DESTRUCTIVE_HOOK_MATCHER = '^Bash$';
+/**
+ * The emitted `.claude/hooks/destructive-guard.cjs`.
+ *
+ * Thin by contract: read stdin, hand the payload to `decideDestructiveHook`, print, exit. Runtime
+ * failures of ours exit 0 with one loud line, but a deterministically missing decision module exits
+ * 2: setup cannot leave an armed-looking hook that allows every command until somebody builds it.
+ */
+export function generateClaudeDestructiveHook(opts = {}) {
+    const installed = opts.installedDistDir === undefined ? harnessCoreDistDir() : opts.installedDistDir;
+    const bakedLine = installed === null
+        ? '  // No installed path was baked in (a body committed to a repository): project-local only.\n'
+        : `  candidates.push(${JSON.stringify(installed)} + '/destructive-guard-hook.js'); // the installation that emitted this file\n`;
+    return `#!/usr/bin/env node
+// GENERATED by @dzhechkov/harness-core — dz-claude-hook-version: ${DZ_CLAUDE_HOOK_VERSION}
+// ${CLAUDE_DESTRUCTIVE_HOOK_MARKER}
+// Do not edit: this marker line is what tells dz the file is ITS OWN, so dz rewrites it on the next
+// 'dz setup --target claude-code'. Delete the marker line to claim the file: dz then leaves it
+// alone and only '--force' replaces it, after a timestamped backup.
+//
+// PreToolUse guard on Bash: a deletion by a LITERAL path into a protected store never runs.
+// All of the policy — the three outcomes, the refusal text, the limits the guard must name — lives
+// in @dzhechkov/harness-core (destructive-guard.js classifies, destructive-guard-hook.js decides).
+// The same module decides for the Codex host, so both runtimes refuse the same commands in the
+// same words.
+'use strict';
+
+const path = require('node:path');
+const { writeSync } = require('node:fs');
+const { pathToFileURL } = require('node:url');
+
+/**
+ * Load the decision module by PATH, project-local first, then the installation that emitted this
+ * file. 'import()' and never 'require()': harness-core is "type": "module", and require() of an ES
+ * module throws ERR_REQUIRE_ESM below Node 20.19 / 22.12 — which used to be caught and turned into
+ * a silent allow.
+ */
+async function loadDecider() {
+  // CLAUDE_PROJECT_DIR when the host set it, else this file's own location. The env var is the
+  // host's own statement of where the project root is; __dirname is what still works when nobody
+  // said anything, including when this hook is run by hand.
+  const projectRoot = process.env.CLAUDE_PROJECT_DIR || path.resolve(__dirname, '..', '..');
+  // DZ_GUARD_TRUSTED_ONLY is set by 'dz setup' while it certifies this file. The probe SPAWNS the
+  // hook, so with project-local candidates first it would import — and execute the top level of —
+  // whatever a cloned repository committed at packages/@dzhechkov/harness-core/dist/, during setup
+  // and outside the host's hook-trust flow. The receipt must certify the TRUSTED installation, so
+  // for the probe the project's own copies are switched off. At RUNTIME they stay first: a project
+  // that ships its own harness-core is exactly who should decide there.
+  const trustedOnly = process.env.DZ_GUARD_TRUSTED_ONLY === '1';
+  const candidates = trustedOnly ? [] : [
+    path.join(projectRoot, 'node_modules', '@dzhechkov', 'harness-core', 'dist', 'destructive-guard-hook.js'),
+    path.join(projectRoot, 'packages', '@dzhechkov', 'harness-core', 'dist', 'destructive-guard-hook.js'),
+  ];
+${bakedLine}  const failures = [];
+  for (const candidate of candidates) {
+    try {
+      const mod = await import(pathToFileURL(candidate).href);
+      const decide = mod.decideDestructiveHook || (mod.default && mod.default.decideDestructiveHook);
+      if (typeof decide === 'function') return { decide: decide, reason: null };
+      failures.push(candidate + ': загружен, но decideDestructiveHook не экспортирован');
+    } catch (err) {
+      const code = (err && err.code) || 'ERR_UNKNOWN';
+      failures.push(candidate + ': ' + code + ' ' + String((err && err.message) || err));
+    }
+  }
+  return { decide: null, reason: failures.join(' | ').replace(/\\s*\\n\\s*/g, ' ') };
+}
+
+let raw = '';
+process.stdin.on('data', (c) => { raw += c; });
+process.stdin.on('end', () => {
+  let payload = null;
+  try {
+    payload = JSON.parse(raw);
+  } catch (_) {
+    payload = null; // handed over as-is: the decider owns the "unreadable" wording too.
+  }
+  loadDecider().then(
+    (loaded) => onDecider(loaded, payload),
+    (err) => failOpen('страж опасных команд не смог загрузиться: ' + String((err && err.message) || err)),
+  );
+});
+
+/** One line, exit 0. Every failure of OURS ends here — loudly, and never as a refusal. */
+function failOpen(what) {
+  process.stderr.write(
+    'DZ-DESTRUCTIVE-WARN: ' + String(what).replace(/\\s*\\n\\s*/g, ' ') + ' — команда ПРОПУЩЕНА без проверки.\\n',
+  );
+  process.exit(0);
+}
+
+/** One line, exit 2. No decider means the guard installation is incomplete, so nothing may run. */
+function failUnarmed(reason) {
+  const line =
+    'DZ-DESTRUCTIVE: страж опасных команд не собран и не может проверить запрос — команда НЕ ВЫПОЛНЕНА. ' +
+      'Причина: ' + String(reason).replace(/\\s*\\n\\s*/g, ' ') +
+      ' Починка: npm install -g @dzhechkov/harness-cli@latest, затем dz setup --target claude-code.\\n';
+  // Hook stderr is a pipe under the host and under spawnSync. An immediate process.exit can drop a
+  // buffered write entirely, so write this installation verdict synchronously before exiting.
+  writeSync(2, line);
+  process.exit(2);
+}
+
+function onDecider(loaded, payload) {
+  const decide = loaded.decide;
+  if (decide === null) {
+    failUnarmed(loaded.reason);
+    return;
+  }
+
+  let out = '';
+  let code = 0;
+  try {
+    const decision = decide(payload, 'claude');
+    if (!decision || typeof decision.stderr !== 'string') {
+      throw new TypeError('решение стража нечитаемо: ' + JSON.stringify(decision));
+    }
+    out = decision.stderr;
+    code = decision.exitCode === 2 ? 2 : 0; // 2 = block the call and show the reason.
+  } catch (err) {
+    failOpen('страж опасных команд упал (' + String((err && err.message) || err) + ')');
+    return;
+  }
+
+  if (out !== '') process.stderr.write(out);
+  process.exit(code);
+}
+`;
+}
+//# sourceMappingURL=claude-hooks-assets.js.map

package/dist/claude-hooks-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hooks-assets.js","sourceRoot":"","sources":["../src/claude-hooks-assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,uGAAuG;AACvG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,oCAAoC,CAAC;AAEnF,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AACvD,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,+BAA+B,GAAG,qCAAqC,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,8BAA8B,GAAG,+BAA+B,GAAG,GAAG,CAAC;AAEzE,iGAAiG;AACjG,MAAM,CAAC,MAAM,+BAA+B,GAAG,QAAQ,CAAC;AAWxD;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAA+B,EAAE;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IACrG,MAAM,SAAS,GACb,SAAS,KAAK,IAAI;QAChB,CAAC,CAAC,+FAA+F;QACjG,CAAC,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,gFAAgF,CAAC;IAErI,OAAO;oEAC2D,sBAAsB;KACrF,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EV,CAAC;AACF,CAAC"}

package/dist/clean-room-smoke.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Чистая комната: проверить пакет так, как его увидит НОВЫЙ пользователь.
+ *
+ * ЗАЧЕМ. Разработчик забыл включить файл в поставку — на его машине всё работает, потому что файл
+ * лежит рядом в репозитории; у покупателя коробка приходит без детали. Класс называется
+ * `files[]`/install-layout, и локальный прогон его не ловит ПО ПОСТРОЕНИЮ: он видит рабочее дерево.
+ *
+ * ЧЕСТНАЯ ГРАНИЦА, названная сразу и повторённая в вердикте: «в чистой комнате завелось» НЕ РАВНО
+ * «Claude Code пакет увидел». ИЗМЕРЕНО ранее: health-advisor 1.2.0 был зелёным в чистой комнате на
+ * пакете, чьи навыки не регистрировались вовсе. Это ДОПОЛНЕНИЕ к живой пробе регистрации, а не её
+ * замена.
+ *
+ * ЧИСТАЯ ПОЛОВИНА. Здесь нет ни Docker, ни файловой системы: `planCleanRoom` решает, ЧТО осмысленно
+ * запустить для этого манифеста, а `cleanRoomVerdict` превращает НАБЛЮДЕНИЕ в вердикт. Обе половины
+ * проверяются без контейнера; запускает их скрипт `scripts/clean-room-smoke.mjs`.
+ */
+/** Что и почему запускать в контейнере. `kind: 'refuse'` — смотреть нечего, и это НЕ успех. */
+export type CleanRoomPlan = {
+    readonly kind: 'bin';
+    /** Имя исполняемого файла из `bin`, которое будет вызвано с `--help`. */
+    readonly binName: string;
+    readonly argv: readonly string[];
+    readonly why: string;
+} | {
+    readonly kind: 'import';
+    /** Имя пакета, которое будет импортировано из установленной копии. */
+    readonly packageName: string;
+    readonly why: string;
+} | {
+    readonly kind: 'files-only';
+    /** Файл из поставки, чьё присутствие проверяется после установки. */
+    readonly probeFile: string;
+    readonly why: string;
+} | {
+    readonly kind: 'refuse';
+    readonly reason: string;
+};
+interface ManifestLike {
+    readonly name?: unknown;
+    readonly bin?: unknown;
+    readonly main?: unknown;
+    readonly exports?: unknown;
+    readonly files?: unknown;
+    readonly private?: unknown;
+}
+/**
+ * Выбрать пробу по манифесту — от самой сильной к самой слабой.
+ *
+ * ПОРЯДОК НЕ ПРОИЗВОЛЕН. Запуск бинаря проверяет и установку, и разрешение зависимостей, и то,
+ * что точка входа физически приехала. Импорт проверяет первые две. Присутствие файла — только
+ * состав поставки. Слабейшая проба ВЫБИРАЕТСЯ ТОЛЬКО тогда, когда сильнее нечего запустить, и её
+ * слабость названа в тексте `why`, чтобы читатель отчёта не принял её за полную проверку.
+ */
+export declare function planCleanRoom(manifest: ManifestLike): CleanRoomPlan;
+/** Что наблюдалось в контейнере. `exitCode: null` — процесс не завершился сам (убит, срок). */
+export interface CleanRoomObservation {
+    readonly plan: CleanRoomPlan;
+    readonly installOk: boolean;
+    readonly installOutput: string;
+    readonly exitCode: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type CleanRoomVerdict = {
+    readonly ok: true;
+    readonly detail: string;
+    readonly limit: string;
+} | {
+    readonly ok: false;
+    readonly detail: string;
+};
+/** Оговорка, которую вердикт несёт ВСЕГДА: зелень чистой комнаты ≠ регистрация у клиента. */
+export declare const CLEAN_ROOM_LIMIT: string;
+/**
+ * Превратить наблюдение в вердикт.
+ *
+ * УСПЕХ НЕ ВЫВОДИТСЯ ИЗ ТИШИНЫ: отсутствие вывода при нулевом коде — не доказательство запуска, и
+ * для пробы бинаря требуется НЕПУСТОЙ вывод. Установка, не завершившаяся успехом, делает любой
+ * последующий результат бессмысленным, и это говорится первой строкой.
+ */
+export declare function cleanRoomVerdict(o: CleanRoomObservation): CleanRoomVerdict;
+export {};
+//# sourceMappingURL=clean-room-smoke.d.ts.map

package/dist/clean-room-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-room-smoke.d.ts","sourceRoot":"","sources":["../src/clean-room-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,CAsCnE;AA8BD,+FAA+F;AAC/F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,QAEoE,CAAC;AAElG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CAyB1E"}

package/dist/clean-room-smoke.js

@@ -0,0 +1,138 @@
+/**
+ * Чистая комната: проверить пакет так, как его увидит НОВЫЙ пользователь.
+ *
+ * ЗАЧЕМ. Разработчик забыл включить файл в поставку — на его машине всё работает, потому что файл
+ * лежит рядом в репозитории; у покупателя коробка приходит без детали. Класс называется
+ * `files[]`/install-layout, и локальный прогон его не ловит ПО ПОСТРОЕНИЮ: он видит рабочее дерево.
+ *
+ * ЧЕСТНАЯ ГРАНИЦА, названная сразу и повторённая в вердикте: «в чистой комнате завелось» НЕ РАВНО
+ * «Claude Code пакет увидел». ИЗМЕРЕНО ранее: health-advisor 1.2.0 был зелёным в чистой комнате на
+ * пакете, чьи навыки не регистрировались вовсе. Это ДОПОЛНЕНИЕ к живой пробе регистрации, а не её
+ * замена.
+ *
+ * ЧИСТАЯ ПОЛОВИНА. Здесь нет ни Docker, ни файловой системы: `planCleanRoom` решает, ЧТО осмысленно
+ * запустить для этого манифеста, а `cleanRoomVerdict` превращает НАБЛЮДЕНИЕ в вердикт. Обе половины
+ * проверяются без контейнера; запускает их скрипт `scripts/clean-room-smoke.mjs`.
+ */
+/**
+ * Выбрать пробу по манифесту — от самой сильной к самой слабой.
+ *
+ * ПОРЯДОК НЕ ПРОИЗВОЛЕН. Запуск бинаря проверяет и установку, и разрешение зависимостей, и то,
+ * что точка входа физически приехала. Импорт проверяет первые две. Присутствие файла — только
+ * состав поставки. Слабейшая проба ВЫБИРАЕТСЯ ТОЛЬКО тогда, когда сильнее нечего запустить, и её
+ * слабость названа в тексте `why`, чтобы читатель отчёта не принял её за полную проверку.
+ */
+export function planCleanRoom(manifest) {
+    if (manifest.private === true) {
+        return { kind: 'refuse', reason: 'пакет приватный — он не публикуется, и проверять поставку не для кого' };
+    }
+    const name = typeof manifest.name === 'string' && manifest.name.trim() !== '' ? manifest.name.trim() : null;
+    if (name === null) {
+        return { kind: 'refuse', reason: 'манифест не называет пакет — установить его в чистой комнате нельзя' };
+    }
+    const binName = firstBinName(manifest.bin, name);
+    if (binName !== null) {
+        return {
+            kind: 'bin', binName, argv: ['--help'],
+            why: 'запуск исполняемого файла проверяет установку, разрешение зависимостей И то, что точка входа приехала в поставке',
+        };
+    }
+    // ИМПОРТ ОСМЫСЛЕН, ТОЛЬКО ЕСЛИ ТОЧКА ВХОДА — ЗАГРУЖАЕМЫЙ МОДУЛЬ. ИЗМЕРЕНО 2026-09-04:
+    // `@dzhechkov/keysarium-core` объявляет `main: "index.md"`, и импорт падает с «Unknown file
+    // extension ".md"» — это верное наблюдение О МАНИФЕСТЕ, но негодная ПРОБА поставки: пакет
+    // документационный, и его состав проверяется присутствием файла. Обвинять поставку в том, что
+    // объявлено в манифесте, — путать два разных дефекта.
+    if (isLoadableEntry(manifest.main) || manifest.exports !== undefined) {
+        return {
+            kind: 'import', packageName: name,
+            why: 'импорт проверяет установку и разрешение зависимостей; ЧТО пакет делает — не проверяется',
+        };
+    }
+    const probe = firstFile(manifest.files);
+    if (probe !== null) {
+        return {
+            kind: 'files-only', probeFile: probe,
+            why: 'у пакета нет ни исполняемого файла, ни точки входа — проверяется ТОЛЬКО то, что объявленный файл приехал; это самая слабая из проб',
+        };
+    }
+    return { kind: 'refuse', reason: 'манифест не объявляет ни bin, ни точки входа, ни files — запускать в чистой комнате нечего' };
+}
+/** Загружаемая ли это точка входа: расширение, которое Node умеет исполнять как модуль. */
+function isLoadableEntry(main) {
+    return typeof main === 'string' && /\.(?:js|mjs|cjs|node)$/i.test(main.trim());
+}
+/** Первое имя из `bin`. Строка — это имя самого пакета (без области), объект — первый ключ. */
+function firstBinName(bin, packageName) {
+    if (typeof bin === 'string' && bin.trim() !== '') {
+        const base = packageName.startsWith('@') ? packageName.split('/')[1] ?? packageName : packageName;
+        return base;
+    }
+    if (typeof bin === 'object' && bin !== null && !Array.isArray(bin)) {
+        for (const key of Object.keys(bin)) {
+            if (key.trim() !== '')
+                return key;
+        }
+    }
+    return null;
+}
+/** Первый ОБЫЧНЫЙ путь из `files` — образцы (`*`) проверять присутствием нельзя. */
+function firstFile(files) {
+    if (!Array.isArray(files))
+        return null;
+    for (const f of files) {
+        if (typeof f === 'string' && f.trim() !== '' && !f.includes('*'))
+            return f.replace(/\/+$/, '');
+    }
+    return null;
+}
+/** Оговорка, которую вердикт несёт ВСЕГДА: зелень чистой комнаты ≠ регистрация у клиента. */
+export const CLEAN_ROOM_LIMIT = 'чистая комната доказывает, что поставка УСТАНАВЛИВАЕТСЯ и запускается; она НЕ доказывает, '
+    + 'что Claude Code увидел навыки пакета — для этого живая проба регистрации (dz skills-verify)';
+/**
+ * Превратить наблюдение в вердикт.
+ *
+ * УСПЕХ НЕ ВЫВОДИТСЯ ИЗ ТИШИНЫ: отсутствие вывода при нулевом коде — не доказательство запуска, и
+ * для пробы бинаря требуется НЕПУСТОЙ вывод. Установка, не завершившаяся успехом, делает любой
+ * последующий результат бессмысленным, и это говорится первой строкой.
+ */
+export function cleanRoomVerdict(o) {
+    if (o.plan.kind === 'refuse') {
+        return { ok: false, detail: `проба не выбрана: ${o.plan.reason}` };
+    }
+    if (!o.installOk) {
+        // Провалившаяся установка делает любой последующий результат бессмысленным — и это говорится
+        // ПЕРВОЙ строкой, чтобы читатель не искал причину в проверке.
+        return { ok: false, detail: `установка из тарбола НЕ прошла — всё остальное о ней ничего не говорит: ${firstLine(o.installOutput)}` };
+    }
+    if (o.exitCode === null) {
+        return { ok: false, detail: 'проба не завершилась сама (убита или истёк срок) — исход НЕ УСТАНОВЛЕН, и это не успех' };
+    }
+    if (o.exitCode !== 0) {
+        return { ok: false, detail: `проба вышла с кодом ${o.exitCode}: ${firstLine(o.stderr) || firstLine(o.stdout) || '(вывода нет)'}` };
+    }
+    if (o.plan.kind === 'bin' && o.stdout.trim() === '' && o.stderr.trim() === '') {
+        // Ноль и тишина — это не «сработало». Ровно так выглядит бинарь, чья точка входа не приехала,
+        // если оболочка проглотила ошибку: успех, выведенный из тишины, и есть тот дефект, который
+        // чистая комната обязана ловить.
+        return { ok: false, detail: 'исполняемый файл вышел с нулём и НИЧЕГО не написал — тишина не доказывает запуск' };
+    }
+    const what = o.plan.kind === 'bin' ? `\`${o.plan.binName} ${o.plan.argv.join(' ')}\``
+        : o.plan.kind === 'import' ? `импорт ${o.plan.packageName}`
+            : `присутствие ${o.plan.probeFile}`;
+    return { ok: true, detail: `установка прошла, ${what} — успешно`, limit: CLEAN_ROOM_LIMIT };
+}
+/**
+ * Первая строка, которая ОБЪЯСНЯЕТ отказ, а не первая непустая.
+ *
+ * ИЗМЕРЕНО 2026-09-04 на живом прогоне: у сломанной поставки первой непустой строкой оказалась
+ * `node:fs:560` — кадр стека. Такой текст в вердикте отправляет читателя в файл среды выполнения
+ * вместо причины (`ENOENT … templates/…`). Поэтому сначала ищется строка, ПОХОЖАЯ на сообщение об
+ * ошибке, и только если такой нет — берётся первая непустая.
+ */
+function firstLine(text) {
+    const lines = String(text ?? '').split('\n').map((l) => l.trim()).filter((l) => l !== '');
+    const explains = lines.find((l) => /\b(?:Error|ENOENT|EACCES|ERR_[A-Z_]+|Cannot find|not found|npm ERR!)\b/i.test(l));
+    const chosen = explains ?? lines[0];
+    return chosen === undefined ? '' : chosen.slice(0, 200);
+}
+//# sourceMappingURL=clean-room-smoke.js.map

package/dist/clean-room-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-room-smoke.js","sourceRoot":"","sources":["../src/clean-room-smoke.ts"],"names":[],"mappings":"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"}

package/dist/cmd-usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-usage.d.ts","sourceRoot":"","sources":["../src/cmd-usage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cmd-usage.d.ts","sourceRoot":"","sources":["../src/cmd-usage.ts"],"names":[],"mappings":"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"}

package/dist/cmd-usage.js

@@ -26,17 +26,47 @@ const DAY_MS = 86_400_000;
 export function resolveCmdUsageRoot(startDir) {
     try {
         let dir = resolve(startDir);
+        let nearestStore = null;
         for (let level = 0; level < 64; level += 1) {
-            try {
-                if (statSync(join(dir, '.dz')).isDirectory())
-                    return dir;
+            // Ближайший `.dz` запоминается, но НЕ возвращается сразу — см. объяснение ниже.
+            if (nearestStore === null) {
+                try {
+                    if (statSync(join(dir, '.dz')).isDirectory())
+                        nearestStore = dir;
+                }
+                catch { /* not here; keep walking */ }
             }
-            catch {
-                /* not here; keep walking */
+            // ГРАНИЦА РЕПОЗИТОРИЯ ВЫИГРЫВАЕТ У БЛИЖАЙШЕГО СКЛАДА, и вот почему.
+            //
+            // ИЗМЕРЕНО 2026-09-03: прогон `dz`, чей рабочий каталог оказался внутри пакета, создал там
+            // `.dz/` — и с того момента поиск останавливался на нём. Итог: 1149 записей об использовании
+            // команд уехали в склад внутри пакета вместо корневого, где их 17 265. Журнал разошёлся
+            // надвое молча, и обнаружил это только тест, требовавший корень монорепо.
+            //
+            // Тот же класс, что чинился в p-replicator неделей раньше, но зеркально: там поиск шёл ВЫШЕ
+            // границы репозитория, здесь останавливается НИЖЕ неё. Общее правило одно — у поиска корня
+            // должна быть НАЗВАННАЯ граница, а не первое попавшееся совпадение.
+            const atBoundary = (() => {
+                for (const marker of ['.git', 'pnpm-workspace.yaml']) {
+                    try {
+                        statSync(join(dir, marker));
+                        return true;
+                    }
+                    catch { /* keep checking */ }
+                }
+                return false;
+            })();
+            if (atBoundary) {
+                try {
+                    if (statSync(join(dir, '.dz')).isDirectory())
+                        return dir;
+                }
+                catch { /* граница без склада — отдаём ближайший найденный */ }
+                return nearestStore ?? startDir;
             }
             const parent = dirname(dir);
             if (parent === dir)
-                return startDir;
+                return nearestStore ?? startDir;
             dir = parent;
         }
     }