@imolko/ultra-agent 0.1.1 → 0.2.0-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/cli.js +0 -0
- package/dist-node/payload.d.ts +3 -2
- package/dist-node/payload.d.ts.map +1 -1
- package/dist-node/payload.js +3 -2
- package/dist-node/payload.js.map +1 -1
- package/dist-node/ship/ship.tracker.d.ts.map +1 -1
- package/dist-node/ship/ship.tracker.js +12 -11
- package/dist-node/ship/ship.tracker.js.map +1 -1
- package/docs/adr/ADR-0000-proceso-y-formato-de-adrs.md +15 -7
- package/docs/adr/foundational/A-034-canonical-skill-set.md +1 -1
- package/docs/adr/foundational/A-042-formato-documentos-issue-tracker.md +1 -0
- package/docs/adr/foundational/A-043-vocabulario-etiquetas-adrs.md +1 -1
- package/docs/adr/foundational/A-052-distribucion-metodologia-paquete-versionado.md +1 -1
- package/docs/adr/foundational/A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md +1 -1
- package/docs/adr/foundational/A-054-contrato-costura-driver-port-raw-data-canal-error.md +1 -1
- package/docs/adr/index.md +1 -1
- package/docs/adr/typescript/T-002-test-documentation-jsdoc.md +1 -1
- package/eslint/index.mjs +67 -7
- package/package.json +6 -3
- package/pi/extensions/qa-guardrail/README.md +6 -2
- package/pi/extensions/qa-guardrail/selection.ts +41 -7
- package/scripts/ensure-bin-exec.mjs +16 -0
- package/scripts/verify-adr-consistency.py +42 -9
package/bin/cli.js
CHANGED
|
File without changes
|
package/dist-node/payload.d.ts
CHANGED
|
@@ -10,8 +10,9 @@
|
|
|
10
10
|
export declare const GATE_RELATIVE_PATH = "scripts/verify-adr-consistency.py";
|
|
11
11
|
/**
|
|
12
12
|
* ¿Es un archivo del registro ADR canónico (tier A/T/P o ADR-0000 o índice raíz)?
|
|
13
|
-
*
|
|
14
|
-
*
|
|
13
|
+
* Cualquier otro `.md` en la raíz de `docs/adr/` es tier de proyecto y queda
|
|
14
|
+
* excluido: los ADRs nuevos usan el prefijo canónico `PJ-` (ADR-0000) y los ya
|
|
15
|
+
* aceptados conservan el prefijo con el que fueron aceptados (no se renumeran).
|
|
15
16
|
*/
|
|
16
17
|
export declare function isCanonicalAdr(relativePath: string): boolean;
|
|
17
18
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAQtE
|
|
1
|
+
{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAQtE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM5D"}
|
package/dist-node/payload.js
CHANGED
|
@@ -19,8 +19,9 @@ function normalize(path) {
|
|
|
19
19
|
}
|
|
20
20
|
/**
|
|
21
21
|
* ¿Es un archivo del registro ADR canónico (tier A/T/P o ADR-0000 o índice raíz)?
|
|
22
|
-
*
|
|
23
|
-
*
|
|
22
|
+
* Cualquier otro `.md` en la raíz de `docs/adr/` es tier de proyecto y queda
|
|
23
|
+
* excluido: los ADRs nuevos usan el prefijo canónico `PJ-` (ADR-0000) y los ya
|
|
24
|
+
* aceptados conservan el prefijo con el que fueron aceptados (no se renumeran).
|
|
24
25
|
*/
|
|
25
26
|
function isCanonicalAdr(relativePath) {
|
|
26
27
|
const path = normalize(relativePath);
|
package/dist-node/payload.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;
|
|
1
|
+
{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiBH,wCAYC;AAMD,gDAMC;AAvCD,oFAAoF;AACvE,QAAA,kBAAkB,GAAG,mCAAmC,CAAC;AAEtE,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,YAAoB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,KAAe;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,0BAAkB,CAAC;IAC7D,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ship.tracker.d.ts","sourceRoot":"","sources":["../../src/ship/ship.tracker.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,eAAO,MAAM,YAAY,0BAA0B,CAAC;AACpD,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAClD,eAAO,MAAM,QAAQ,cAAc,CAAC;AAMpC,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAO3C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAUhD;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAM/C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAKjC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAYvC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAS3C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAapD;AAED,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE,CAgBpF;
|
|
1
|
+
{"version":3,"file":"ship.tracker.d.ts","sourceRoot":"","sources":["../../src/ship/ship.tracker.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,eAAO,MAAM,YAAY,0BAA0B,CAAC;AACpD,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAClD,eAAO,MAAM,QAAQ,cAAc,CAAC;AAMpC,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAO3C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAUhD;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAM/C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAKjC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAYvC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAS3C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAapD;AAED,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE,CAgBpF;AAMD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAgB,GAAG,OAAO,CAiB9F;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAM7C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAgB,GAAG,KAAK,GAAG,IAAI,CAa9G;AAID,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQvC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM3F;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ7C"}
|
|
@@ -133,30 +133,31 @@ function getLinkedChildren(projectEncoded, parentIid) {
|
|
|
133
133
|
});
|
|
134
134
|
}
|
|
135
135
|
// ── Frontier (deterministic; the orchestrator owns it) ────────────────────────
|
|
136
|
+
const BLOCKER_SECTION_NAMES = ["bloqueado por", "blocked by"];
|
|
136
137
|
function extractBlockers(description) {
|
|
137
138
|
const lines = description.split("\n");
|
|
138
139
|
let inBlockerSection = false;
|
|
139
140
|
const refs = [];
|
|
140
141
|
for (const line of lines) {
|
|
141
|
-
|
|
142
|
-
|
|
142
|
+
const heading = line.match(/^#{1,6}\s+(.*)$/);
|
|
143
|
+
if (heading) {
|
|
144
|
+
if (inBlockerSection)
|
|
145
|
+
break;
|
|
146
|
+
if (BLOCKER_SECTION_NAMES.includes(heading[1].trim().toLowerCase())) {
|
|
147
|
+
inBlockerSection = true;
|
|
148
|
+
}
|
|
143
149
|
continue;
|
|
144
150
|
}
|
|
145
|
-
if (inBlockerSection)
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
if (match)
|
|
150
|
-
refs.push(parseInt(match[1], 10));
|
|
151
|
+
if (!inBlockerSection)
|
|
152
|
+
continue;
|
|
153
|
+
for (const match of line.matchAll(/#(\d+)/g)) {
|
|
154
|
+
refs.push(parseInt(match[1], 10));
|
|
151
155
|
}
|
|
152
156
|
}
|
|
153
157
|
return [...new Set(refs)];
|
|
154
158
|
}
|
|
155
159
|
function isBlocked(issue, fetchIssue = getIssue) {
|
|
156
160
|
const blockers = extractBlockers(issue.description);
|
|
157
|
-
if (issue.description.toLowerCase().includes("ninguno - puede iniciarse")) {
|
|
158
|
-
return false;
|
|
159
|
-
}
|
|
160
161
|
if (blockers.length === 0)
|
|
161
162
|
return false;
|
|
162
163
|
for (const ref of blockers) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ship.tracker.js","sourceRoot":"","sources":["../../src/ship/ship.tracker.ts"],"names":[],"mappings":";;;AA2CA,oBAOC;AAED,4BAUC;AAGD,4BAMC;AAED,gCAKC;AAOD,sDAQC;AAED,wCAYC;AAED,8CAEC;AAED,4BASC;AAED,4CAaC;AAED,8CAgBC;
|
|
1
|
+
{"version":3,"file":"ship.tracker.js","sourceRoot":"","sources":["../../src/ship/ship.tracker.ts"],"names":[],"mappings":"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"}
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
|
|
11
11
|
## Contexto
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
La metodología ultra mantiene un registro de decisiones de arquitectura (ADR) distribuido en varios tiers y decenas de archivos. Hasta ahora la información sobre *cómo* se escriben y gobiernan esos ADRs vivía dispersa en las secciones "Formato" y "Tiers" de `docs/adr/index.md`, sin respaldo de decisión: no estaba escrito por qué se usa el formato de Michael Nygard, por qué la metodología se organiza en tres tiers más un tier de proyecto, ni qué reglas se aplican para mantener la consistencia.
|
|
14
14
|
|
|
15
15
|
Sin un ADR que canonice el proceso, cada decisión nueva corre el riesgo de:
|
|
16
16
|
|
|
@@ -19,7 +19,7 @@ Sin un ADR que canonice el proceso, cada decisión nueva corre el riesgo de:
|
|
|
19
19
|
- omitir campos obligatorios como `originally` o las etiquetas;
|
|
20
20
|
- introducir enlaces rotos o listas duplicadas que el gate detecta.
|
|
21
21
|
|
|
22
|
-
Este documento es el **meta-ADR**: define el proceso y el formato que el resto de ADRs debe seguir. Vive en la raíz de `docs/adr/` y usa el ID `0000` precisamente porque está **fuera** de la jerarquía A→T/P→
|
|
22
|
+
Este documento es el **meta-ADR**: define el proceso y el formato que el resto de ADRs debe seguir. Vive en la raíz de `docs/adr/` y usa el ID `0000` precisamente porque está **fuera** de la jerarquía A→T/P→tier de proyecto: define esa jerarquía y, por lo tanto, no pertenece a ninguno de sus tiers. Por su nombre no es detectado por el gate de consistencia, lo cual es correcto.
|
|
23
23
|
|
|
24
24
|
## Decisión
|
|
25
25
|
|
|
@@ -43,7 +43,7 @@ Además del título H1 (`# <ID>: <Título descriptivo>`), cada ADR lleva un **fr
|
|
|
43
43
|
| `**Enriquecido desde**` | No | Fuente de enriquecimiento posterior (cuando aplica). |
|
|
44
44
|
| `**tags**` | Sí (tier A hoy) | De una a tres etiquetas del vocabulario en [A-043](./foundational/A-043-vocabulario-etiquetas-adrs.md). |
|
|
45
45
|
|
|
46
|
-
El gate valida el formato H1 y la ortografía exacta de `originally` (minúsculas) y `Enriquecido desde` (capitalización exacta) para los ADRs de los tiers A/T/P/
|
|
46
|
+
El gate valida el formato H1 y la ortografía exacta de `originally` (minúsculas) y `Enriquecido desde` (capitalización exacta) para los ADRs de los tiers A/T/P. El tier de proyecto del consumidor queda fuera del gate distribuido ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)).
|
|
47
47
|
|
|
48
48
|
### Jerarquía de tiers: A → T/P → tier de proyecto
|
|
49
49
|
|
|
@@ -54,7 +54,7 @@ Los ADRs se organizan en tres tiers de metodología más el tier de proyecto de
|
|
|
54
54
|
| **Fundacional (A)** | [`foundational/`](./foundational/index.md) | Decisiones metodológicas agnósticas al lenguaje (Clean Architecture, TDD, comandos y consultas, DDD). Aplican a todos los proyectos de Imolko. |
|
|
55
55
|
| **TypeScript (T)** | [`typescript/`](./typescript/index.md) | Decisiones específicas del ecosistema TypeScript/Zod/Node.js. |
|
|
56
56
|
| **Python (P)** | [`python/`](./python/index.md) | Decisiones específicas del ecosistema Python (FastAPI, SQLAlchemy, Pydantic). |
|
|
57
|
-
| **Tier de proyecto** | `docs/adr/` (raíz) u otro directorio del consumidor | Decisiones específicas del dominio del
|
|
57
|
+
| **Tier de proyecto** | `docs/adr/` (raíz) u otro directorio del consumidor | Decisiones específicas del dominio del consumidor. El prefijo canónico es `PJ` (`PJ-NNN`) para todo ADR nuevo, independientemente del nombre del proyecto; los IDs ya aceptados conservan el prefijo con el que fueron aceptados. No forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)). |
|
|
58
58
|
|
|
59
59
|
**Reglas de referencia** (jerarquía estricta):
|
|
60
60
|
|
|
@@ -64,6 +64,14 @@ Los ADRs se organizan en tres tiers de metodología más el tier de proyecto de
|
|
|
64
64
|
|
|
65
65
|
La numeración es **estable**: los IDs existentes no se renumeran. Los IDs omitidos intencionalmente (por ejemplo A-021) no se reutilizan.
|
|
66
66
|
|
|
67
|
+
### Enmienda (2026-10-20): prefijo canónico del tier de proyecto
|
|
68
|
+
|
|
69
|
+
Esta enmienda sustituye la regla anterior, que dejaba el prefijo del tier de proyecto a elección de cada proyecto, y precisa el alcance del gate sin cambiar el formato ni la jerarquía:
|
|
70
|
+
|
|
71
|
+
- **Prefijo canónico `PJ-NNN`.** Todo ADR nuevo del tier de proyecto del consumidor usa el prefijo `PJ` (`PJ-001`, `PJ-002`, …), independientemente del nombre del proyecto. El nombre de un consumidor concreto no forma parte del formato canónico.
|
|
72
|
+
- **IDs existentes sin renumerar.** Los ADRs del tier de proyecto ya aceptados por un consumidor conservan el prefijo y el número con los que fueron aceptados; la numeración estable de arriba los ampara. No se migran ni se renumeran.
|
|
73
|
+
- **El gate valida solo A, T y P.** La regla `jerarquia` y el resto de reglas del gate se aplican a los tiers de metodología. El tier de proyecto pertenece al consumidor y no se distribuye ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)), así que queda fuera del gate distribuido.
|
|
74
|
+
|
|
67
75
|
### Fases narrativas del tier fundacional
|
|
68
76
|
|
|
69
77
|
Los ADRs fundacionales (A-XXX) se agrupan en fases narrativas; el orden y el agrupamiento exactos viven en [`foundational/index.md`](./foundational/index.md), que es quien porta la narrativa. Las fases son una organización de lectura; no cambian la numeración ni los tiers.
|
|
@@ -80,7 +88,7 @@ El gate valida **cinco reglas** y debe salir con código `0` y cero violaciones:
|
|
|
80
88
|
|
|
81
89
|
| Regla | Qué valida |
|
|
82
90
|
|-------|------------|
|
|
83
|
-
| `jerarquia` | Los ADRs no referencian tiers prohibidos según la jerarquía A→T/P→tier de proyecto. |
|
|
91
|
+
| `jerarquia` | Los ADRs A/T/P no referencian tiers prohibidos según la jerarquía A→T/P→tier de proyecto, ni por enlace markdown ni por cita en texto plano a un ID con prefijo no permitido para el tier (A solo cita A; T cita A y T; P cita A y P). Cualquier otro prefijo —por ejemplo `G-NNN` o `PJ-NNN`— también es una violación, porque ningún ADR A/T/P referencia el tier de proyecto. |
|
|
84
92
|
| `enlaces` | Todos los enlaces markdown internos (relativos, `*.md`) resuelven a un archivo existente. |
|
|
85
93
|
| `frontmatter` | El título sigue `# <TIER>-<NNN>: Título` y los campos `originally` / `Enriquecido desde` usan la ortografía correcta. |
|
|
86
94
|
| `indices` | Cada ADR aparece en el índice de su tier y el índice no lista ADRs inexistentes. |
|
|
@@ -98,7 +106,7 @@ Cada ADR transita por un ciclo de vida simple:
|
|
|
98
106
|
|
|
99
107
|
Reglas de numeración:
|
|
100
108
|
|
|
101
|
-
- El siguiente ADR de un tier toma el siguiente número correlativo (`A-NNN`, `T-NNN`, `P-NNN`,
|
|
109
|
+
- El siguiente ADR de un tier toma el siguiente número correlativo (`A-NNN`, `T-NNN`, `P-NNN`, `PJ-NNN`).
|
|
102
110
|
- Los IDs omitidos intencionalmente (por ejemplo A-021) **no se reutilizan**: permanecen omitidos para preservar la estabilidad de los IDs existentes.
|
|
103
111
|
|
|
104
112
|
## Consecuencias
|
|
@@ -108,7 +116,7 @@ Reglas de numeración:
|
|
|
108
116
|
- **Proceso canonizado**: el formato, la jerarquía y el gate dejan de vivir dispersos y pasan a tener respaldo de decisión.
|
|
109
117
|
- **Onboarding más corto**: un colaborador nuevo lee un único ADR para entender cómo contribuir decisiones.
|
|
110
118
|
- **Consistencia ejecutable**: el gate automatiza la verificación de las cinco reglas, con salida 0 como criterio de aceptación.
|
|
111
|
-
- **Jerarquía clara**: las reglas de referencia entre tiers evitan acoplamientos incorrectos (por ejemplo, un ADR fundacional citando uno de
|
|
119
|
+
- **Jerarquía clara**: las reglas de referencia entre tiers evitan acoplamientos incorrectos (por ejemplo, un ADR fundacional citando uno del tier de proyecto).
|
|
112
120
|
|
|
113
121
|
### Negativas
|
|
114
122
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
**originally**: mattpocock-skills
|
|
8
8
|
|
|
9
|
-
**Enriquecido desde**: mattpocock/skills — taxonomía canónica de skills (engineering + productivity), adaptada al registro ADR de
|
|
9
|
+
**Enriquecido desde**: mattpocock/skills — taxonomía canónica de skills (engineering + productivity), adaptada al registro ADR de la metodología ultra
|
|
10
10
|
|
|
11
11
|
**tags**: agentes, tooling
|
|
12
12
|
|
|
@@ -45,6 +45,7 @@ Una sola copia canónica aquí; los skills las apuntan en lugar de duplicarlas:
|
|
|
45
45
|
- Las secciones son **Header 1** (`# Nombre de sección`).
|
|
46
46
|
- Las secciones van seguidas, delimitadas solo por sus títulos.
|
|
47
47
|
- El título de sección es solo el nombre de la sección.
|
|
48
|
+
- `# Bloqueado por` es el título canónico de la sección de bloqueos; `# Blocked by` es la forma aceptada por `ship` ([A-039](./A-039-pipeline-ship-issues-hijos-spec.md)) para repos con `issue_language: en`.
|
|
48
49
|
- El texto es texto plano.
|
|
49
50
|
- Todo el texto en el idioma del repo (`issue_language`, [A-052](./A-052-distribucion-metodologia-paquete-versionado.md)).
|
|
50
51
|
- Markup del tracker (`tracker_cli`, [A-052](./A-052-distribucion-metodologia-paquete-versionado.md)).
|
|
@@ -27,7 +27,7 @@ El vocabulario aprobado de etiquetas vive aquí, en el tier fundacional, como fu
|
|
|
27
27
|
| `agentes` | Colaboradores LLM, bloques de prompt. |
|
|
28
28
|
| `tooling` | Herramientas del flujo de trabajo (gate, scripts, generadores). |
|
|
29
29
|
|
|
30
|
-
El campo `**tags**` en sí — su obligatoriedad y su forma — lo define [ADR-0000](../ADR-0000-proceso-y-formato-de-adrs.md); este ADR posee los valores y su semántica. Los tiers T, P y
|
|
30
|
+
El campo `**tags**` en sí — su obligatoriedad y su forma — lo define [ADR-0000](../ADR-0000-proceso-y-formato-de-adrs.md); este ADR posee los valores y su semántica. Los tiers T, P y el tier de proyecto (PJ-) pueden referenciar este ADR cuando adopten etiquetas.
|
|
31
31
|
|
|
32
32
|
## Consecuencias
|
|
33
33
|
|
|
@@ -19,7 +19,7 @@ El formato de los skills ya es el estándar Agent Skills, agnóstico al harness,
|
|
|
19
19
|
Distribuir la metodología como un **paquete npm versionado por suscripción**: `@imolko/ultra-agent`. El consumidor instala una versión, la actualiza subiendo de versión y nunca edita el contenido canónico.
|
|
20
20
|
|
|
21
21
|
1. **Modelo de suscripción.** El conjunto canónico es de solo lectura en el repositorio consumidor. El consumidor añade sus propios artefactos —skills de proyecto y ADRs de su tier de proyecto— en ubicaciones que el instalador nunca toca. La regla es **«extender, no editar»**: si el consumidor disiente de una decisión canónica, escribe su propio skill o ADR en su espacio, no modifica el canónico.
|
|
22
|
-
2. **Límite de contenido.** Se distribuye solo la metodología: los tiers A, T y P, el meta-ADR `ADR-0000`, el gate de consistencia, los skills canónicos, las extensiones de pi y el **preset de lint** que materializa las reglas ejecutables del tier A — los guardrails aplicables ([A-045](./A-045-guardrails-aplicables-no-directrices.md)) y las reglas estructurales de costura y errores ([A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md), [A-054](./A-054-contrato-costura-driver-port-raw-data-canal-error.md)) —. Los ADRs del tier de proyecto de
|
|
22
|
+
2. **Límite de contenido.** Se distribuye solo la metodología: los tiers A, T y P, el meta-ADR `ADR-0000`, el gate de consistencia, los skills canónicos, las extensiones de pi y el **preset de lint** que materializa las reglas ejecutables del tier A — los guardrails aplicables ([A-045](./A-045-guardrails-aplicables-no-directrices.md)) y las reglas estructurales de costura y errores ([A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md), [A-054](./A-054-contrato-costura-driver-port-raw-data-canal-error.md)) —. Los ADRs del tier de proyecto de cada consumidor (prefijo `PJ-`) no forman parte del paquete.
|
|
23
23
|
3. **Espejo de ADRs.** El instalador copia los tiers A, T y P en el `adr_dir` del consumidor como archivos de solo lectura. La actualización reconcilia el espejo y nunca toca el tier de proyecto ni los READMEs de dominio del consumidor.
|
|
24
24
|
4. **Mecanismo.** Un CLI —`npx @imolko/ultra-agent install | update | status`— materializa el conjunto en las ubicaciones de descubrimiento de cada harness y registra un manifiesto de versión para poder reconciliar después.
|
|
25
25
|
5. **Deriva.** Si el consumidor edita un archivo espejado, `update` falla en voz alta ([A-007](./A-007-data-contract-fail-fast.md)) y solo se resuelve con `--reset`, que respalda antes de sobrescribir. No existe `--keep`: conservar una edición del espejo viola el modelo de solo lectura.
|
package/docs/adr/foundational/A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md
CHANGED
|
@@ -15,7 +15,7 @@ Los casos de uso de `features/` producen errores que tienden a duplicarse featur
|
|
|
15
15
|
- **Referencias de dominio**: la ausencia de un agregado en una consulta ("no existe"). [A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) ya las clasifica como error de dominio: el puerto de dominio nunca retorna `null`; la ausencia la traduce el adaptador y, en una consulta, se convierte en error de dominio.
|
|
16
16
|
- **Fallos de infraestructura**: producidos en la costura del driver ([A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md), [A-026](./A-026-infraestructura-compartida.md)) — caída de la base de datos, fallo del generador de identificadores, fallo de publicación de eventos —, ajenos al dominio.
|
|
17
17
|
|
|
18
|
-
[A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) clasifica cada especie pero no fija su **hogar**. Sin un hogar canónico, el mismo error vive duplicado por feature y su identidad estable se dispersa según el nombre de la feature. La regla se formalizó primero en el tier de proyecto de
|
|
18
|
+
[A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) clasifica cada especie pero no fija su **hogar**. Sin un hogar canónico, el mismo error vive duplicado por feature y su identidad estable se dispersa según el nombre de la feature. La regla se formalizó primero en el tier de proyecto de un consumidor; al ser independiente del dominio, se eleva aquí al tier fundacional.
|
|
19
19
|
|
|
20
20
|
## Decisión
|
|
21
21
|
|
|
@@ -16,7 +16,7 @@ El driver port es la costura raw-data entre el adaptador y el driver tecnológic
|
|
|
16
16
|
2. **Hasta dónde llega la regla de raw data**. [A-025](./A-025-anatomia-mecanica-feature-puertos-adaptadores-drivers.md) la enuncia en general pero la costura de escritura no event-shaped quedaba sin regla escrita: los driver ports podían recibir agregados o value objects del dominio en `save(...)`, haciendo cruzar el objeto con comportamiento por la costura.
|
|
17
17
|
3. **La frontera de «raw»**. «Ningún tipo del dominio cruza la costura» se leía como una regla de dirección de imports ([A-001](./A-001-clean-architecture-4-capas.md)), cuando la frontera real es **raw vs. comportamiento**: las formas serializables sin comportamiento (mementos/snapshots, la envolvente estándar de eventos, DTOs planos) sí cruzan —se declaren donde se declaren—; los objetos con comportamiento (agregados, entidades, value objects) y el hecho de dominio sin confirmar (que porta una referencia de clase, no data) no cruzan.
|
|
18
18
|
|
|
19
|
-
El hogar del error de infraestructura ya existe: [A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md) decide que los fallos de infraestructura viven en el catálogo compartido de la capa de aplicación y **los produce el adaptador** al traducir el fallo del driver. Faltaba la mitad de la costura: el canal por el que el driver entrega ese fallo. La regla se formalizó primero en el tier de proyecto de
|
|
19
|
+
El hogar del error de infraestructura ya existe: [A-053](./A-053-errores-compartidos-entre-features-dos-hogares-por-capa.md) decide que los fallos de infraestructura viven en el catálogo compartido de la capa de aplicación y **los produce el adaptador** al traducir el fallo del driver. Faltaba la mitad de la costura: el canal por el que el driver entrega ese fallo. La regla se formalizó primero en el tier de proyecto de un consumidor; al ser independiente del dominio, se eleva aquí al tier fundacional.
|
|
20
20
|
|
|
21
21
|
## Decisión
|
|
22
22
|
|
package/docs/adr/index.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Architecture Decision Records (ADR)
|
|
2
2
|
|
|
3
|
-
Registro de decisiones de arquitectura canónico del equipo Imolko. Cubre la metodología ultra en tres tiers — fundacional (agnóstico al lenguaje), TypeScript y Python —. Cada
|
|
3
|
+
Registro de decisiones de arquitectura canónico del equipo Imolko. Cubre la metodología ultra en tres tiers — fundacional (agnóstico al lenguaje), TypeScript y Python —. Cada repositorio consumidor añade su propio tier de proyecto con sus decisiones de dominio, con el prefijo canónico `PJ-` ([ADR-0000](./ADR-0000-proceso-y-formato-de-adrs.md)), y ese tier no forma parte de la metodología distribuida ([A-052](./foundational/A-052-distribucion-metodologia-paquete-versionado.md)).
|
|
4
4
|
|
|
5
5
|
El proceso, el formato y las reglas que gobiernan estos ADRs están documentados en [ADR-0000: Proceso y formato de los ADRs](./ADR-0000-proceso-y-formato-de-adrs.md).
|
|
6
6
|
|
|
@@ -35,7 +35,7 @@ it('crear ProductId vacío', () => {
|
|
|
35
35
|
| `@name` coincide con `it()` | El texto de `@name` debe ser **idéntico** al primer argumento de `it()`. Esto asegura que el título en la documentación generada coincida con el nombre del test en el runner. |
|
|
36
36
|
| `@scenario` describe el qué y por qué | Explica qué entrada se usa, qué regla se ejerce, y qué resultado se espera. Debe ser comprensible para un experto del dominio sin conocimientos técnicos. |
|
|
37
37
|
| Sin "falla si…" en títulos | El título del test (`it()` y `@name`) describe **el escenario**, no el resultado. Ej: `'crear ProductId vacío'` en lugar de `'crear ProductId vacío – falla si está vacío'`. El resultado lo expresa `@scenario`. |
|
|
38
|
-
| Idioma del repo | Los nombres y descripciones van en el idioma
|
|
38
|
+
| Idioma del repo | Los nombres y descripciones van en el idioma configurado por el repositorio (`issue_language`), fijado por [A-003](../foundational/A-003-tdd.md): por ejemplo, español. |
|
|
39
39
|
| Primera línea: descripción larga | La primera línea del JSDoc (antes de `@name`) contiene una descripción extendida del comportamiento verificado. |
|
|
40
40
|
|
|
41
41
|
> **Ámbito**: la convención aplica a tests que documentan reglas de dominio o comportamiento de casos de uso. Los tests de contrato (validación de esquemas y tipos, por ejemplo `*.contract.spec.ts`) quedan fuera: validan estructura, no reglas de dominio, y no se convierten en casos documentados para expertos del dominio.
|
package/eslint/index.mjs
CHANGED
|
@@ -47,11 +47,19 @@ import boundaries from "eslint-plugin-boundaries";
|
|
|
47
47
|
/** Archivos que el preset cubre por defecto. */
|
|
48
48
|
export const PRESET_FILES = ["**/*.{ts,tsx,js,mjs,cjs}"];
|
|
49
49
|
|
|
50
|
-
/**
|
|
50
|
+
/**
|
|
51
|
+
* Carpetas y archivos que el preset ignora por defecto.
|
|
52
|
+
*
|
|
53
|
+
* Los patrones son relativos al directorio del `eslint.config.*` que invoca el
|
|
54
|
+
* preset (flat config): `build/**` ancla `build/` a la raíz y no oculta un
|
|
55
|
+
* workspace de dominio llamado `build` (p. ej. `domain/build/**`). Los ignores
|
|
56
|
+
* de artefactos que sí pueden aparecer anidados (`dist`, `coverage`,
|
|
57
|
+
* `node_modules`) conservan el doble glob a propósito (A-001, A-045/A-046).
|
|
58
|
+
*/
|
|
51
59
|
export const PRESET_IGNORES = [
|
|
52
60
|
"**/node_modules/**",
|
|
53
61
|
"**/dist/**",
|
|
54
|
-
"
|
|
62
|
+
"build/**",
|
|
55
63
|
"**/coverage/**",
|
|
56
64
|
"temp-*/**",
|
|
57
65
|
".ultra-reporter/**",
|
|
@@ -443,10 +451,54 @@ const LAYER_DEPENDENCY_POLICIES = [
|
|
|
443
451
|
},
|
|
444
452
|
];
|
|
445
453
|
|
|
446
|
-
const
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
454
|
+
const LAYER_DEPENDENCIES_DEFAULT = "disallow";
|
|
455
|
+
|
|
456
|
+
/**
|
|
457
|
+
* Valida las policies extra del consumidor. El hook es aditivo: la matriz
|
|
458
|
+
* canónica de `LAYER_DEPENDENCY_POLICIES` se evalúa **después** de las policies
|
|
459
|
+
* del consumidor, así que la canónica sigue vigente sin reescribirse,
|
|
460
|
+
* `default: "disallow"` sigue gobernando lo no declarado y una policy extra no
|
|
461
|
+
* puede retirar un permiso canónico. Extender no puede contradecir A-001/A-026:
|
|
462
|
+
* si la matriz canónica parece equivocada, se reporta upstream en lugar de
|
|
463
|
+
* compensarla desde el consumidor.
|
|
464
|
+
*
|
|
465
|
+
* @param {unknown} policies
|
|
466
|
+
* @returns {Array<Record<string, unknown>>}
|
|
467
|
+
*/
|
|
468
|
+
function requirePolicies(policies) {
|
|
469
|
+
if (policies === undefined) {
|
|
470
|
+
return [];
|
|
471
|
+
}
|
|
472
|
+
if (
|
|
473
|
+
!Array.isArray(policies) ||
|
|
474
|
+
policies.some(
|
|
475
|
+
(policy) =>
|
|
476
|
+
typeof policy !== "object" || policy === null || Array.isArray(policy),
|
|
477
|
+
)
|
|
478
|
+
) {
|
|
479
|
+
throw new Error(
|
|
480
|
+
"El preset @imolko/ultra-agent/eslint espera `policies` como array de objetos de política de `eslint-plugin-boundaries`.",
|
|
481
|
+
);
|
|
482
|
+
}
|
|
483
|
+
return policies;
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
/**
|
|
487
|
+
* Compone las opciones de `boundaries/dependencies`: las policies extra del
|
|
488
|
+
* consumidor primero y la matriz canónica después. `eslint-plugin-boundaries`
|
|
489
|
+
* aplica *last-match-wins*, así que poner la canónica al final garantiza que el
|
|
490
|
+
* hook solo pueda ganar permisos: una policy extra con `disallow` nunca anula
|
|
491
|
+
* una arista que la matriz permite (A-052: extender, no editar).
|
|
492
|
+
*
|
|
493
|
+
* @param {Array<Record<string, unknown>>} extra
|
|
494
|
+
* @returns {{ default: string, policies: unknown[] }}
|
|
495
|
+
*/
|
|
496
|
+
function layerDependenciesOptions(extra) {
|
|
497
|
+
return {
|
|
498
|
+
default: LAYER_DEPENDENCIES_DEFAULT,
|
|
499
|
+
policies: [...extra, ...LAYER_DEPENDENCY_POLICIES],
|
|
500
|
+
};
|
|
501
|
+
}
|
|
450
502
|
|
|
451
503
|
/**
|
|
452
504
|
* Construye las reglas de orden de imports por distancia (A-051): builtins,
|
|
@@ -599,18 +651,26 @@ function elementDescriptors(layers) {
|
|
|
599
651
|
* internal: string,
|
|
600
652
|
* layers?: Record<string, string>,
|
|
601
653
|
* rawSeamTypes?: string[],
|
|
654
|
+
* policies?: Array<Record<string, unknown>>,
|
|
602
655
|
* }} options Opciones del preset. `internal` es obligatorio: el prefijo del
|
|
603
656
|
* paquete interno del consumidor. `layers` sobreescribe los globs de capa
|
|
604
657
|
* (defaults de A-001) y admite la clave `feature-error` para el catálogo de
|
|
605
658
|
* errores de A-053. `rawSeamTypes` extiende, con fragmentos de expresión
|
|
606
659
|
* regular, las formas raw que cruzan el driver port (A-054) cuando el
|
|
607
660
|
* consumidor nombra sus DTOs al margen de los sufijos por defecto.
|
|
661
|
+
* `policies` extiende la matriz de dependencias con policies de
|
|
662
|
+
* `eslint-plugin-boundaries` que se evalúan **antes** de la matriz canónica
|
|
663
|
+
* (A-052): es aditivo, no la reemplaza, y como la canónica gana el último
|
|
664
|
+
* match, una policy extra puede permitir más pero nunca retirar un permiso de
|
|
665
|
+
* la matriz ni contradecir A-001/A-026 (si la matriz parece equivocada, se
|
|
666
|
+
* reporta upstream).
|
|
608
667
|
* @returns {import("eslint").Linter.Config[]}
|
|
609
668
|
*/
|
|
610
669
|
export function createPreset(options) {
|
|
611
670
|
const internal = requireInternal(options?.internal);
|
|
612
671
|
const layers = resolveLayers(options?.layers);
|
|
613
672
|
const rawSeamTypes = requireRawSeamTypes(options?.rawSeamTypes);
|
|
673
|
+
const policies = requirePolicies(options?.policies);
|
|
614
674
|
|
|
615
675
|
return [
|
|
616
676
|
{ ignores: PRESET_IGNORES },
|
|
@@ -646,7 +706,7 @@ export function createPreset(options) {
|
|
|
646
706
|
rules: {
|
|
647
707
|
...STYLE_RULES,
|
|
648
708
|
...importRules(internal),
|
|
649
|
-
"boundaries/dependencies": ["error",
|
|
709
|
+
"boundaries/dependencies": ["error", layerDependenciesOptions(policies)],
|
|
650
710
|
},
|
|
651
711
|
},
|
|
652
712
|
{
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@imolko/ultra-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0-beta",
|
|
4
4
|
"description": "Metodología ultra como paquete versionado: skills canónicos, registro ADR A/T/P, extensiones de pi y CLI (install/update/status/ship).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": {
|
|
@@ -46,11 +46,13 @@
|
|
|
46
46
|
]
|
|
47
47
|
},
|
|
48
48
|
"scripts": {
|
|
49
|
-
"test": "vitest run",
|
|
49
|
+
"test": "vitest run && npm run test:guardrail",
|
|
50
|
+
"test:guardrail": "vitest run --root pi/extensions/qa-guardrail",
|
|
50
51
|
"test:watch": "vitest",
|
|
51
52
|
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
52
53
|
"clean": "rm -rf dist-node",
|
|
53
54
|
"build": "npm run clean && tsc -p tsconfig.json && bash scripts/copy-assets.sh",
|
|
55
|
+
"prepack": "node scripts/ensure-bin-exec.mjs",
|
|
54
56
|
"gate": "python3 scripts/verify-adr-consistency.py"
|
|
55
57
|
},
|
|
56
58
|
"files": [
|
|
@@ -83,7 +85,8 @@
|
|
|
83
85
|
"eslint": "^9.0.0",
|
|
84
86
|
"eslint-import-resolver-typescript": "^4.4.5",
|
|
85
87
|
"eslint-plugin-boundaries": "^7.2.0",
|
|
86
|
-
"eslint-plugin-import-x": "^4.17.1"
|
|
88
|
+
"eslint-plugin-import-x": "^4.17.1",
|
|
89
|
+
"minimatch": "^10"
|
|
87
90
|
},
|
|
88
91
|
"devDependencies": {
|
|
89
92
|
"@imolko/ultra-tsconfig": "1.1.0",
|
|
@@ -16,7 +16,11 @@ Además, el hook `tool_call` congela la línea base del archivo *antes* de la pr
|
|
|
16
16
|
Antes de todo eso, el **cerco** bloquea en `tool_call`: los caminos protegidos hardcodeados (`eslint.config.mjs`, `.pi/qa-guardrail.json`, `.pi/extensions/qa-guardrail/**`) y las directivas nuevas `eslint-disable*` en `write.content` / `edit.newText`. El cerco es independiente de ESLint y de la selección: se aplica aunque el config esté ausente o el archivo no esté cubierto por ningún adaptador.
|
|
17
17
|
Por conservadurismo, `checkCerco` bloquea cualquier directiva presente en `edit.newText` aunque ya estuviera en `oldText` (mover una directiva heredada se bloquea como «nueva»): posible falso positivo, coherente con «el cerco prohíbe desactivar reglas en línea».
|
|
18
18
|
|
|
19
|
-
**Límite del cerco**: solo cerca las herramientas `write`/`edit`. El agente aún podría tocar `eslint.config.mjs` o inyectar `eslint-disable*` vía `bash` (p. ej. `sed`/`cat`); ese hueco es una limitación estructural
|
|
19
|
+
**Límite del cerco**: solo cerca las herramientas `write`/`edit`. El agente aún podría tocar `eslint.config.mjs` o inyectar `eslint-disable*` vía `bash` (p. ej. `sed`/`cat`); ese hueco es una limitación estructural del cerco, cuyo dueño es [A-049](../../../docs/adr/foundational/A-049-materializacion-bucle-guardrails-extension-nativa-pi.md) (el cerco opera sobre `tool_call` de write/edit), no una desviación del spec.
|
|
20
|
+
|
|
21
|
+
**Punto de enforcement fuera de `write`/`edit`**: el hueco no queda sin cubrir; lo cubre el **gate de merge**. Ese es el punto de enforcement de la capa 2 de [A-045](../../../docs/adr/foundational/A-045-guardrails-aplicables-no-directrices.md) (linting) materializada como gate en el pipeline de integración continua de [A-016](../../../docs/adr/foundational/A-016-cicd-gitlab-pipeline-raiz-pipelines-modulares.md), que revisa el MR completo y lo rechaza: no distingue si la edición vino de `write`/`edit` o de un heredoc de `bash`. La extensión da retroalimentación temprana en el ciclo de edición; el gate de merge es el que decide si el cambio entra.
|
|
22
|
+
|
|
23
|
+
**Para agentes**: editar un camino protegido desde `bash` **no** es una vía alternativa al cerco: el gate de merge lo rechaza en el MR. Si la tarea exige tocar la definición de reglas o desactivar una regla, el agente se detiene y lo reporta a la persona ([A-045](../../../docs/adr/foundational/A-045-guardrails-aplicables-no-directrices.md), principio 2).
|
|
20
24
|
|
|
21
25
|
Sin violaciones nuevas, no se anexa nada.
|
|
22
26
|
Además, `/qa-guardrail check` hace un **barrido completo** (no delta-scoped) de los archivos que coinciden con la configuración: lista las violaciones y las directivas `eslint-disable*` heredadas, sin bloquear nada. Sirve de inventario de migración.
|
|
@@ -101,7 +105,7 @@ npm test # todos los tests una vez
|
|
|
101
105
|
npm run test:watch # watch mode
|
|
102
106
|
```
|
|
103
107
|
|
|
104
|
-
`eslint` y `minimatch` son
|
|
108
|
+
`eslint` y `minimatch` ya no dependen del árbol del anfitrión: ambos son dependencias declaradas del paquete raíz (`package.json`), así que la instalación de `@imolko/ultra-agent` los provee. Aun así se cargan perezosamente: `eslint` se importa dinámicamente en el primer lint y `minimatch` se resuelve en la primera selección. Si `minimatch` no está disponible, la selección no cubre nada (fail-closed); si `eslint` no está (o su config está rota), el adaptador lanza y el runner avisa y omite el feedback — nunca un pase silencioso. Cargar la extensión no exige ninguno de los dos.
|
|
105
109
|
|
|
106
110
|
## Desarrollo
|
|
107
111
|
|
|
@@ -4,9 +4,11 @@
|
|
|
4
4
|
*
|
|
5
5
|
* `minimatch` is loaded lazily (and cached) on first use, so loading this
|
|
6
6
|
* module — and the extension that imports it — never requires `minimatch` to
|
|
7
|
-
* be installed.
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* be installed. Both the callable v9 export and the `{ minimatch }` namespace
|
|
8
|
+
* of v10 are accepted. If it cannot be resolved, selection fails closed (no
|
|
9
|
+
* file matches, hence no adapter runs), mirroring the lazy-linter contract of
|
|
10
|
+
* A-049. A matcher that throws also fails closed (no file matches) instead of
|
|
11
|
+
* taking down `write`/`edit`.
|
|
10
12
|
*/
|
|
11
13
|
|
|
12
14
|
import { createRequire } from "node:module";
|
|
@@ -22,11 +24,33 @@ type Minimatch = (path: string, pattern: string, options?: { dot?: boolean }) =>
|
|
|
22
24
|
|
|
23
25
|
let cachedMatcher: Minimatch | null | undefined;
|
|
24
26
|
|
|
27
|
+
/**
|
|
28
|
+
* Normalize the loaded module to a callable matcher: v9 exports the function
|
|
29
|
+
* directly, v10 exports a `{ minimatch, sep, … }` namespace. Anything else
|
|
30
|
+
* yields `null` (fail-closed).
|
|
31
|
+
*/
|
|
32
|
+
export function resolveMinimatchModule(mod: unknown): Minimatch | null {
|
|
33
|
+
if (typeof mod === "function") {
|
|
34
|
+
return mod as Minimatch;
|
|
35
|
+
}
|
|
36
|
+
if (
|
|
37
|
+
typeof mod === "object" &&
|
|
38
|
+
mod !== null &&
|
|
39
|
+
typeof (mod as { minimatch?: unknown }).minimatch === "function"
|
|
40
|
+
) {
|
|
41
|
+
return (mod as { minimatch: Minimatch }).minimatch;
|
|
42
|
+
}
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
|
|
25
46
|
function loadMinimatch(): Minimatch | null {
|
|
26
47
|
try {
|
|
27
48
|
const require = createRequire(import.meta.url);
|
|
28
|
-
const
|
|
29
|
-
|
|
49
|
+
const matcher = resolveMinimatchModule(require("minimatch") as unknown);
|
|
50
|
+
if (!matcher) {
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
return (path, pattern) => matcher(path, pattern, { dot: true });
|
|
30
54
|
} catch {
|
|
31
55
|
return null;
|
|
32
56
|
}
|
|
@@ -44,6 +68,15 @@ export function setGlobMatcher(matcher: Minimatch | null | undefined): void {
|
|
|
44
68
|
cachedMatcher = matcher;
|
|
45
69
|
}
|
|
46
70
|
|
|
71
|
+
/** Match one pattern, degrading a throwing matcher to "no match". */
|
|
72
|
+
function matches(matcher: Minimatch, path: string, pattern: string): boolean {
|
|
73
|
+
try {
|
|
74
|
+
return matcher(path, pattern) === true;
|
|
75
|
+
} catch {
|
|
76
|
+
return false;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
|
|
47
80
|
/**
|
|
48
81
|
* True when `absPath` is selected by the tool entry's include/exclude globs.
|
|
49
82
|
*
|
|
@@ -51,6 +84,7 @@ export function setGlobMatcher(matcher: Minimatch | null | undefined): void {
|
|
|
51
84
|
* - An empty `include` list matches nothing (fail-closed, like ESLint flat config).
|
|
52
85
|
* - `exclude` wins over `include`.
|
|
53
86
|
* - A missing glob matcher matches nothing (fail-closed, never a load error).
|
|
87
|
+
* - A matcher that throws matches nothing (fail-closed, never a tool error).
|
|
54
88
|
*/
|
|
55
89
|
export function isFileSelected(absPath: string, entry: ToolEntry, cwd: string): boolean {
|
|
56
90
|
const rel = toPosixPath(relative(resolve(cwd), resolve(absPath)));
|
|
@@ -66,14 +100,14 @@ export function isFileSelected(absPath: string, entry: ToolEntry, cwd: string):
|
|
|
66
100
|
if (entry.include.length === 0) {
|
|
67
101
|
return false;
|
|
68
102
|
}
|
|
69
|
-
const included = entry.include.some((pattern) => matcher
|
|
103
|
+
const included = entry.include.some((pattern) => matches(matcher, rel, pattern));
|
|
70
104
|
if (!included) {
|
|
71
105
|
return false;
|
|
72
106
|
}
|
|
73
107
|
if (entry.exclude.length === 0) {
|
|
74
108
|
return true;
|
|
75
109
|
}
|
|
76
|
-
const excluded = entry.exclude.some((pattern) => matcher
|
|
110
|
+
const excluded = entry.exclude.some((pattern) => matches(matcher, rel, pattern));
|
|
77
111
|
return !excluded;
|
|
78
112
|
}
|
|
79
113
|
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Asegura que el CLI se publique con bit de ejecución.
|
|
4
|
+
*
|
|
5
|
+
* El blob de git solo distingue ejecutable / no ejecutable, y `npm pack`
|
|
6
|
+
* conserva ese modo: un `bin/cli.js` en 100644 produce un tarball que algunos
|
|
7
|
+
* gestores de paquetes no reparan. Se ejecuta en `prepack` para que el
|
|
8
|
+
* artefacto sea correcto por sí mismo (A-007, A-052 §4).
|
|
9
|
+
*
|
|
10
|
+
* En Windows el modo POSIX no aplica: el script es un no-op.
|
|
11
|
+
*/
|
|
12
|
+
import { chmodSync } from "node:fs";
|
|
13
|
+
|
|
14
|
+
if (process.platform !== "win32") {
|
|
15
|
+
chmodSync("bin/cli.js", 0o755);
|
|
16
|
+
}
|
|
@@ -2,8 +2,12 @@
|
|
|
2
2
|
"""Gate de consistencia del registro ADR (ADR-0000).
|
|
3
3
|
|
|
4
4
|
Valida cinco reglas y sale con código 0 solo si no hay violaciones:
|
|
5
|
-
- jerarquia los ADRs no referencian tiers prohibidos (A
|
|
6
|
-
|
|
5
|
+
- jerarquia los ADRs no referencian tiers prohibidos (A solo cita A; T cita A y T;
|
|
6
|
+
P cita A y P). Detecta tanto enlaces markdown como citas en texto plano a
|
|
7
|
+
IDs `<PREFIJO>-NNN`: una cita con un prefijo no permitido para el tier —o
|
|
8
|
+
con cualquier otro prefijo, incluidos G y PJ— es una violación, porque
|
|
9
|
+
ningún ADR A/T/P referencia el tier de proyecto. Una misma referencia
|
|
10
|
+
prohibida se reporta una sola vez aunque aparezca como enlace y como ID.
|
|
7
11
|
- enlaces todos los enlaces markdown internos (relativos, *.md) resuelven a un
|
|
8
12
|
archivo existente.
|
|
9
13
|
- frontmatter el título H1 sigue `# <TIER>-<NNN>: Título` y los campos `originally` /
|
|
@@ -102,23 +106,52 @@ ALLOWED_TARGETS = {
|
|
|
102
106
|
"P": {"A", "P", "meta"},
|
|
103
107
|
}
|
|
104
108
|
|
|
109
|
+
# Citas en texto plano a un ID de ADR. Una a dos letras mayúsculas evita falsos
|
|
110
|
+
# positivos con identificadores de tres letras (ISO-8601, RFC-2119, SHA-256).
|
|
111
|
+
PLAIN_ID_RE = re.compile(r"\b([A-Z]{1,2})-\d{3}\b")
|
|
112
|
+
|
|
113
|
+
# Destino de un enlace markdown inline `](destino)`. Se elimina antes del escaneo
|
|
114
|
+
# de texto plano para que una referencia no se reporte también como cita.
|
|
115
|
+
LINK_TARGET_RE = re.compile(r"\]\([^)]*\)")
|
|
116
|
+
|
|
117
|
+
# Enlace markdown inline completo: etiqueta y destino. La etiqueta puede citar el
|
|
118
|
+
# ID cuando el destino no lo contiene (p. ej. `[T-001](../typescript/index.md)`).
|
|
119
|
+
LINK_RE = re.compile(r"\[([^\]]*)\]\(([^)]*)\)")
|
|
120
|
+
|
|
105
121
|
|
|
106
122
|
def rule_jerarquia() -> None:
|
|
107
123
|
for tier, allowed in ALLOWED_TARGETS.items():
|
|
124
|
+
allowed_prefixes = {t for t in allowed if t in TIER_DIRS}
|
|
108
125
|
for adr in tier_adr_files(tier):
|
|
109
126
|
text = adr.read_text(encoding="utf-8")
|
|
110
|
-
|
|
127
|
+
reported_ids = set()
|
|
128
|
+
|
|
129
|
+
for label, target in LINK_RE.findall(text):
|
|
111
130
|
resolved = resolve_link(adr, target)
|
|
112
131
|
if resolved is None:
|
|
113
132
|
continue
|
|
114
133
|
resolved_tier = target_tier(resolved)
|
|
115
|
-
if resolved_tier is None:
|
|
134
|
+
if resolved_tier is None or resolved_tier in allowed:
|
|
116
135
|
continue
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
136
|
+
# Los IDs citados por el enlace —en la etiqueta o en el destino—
|
|
137
|
+
# quedan cubiertos por esta violación y no se reportan otra vez.
|
|
138
|
+
for match in PLAIN_ID_RE.finditer(f"{label} {target}"):
|
|
139
|
+
reported_ids.add(match.group(0))
|
|
140
|
+
report(
|
|
141
|
+
"jerarquia",
|
|
142
|
+
f"{adr.relative_to(ROOT)} referencia al tier {resolved_tier} ({target}), prohibido para el tier {tier}",
|
|
143
|
+
)
|
|
144
|
+
|
|
145
|
+
plain_text = LINK_TARGET_RE.sub("", text)
|
|
146
|
+
for match in PLAIN_ID_RE.finditer(plain_text):
|
|
147
|
+
prefix, ident = match.group(1), match.group(0)
|
|
148
|
+
if prefix in allowed_prefixes or ident in reported_ids:
|
|
149
|
+
continue
|
|
150
|
+
reported_ids.add(ident)
|
|
151
|
+
report(
|
|
152
|
+
"jerarquia",
|
|
153
|
+
f"{adr.relative_to(ROOT)} cita en texto plano {ident} (prefijo {prefix}), prohibido para el tier {tier}",
|
|
154
|
+
)
|
|
122
155
|
|
|
123
156
|
|
|
124
157
|
def rule_enlaces() -> None:
|