@softize/opus 12.6.1 → 12.6.2

package/CHANGELOG.md

@@ -7,6 +7,12 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 12.6.2 — 2026-08-26
+
+O `postinstall` passa a materializar `base.json` e `opus.json` somente a partir do exemplar de
+`@softize/opus` resolvido pelo workspace declarado. Versões transitivas instaladas no mesmo projeto
+não disputam mais esses marcadores durante instalações concorrentes.
+
 ## 12.6.1 — 2026-08-26
 
 Os padrões de UI passam a distinguir melhor estrutura e ação. `Page` centraliza o conteúdo com

package/bin/lib/postinstall-target.mjs

@@ -0,0 +1,32 @@
+import { realpathSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+
+import { readProjectFile, safeProjectPath } from '@softize/base/project-path'
+
+function resolutionDirectory(projectDir) {
+  try {
+    const base = JSON.parse(readProjectFile(projectDir, 'base.json', { allowMissing: true }).content || '{}')
+    const resolveFrom = base?.packages?.['@softize/opus']?.resolveFrom
+    if (typeof resolveFrom !== 'string') return projectDir
+    const candidate = safeProjectPath(projectDir, resolveFrom, { mustExist: true })
+    return candidate.kind === 'directory' ? candidate.path : projectDir
+  } catch {
+    return projectDir
+  }
+}
+
+/**
+ * Só o exemplar resolvido pelo workspace declarado pode materializar o projeto.
+ * Gerenciadores de pacote executam o postinstall de exemplares transitivos com o mesmo
+ * INIT_CWD; sem esta prova, versões diferentes disputam base.json e opus.json.
+ */
+export function isResolvedOpusInstance(projectDir, packageRoot) {
+  try {
+    const from = resolutionDirectory(projectDir)
+    const resolved = createRequire(path.join(from, 'package.json')).resolve('@softize/opus/package.json')
+    return realpathSync(path.dirname(resolved)) === realpathSync(packageRoot)
+  } catch {
+    return false
+  }
+}

package/bin/lib/postinstall.mjs

@@ -19,6 +19,7 @@ import { fileURLToPath } from 'node:url'
 import { canonicalProjectDirectory, readProjectFile } from '@softize/base/project-path'
 
 import { initProject } from './init.mjs'
+import { isResolvedOpusInstance } from './postinstall-target.mjs'
 
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..')
 const REGISTRY_DIR = path.join(PACKAGE_ROOT, 'registry')
@@ -40,6 +41,7 @@ async function main() {
   if (pkg.name === '@softize/opus') return
   const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) }
   if (!deps['@softize/opus']) return // Não é consumidor do Opus.
+  if (!isResolvedOpusInstance(projectDir, PACKAGE_ROOT)) return
 
   const r = await initProject(REGISTRY_DIR, projectDir)
   if (!r.materialization.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "12.6.1",
+  "version": "12.6.2",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",