@wildo-ai/wildo-cli 1.1.3 → 1.1.4
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/dist/src/commands/context/__tests__/assurance-basis.command.test.d.ts +2 -0
- package/dist/src/commands/context/__tests__/assurance-basis.command.test.d.ts.map +1 -0
- package/dist/src/commands/context/__tests__/assurance-basis.command.test.js +63 -0
- package/dist/src/commands/context/__tests__/assurance-basis.command.test.js.map +1 -0
- package/dist/src/commands/context/assurance-basis.command.d.ts +61 -0
- package/dist/src/commands/context/assurance-basis.command.d.ts.map +1 -0
- package/dist/src/commands/context/assurance-basis.command.js +166 -0
- package/dist/src/commands/context/assurance-basis.command.js.map +1 -0
- package/dist/src/commands/dev/charts-audit.command.d.ts +5 -3
- package/dist/src/commands/dev/charts-audit.command.d.ts.map +1 -1
- package/dist/src/commands/dev/charts-audit.command.js +35 -6
- package/dist/src/commands/dev/charts-audit.command.js.map +1 -1
- package/dist/src/commands/fwk/generate-providers.command.d.ts.map +1 -1
- package/dist/src/commands/fwk/generate-providers.command.js +18 -2
- package/dist/src/commands/fwk/generate-providers.command.js.map +1 -1
- package/dist/src/commands/generate/email-preview.command.d.ts +8 -0
- package/dist/src/commands/generate/email-preview.command.d.ts.map +1 -1
- package/dist/src/commands/generate/email-preview.command.js +57 -0
- package/dist/src/commands/generate/email-preview.command.js.map +1 -1
- package/dist/src/commands/init.command.d.ts.map +1 -1
- package/dist/src/commands/init.command.js +32 -0
- package/dist/src/commands/init.command.js.map +1 -1
- package/dist/src/commands/lock/check.command.d.ts.map +1 -1
- package/dist/src/commands/lock/check.command.js +3 -2
- package/dist/src/commands/lock/check.command.js.map +1 -1
- package/dist/src/commands/registry/login.command.d.ts.map +1 -1
- package/dist/src/commands/registry/login.command.js +2 -0
- package/dist/src/commands/registry/login.command.js.map +1 -1
- package/dist/src/commands/registry/publish.command.d.ts.map +1 -1
- package/dist/src/commands/registry/publish.command.js +2 -0
- package/dist/src/commands/registry/publish.command.js.map +1 -1
- package/dist/src/commands/registry/registry-transport.constants.d.ts +33 -0
- package/dist/src/commands/registry/registry-transport.constants.d.ts.map +1 -0
- package/dist/src/commands/registry/registry-transport.constants.js +33 -0
- package/dist/src/commands/registry/registry-transport.constants.js.map +1 -0
- package/dist/src/commands/registry/whoami.command.d.ts.map +1 -1
- package/dist/src/commands/registry/whoami.command.js +2 -0
- package/dist/src/commands/registry/whoami.command.js.map +1 -1
- package/dist/src/modules/domain/credentials/__tests__/approver-user.module.test.d.ts +2 -0
- package/dist/src/modules/domain/credentials/__tests__/approver-user.module.test.d.ts.map +1 -0
- package/dist/src/modules/domain/credentials/__tests__/approver-user.module.test.js +146 -0
- package/dist/src/modules/domain/credentials/__tests__/approver-user.module.test.js.map +1 -0
- package/dist/src/modules/domain/credentials/approver-user.module.d.ts +85 -0
- package/dist/src/modules/domain/credentials/approver-user.module.d.ts.map +1 -0
- package/dist/src/modules/domain/credentials/approver-user.module.js +92 -0
- package/dist/src/modules/domain/credentials/approver-user.module.js.map +1 -0
- package/dist/src/services/application/__tests__/app-bootstrap.approving-administrator.test.d.ts +2 -0
- package/dist/src/services/application/__tests__/app-bootstrap.approving-administrator.test.d.ts.map +1 -0
- package/dist/src/services/application/__tests__/app-bootstrap.approving-administrator.test.js +111 -0
- package/dist/src/services/application/__tests__/app-bootstrap.approving-administrator.test.js.map +1 -0
- package/dist/src/services/application/__tests__/provider-package-links.service.test.js +68 -0
- package/dist/src/services/application/__tests__/provider-package-links.service.test.js.map +1 -1
- package/dist/src/services/application/app-bootstrap.service.d.ts +9 -0
- package/dist/src/services/application/app-bootstrap.service.d.ts.map +1 -1
- package/dist/src/services/application/app-bootstrap.service.js +30 -1
- package/dist/src/services/application/app-bootstrap.service.js.map +1 -1
- package/dist/src/services/application/application-runtime-bootstrap.service.d.ts +6 -0
- package/dist/src/services/application/application-runtime-bootstrap.service.d.ts.map +1 -1
- package/dist/src/services/application/application-runtime-bootstrap.service.js +41 -0
- package/dist/src/services/application/application-runtime-bootstrap.service.js.map +1 -1
- package/dist/src/services/application/provider-package-links.service.d.ts +30 -0
- package/dist/src/services/application/provider-package-links.service.d.ts.map +1 -1
- package/dist/src/services/application/provider-package-links.service.js +35 -3
- package/dist/src/services/application/provider-package-links.service.js.map +1 -1
- package/dist/src/services/application/provider-runtime-sync.service.d.ts.map +1 -1
- package/dist/src/services/application/provider-runtime-sync.service.js +4 -3
- package/dist/src/services/application/provider-runtime-sync.service.js.map +1 -1
- package/dist/src/services/application/saas-skeleton.service.d.ts.map +1 -1
- package/dist/src/services/application/saas-skeleton.service.js +22 -2
- package/dist/src/services/application/saas-skeleton.service.js.map +1 -1
- package/dist/src/services/companion/workbench-cli.service.js +10 -1
- package/dist/src/services/companion/workbench-cli.service.js.map +1 -1
- package/dist/src/services/credentials/__tests__/provider-contribution-registration.guard.test.d.ts +2 -0
- package/dist/src/services/credentials/__tests__/provider-contribution-registration.guard.test.d.ts.map +1 -0
- package/dist/src/services/credentials/__tests__/provider-contribution-registration.guard.test.js +94 -0
- package/dist/src/services/credentials/__tests__/provider-contribution-registration.guard.test.js.map +1 -0
- package/dist/src/services/credentials/ci-secrets-adapter.service.d.ts.map +1 -1
- package/dist/src/services/credentials/ci-secrets-adapter.service.js +16 -0
- package/dist/src/services/credentials/ci-secrets-adapter.service.js.map +1 -1
- package/dist/src/services/credentials/composed-provider-catalogue.d.ts +34 -0
- package/dist/src/services/credentials/composed-provider-catalogue.d.ts.map +1 -1
- package/dist/src/services/credentials/composed-provider-catalogue.js +35 -0
- package/dist/src/services/credentials/composed-provider-catalogue.js.map +1 -1
- package/dist/src/services/credentials/credentials.schemas.d.ts +27 -0
- package/dist/src/services/credentials/credentials.schemas.d.ts.map +1 -1
- package/dist/src/services/credentials/credentials.schemas.js +50 -0
- package/dist/src/services/credentials/credentials.schemas.js.map +1 -1
- package/dist/src/services/credentials/framework-managed-secrets.d.ts +1 -1
- package/dist/src/services/credentials/framework-managed-secrets.d.ts.map +1 -1
- package/dist/src/services/credentials/framework-managed-secrets.js +49 -8
- package/dist/src/services/credentials/framework-managed-secrets.js.map +1 -1
- package/dist/src/services/deployment/infra-writer.service.d.ts.map +1 -1
- package/dist/src/services/deployment/infra-writer.service.js +23 -4
- package/dist/src/services/deployment/infra-writer.service.js.map +1 -1
- package/dist/src/services/deployment/k8s/__tests__/k8s-bootstrap.service.test.js +45 -2
- package/dist/src/services/deployment/k8s/__tests__/k8s-bootstrap.service.test.js.map +1 -1
- package/dist/src/services/deployment/k8s/k8s-bootstrap.service.d.ts +23 -0
- package/dist/src/services/deployment/k8s/k8s-bootstrap.service.d.ts.map +1 -1
- package/dist/src/services/deployment/k8s/k8s-bootstrap.service.js +49 -6
- package/dist/src/services/deployment/k8s/k8s-bootstrap.service.js.map +1 -1
- package/dist/src/services/environment/env-vars-builder.service.d.ts.map +1 -1
- package/dist/src/services/environment/env-vars-builder.service.js +19 -0
- package/dist/src/services/environment/env-vars-builder.service.js.map +1 -1
- package/dist/src/services/framework/__tests__/engine-provider-specifications.reconciliation.test.js +8 -0
- package/dist/src/services/framework/__tests__/engine-provider-specifications.reconciliation.test.js.map +1 -1
- package/dist/src/services/framework/__tests__/framework-knowledge-audit.live.contract.test.js +17 -0
- package/dist/src/services/framework/__tests__/framework-knowledge-audit.live.contract.test.js.map +1 -1
- package/dist/src/services/framework/__tests__/framework-knowledge-audit.service.test.js +51 -0
- package/dist/src/services/framework/__tests__/framework-knowledge-audit.service.test.js.map +1 -1
- package/dist/src/services/framework/framework-knowledge-audit.service.d.ts +41 -1
- package/dist/src/services/framework/framework-knowledge-audit.service.d.ts.map +1 -1
- package/dist/src/services/framework/framework-knowledge-audit.service.js +90 -0
- package/dist/src/services/framework/framework-knowledge-audit.service.js.map +1 -1
- package/dist/src/services/framework/provider-transposition/__tests__/base-url-is-a-declared-env-slot.test.d.ts +2 -0
- package/dist/src/services/framework/provider-transposition/__tests__/base-url-is-a-declared-env-slot.test.d.ts.map +1 -0
- package/dist/src/services/framework/provider-transposition/__tests__/base-url-is-a-declared-env-slot.test.js +100 -0
- package/dist/src/services/framework/provider-transposition/__tests__/base-url-is-a-declared-env-slot.test.js.map +1 -0
- package/dist/src/services/framework/provider-transposition/__tests__/plan-matches-emit.test.js +55 -2
- package/dist/src/services/framework/provider-transposition/__tests__/plan-matches-emit.test.js.map +1 -1
- package/dist/src/services/framework/provider-transposition/provider-package.emitter.d.ts +9 -0
- package/dist/src/services/framework/provider-transposition/provider-package.emitter.d.ts.map +1 -1
- package/dist/src/services/framework/provider-transposition/provider-package.emitter.js +139 -19
- package/dist/src/services/framework/provider-transposition/provider-package.emitter.js.map +1 -1
- package/dist/src/services/frontend/cloudflare-cdn.service.d.ts.map +1 -1
- package/dist/src/services/frontend/cloudflare-cdn.service.js +33 -2
- package/dist/src/services/frontend/cloudflare-cdn.service.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +17 -17
- package/scripts/app-dependency-alignment/propagated-engine-overrides.json +13 -0
- package/templates/infra/docker-compose/docker-compose.wildo-platform.yml.hbs +64 -16
- package/templates/saas/engine-peer-closure.json +12 -0
- package/templates/saas/scenarios/add-provider/scenario.json +11 -11
- package/templates/saas/scenarios/add-technical-doc/files/technical-doc/docusaurus.config.ts.hbs +34 -0
- package/templates/saas/scenarios/add-technical-doc/files/technical-doc/src/pages/auth/exchange.tsx +24 -1
- package/templates/saas/scenarios/add-technical-doc/files/technical-doc/src/theme/Root.tsx +22 -2
- package/templates/saas/skeleton/backend-api/package.json.hbs +1 -1
- package/templates/saas/skeleton/backend-api/src/companion-exports.ts +13 -2
- package/wildo-framework.info.json +1 -1
- package/templates/saas/scenarios/add-backend-provider/scenario.json +0 -17
- package/templates/saas/skeleton/backend-api/src/provider-contributions.ts +0 -44
|
@@ -223,7 +223,27 @@ export declare enum FrameworkKnowledgeAuditRule {
|
|
|
223
223
|
* enforces the same predicate fail-closed; this rule is the PR-time copy that fails before anyone
|
|
224
224
|
* runs `generate-docs`.
|
|
225
225
|
*/
|
|
226
|
-
PlaybookContextSourcePlaceholderInvalid = "playbook-context-source-placeholder-invalid"
|
|
226
|
+
PlaybookContextSourcePlaceholderInvalid = "playbook-context-source-placeholder-invalid",
|
|
227
|
+
/**
|
|
228
|
+
* FAIL — a composite's `method.choreography.admits[]` entry names no authored playbook folder.
|
|
229
|
+
*
|
|
230
|
+
* Rule 30 (2026-09-09). Rule 13 has refused a `method.skillRefs` entry naming no authored skill
|
|
231
|
+
* since the catalog existed; `admits` is the same shape one field over and had no rule at all, so a
|
|
232
|
+
* composite could name a child that does not exist and nothing said so until it ran — and then only
|
|
233
|
+
* by omission. `runPlaybookChoreography` FILTERS an unresolvable ref out of the eligible set, so
|
|
234
|
+
* the lane simply does less than it declares, silently, on every iteration.
|
|
235
|
+
*
|
|
236
|
+
* The runtime consequence of a dangling child is already contained: the write-scope resolver treats
|
|
237
|
+
* an unresolvable child as UNKNOWN and fails closed rather than as the empty set, so nothing is
|
|
238
|
+
* granted a scope it should not have. Containment is not the same as detection, though — a
|
|
239
|
+
* fail-closed runtime says the composite is safe, never that it is complete — and the authoring-time
|
|
240
|
+
* answer belongs here, where the author is still present.
|
|
241
|
+
*
|
|
242
|
+
* FAIL rather than WARN, matching rule 13 and for the same reason: nothing is left to decide. A ref
|
|
243
|
+
* naming no folder is not a judgement call about the catalog's shape (which is what put rule 23 in
|
|
244
|
+
* the softer channel), it is a typo or a deletion that nobody swept, and the fix is mechanical.
|
|
245
|
+
*/
|
|
246
|
+
PlaybookChoreographyAdmitsUnknownPlaybook = "playbook-choreography-admits-unknown-playbook"
|
|
227
247
|
}
|
|
228
248
|
export interface FrameworkKnowledgeAuditFinding {
|
|
229
249
|
rule: FrameworkKnowledgeAuditRule;
|
|
@@ -238,6 +258,15 @@ export interface FrameworkKnowledgeAuditStats {
|
|
|
238
258
|
skillCount: number;
|
|
239
259
|
referenceFileCount: number;
|
|
240
260
|
playbookCount: number;
|
|
261
|
+
/**
|
|
262
|
+
* Total `method.choreography.admits[]` entries the parser LIFTED across the catalog.
|
|
263
|
+
*
|
|
264
|
+
* Exists because rule 30's clean answer and a blind one are otherwise identical: a parser that
|
|
265
|
+
* lifted nothing reports zero dangling children exactly as a healthy catalog does. This is the
|
|
266
|
+
* number that separates them, and the live contract asserts it is non-zero — the same reason every
|
|
267
|
+
* checker in `scripts/code-conduct/` ships a `--self-test`.
|
|
268
|
+
*/
|
|
269
|
+
choreographyChildRefCount: number;
|
|
241
270
|
}
|
|
242
271
|
export interface FrameworkKnowledgeAuditReport {
|
|
243
272
|
failures: FrameworkKnowledgeAuditFinding[];
|
|
@@ -575,6 +604,17 @@ export declare class FrameworkKnowledgeAuditService {
|
|
|
575
604
|
* why this join exists; the generator enforces the same predicate fail-closed at compile.
|
|
576
605
|
*/
|
|
577
606
|
private static checkRule28PlaybookContextSourcePlaceholder;
|
|
607
|
+
/**
|
|
608
|
+
* Rule 30 — every `method.choreography.admits[]` entry must name a discovered playbook folder.
|
|
609
|
+
*
|
|
610
|
+
* The population is the CATALOG itself, which is the one thing separating this from rule 13: a
|
|
611
|
+
* composite's children are playbooks, so the set it is checked against is the same set being
|
|
612
|
+
* iterated. That makes the empty-catalog guard load-bearing rather than defensive — a reader that
|
|
613
|
+
* parsed no playbook refs would report every child of every composite as dangling, which reads as a
|
|
614
|
+
* broken catalog instead of a broken reader.
|
|
615
|
+
*/
|
|
616
|
+
private static checkRule30PlaybookChoreographyAdmitsUnknownPlaybook;
|
|
617
|
+
private static readPlaybookChoreographyAdmits;
|
|
578
618
|
private static readPlaybookSkillRefs;
|
|
579
619
|
private static readPlaybookOutputSchemaRefs;
|
|
580
620
|
/** Families a playbook WRITES — the producer side of the catalog graph. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"framework-knowledge-audit.service.d.ts","sourceRoot":"","sources":["../../../../src/services/framework/framework-knowledge-audit.service.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"framework-knowledge-audit.service.d.ts","sourceRoot":"","sources":["../../../../src/services/framework/framework-knowledge-audit.service.ts"],"names":[],"mappings":"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"}
|
|
@@ -89,6 +89,22 @@ function readStaticStringArray(expression) {
|
|
|
89
89
|
.map((entry) => readStaticString(unwrapStaticExpression(entry)))
|
|
90
90
|
.filter((entry) => entry !== null);
|
|
91
91
|
}
|
|
92
|
+
/**
|
|
93
|
+
* `method.choreography.admits[]` — the composite's admissible CHILD playbook refs (rule 30).
|
|
94
|
+
*
|
|
95
|
+
* Split out rather than nested inline because `readStaticObjectProperty` takes an object literal and
|
|
96
|
+
* not a nullable expression, and `choreography` is optional on the schema: only a composite declares
|
|
97
|
+
* one, so an absent field is the ordinary case and must read as an empty set, never as a parse
|
|
98
|
+
* failure.
|
|
99
|
+
*/
|
|
100
|
+
function readStaticChoreographyAdmits(methodObject) {
|
|
101
|
+
if (methodObject === null)
|
|
102
|
+
return [];
|
|
103
|
+
const choreography = readStaticObjectProperty(methodObject, 'choreography');
|
|
104
|
+
if (choreography === null || !ts.isObjectLiteralExpression(choreography))
|
|
105
|
+
return [];
|
|
106
|
+
return readStaticStringArray(readStaticObjectProperty(choreography, 'admits'));
|
|
107
|
+
}
|
|
92
108
|
const EMPTY_PLAYBOOK_VOCABULARY = { enumMemberValues: new Map(), contextSourceValues: new Set() };
|
|
93
109
|
function loadPlaybookVocabulary(engineHome) {
|
|
94
110
|
const schemaPath = join(engineHome, 'saas-specifications', 'src', 'application-creation', 'playbooks.application-creation.schemas.ts');
|
|
@@ -328,6 +344,9 @@ function extractStaticPlaybookAuditShape(sourceFile, vocabulary) {
|
|
|
328
344
|
// read would blind rule 28 to every TypeScript-style playbook — the exact under-lift that
|
|
329
345
|
// once hid eleven playbooks' preconditions from rules 23/24/26 (see readStaticEnumBackedValue).
|
|
330
346
|
contextSources: methodObject === null ? [] : readStaticEnumBackedArray(readStaticObjectProperty(methodObject, 'contextSources'), enumLocalNames, vocabulary),
|
|
347
|
+
// Lifted for rule 30. `admits` names PLAYBOOK refs, so it is the one field in the projection
|
|
348
|
+
// whose referents are the catalog itself — parse it here or the rule has nothing to read.
|
|
349
|
+
choreography: { admits: readStaticChoreographyAdmits(methodObject) },
|
|
331
350
|
...(methodObject !== null && readStaticObjectProperty(methodObject, 'guidance') !== null ? { guidance: true } : {}),
|
|
332
351
|
},
|
|
333
352
|
outputs,
|
|
@@ -609,6 +628,26 @@ export var FrameworkKnowledgeAuditRule;
|
|
|
609
628
|
* runs `generate-docs`.
|
|
610
629
|
*/
|
|
611
630
|
FrameworkKnowledgeAuditRule["PlaybookContextSourcePlaceholderInvalid"] = "playbook-context-source-placeholder-invalid";
|
|
631
|
+
/**
|
|
632
|
+
* FAIL — a composite's `method.choreography.admits[]` entry names no authored playbook folder.
|
|
633
|
+
*
|
|
634
|
+
* Rule 30 (2026-09-09). Rule 13 has refused a `method.skillRefs` entry naming no authored skill
|
|
635
|
+
* since the catalog existed; `admits` is the same shape one field over and had no rule at all, so a
|
|
636
|
+
* composite could name a child that does not exist and nothing said so until it ran — and then only
|
|
637
|
+
* by omission. `runPlaybookChoreography` FILTERS an unresolvable ref out of the eligible set, so
|
|
638
|
+
* the lane simply does less than it declares, silently, on every iteration.
|
|
639
|
+
*
|
|
640
|
+
* The runtime consequence of a dangling child is already contained: the write-scope resolver treats
|
|
641
|
+
* an unresolvable child as UNKNOWN and fails closed rather than as the empty set, so nothing is
|
|
642
|
+
* granted a scope it should not have. Containment is not the same as detection, though — a
|
|
643
|
+
* fail-closed runtime says the composite is safe, never that it is complete — and the authoring-time
|
|
644
|
+
* answer belongs here, where the author is still present.
|
|
645
|
+
*
|
|
646
|
+
* FAIL rather than WARN, matching rule 13 and for the same reason: nothing is left to decide. A ref
|
|
647
|
+
* naming no folder is not a judgement call about the catalog's shape (which is what put rule 23 in
|
|
648
|
+
* the softer channel), it is a typo or a deletion that nobody swept, and the fix is mechanical.
|
|
649
|
+
*/
|
|
650
|
+
FrameworkKnowledgeAuditRule["PlaybookChoreographyAdmitsUnknownPlaybook"] = "playbook-choreography-admits-unknown-playbook";
|
|
612
651
|
})(FrameworkKnowledgeAuditRule || (FrameworkKnowledgeAuditRule = {}));
|
|
613
652
|
/**
|
|
614
653
|
* Static parser + auditor for the framework-knowledge authoring surface.
|
|
@@ -701,6 +740,10 @@ export class FrameworkKnowledgeAuditService {
|
|
|
701
740
|
playbooks,
|
|
702
741
|
findings,
|
|
703
742
|
});
|
|
743
|
+
FrameworkKnowledgeAuditService.checkRule30PlaybookChoreographyAdmitsUnknownPlaybook({
|
|
744
|
+
playbooks,
|
|
745
|
+
findings,
|
|
746
|
+
});
|
|
704
747
|
// Rule 14 — playbook `{{REFERENCE:<id>}}` coverage — has no dedicated
|
|
705
748
|
// check method: `collectReferencePlaceholders` above feeds playbook
|
|
706
749
|
// method bodies into Rules 1/2, so a bad id FAILs at PR time instead of
|
|
@@ -736,6 +779,7 @@ export class FrameworkKnowledgeAuditService {
|
|
|
736
779
|
skillCount: skills.length,
|
|
737
780
|
referenceFileCount: Array.from(referenceFilesBySkill.values()).reduce((sum, list) => sum + list.length, 0),
|
|
738
781
|
playbookCount: playbooks.length,
|
|
782
|
+
choreographyChildRefCount: playbooks.reduce((total, playbook) => total + FrameworkKnowledgeAuditService.readPlaybookChoreographyAdmits(playbook).length, 0),
|
|
739
783
|
},
|
|
740
784
|
};
|
|
741
785
|
}
|
|
@@ -2188,6 +2232,52 @@ export class FrameworkKnowledgeAuditService {
|
|
|
2188
2232
|
}
|
|
2189
2233
|
}
|
|
2190
2234
|
}
|
|
2235
|
+
/**
|
|
2236
|
+
* Rule 30 — every `method.choreography.admits[]` entry must name a discovered playbook folder.
|
|
2237
|
+
*
|
|
2238
|
+
* The population is the CATALOG itself, which is the one thing separating this from rule 13: a
|
|
2239
|
+
* composite's children are playbooks, so the set it is checked against is the same set being
|
|
2240
|
+
* iterated. That makes the empty-catalog guard load-bearing rather than defensive — a reader that
|
|
2241
|
+
* parsed no playbook refs would report every child of every composite as dangling, which reads as a
|
|
2242
|
+
* broken catalog instead of a broken reader.
|
|
2243
|
+
*/
|
|
2244
|
+
static checkRule30PlaybookChoreographyAdmitsUnknownPlaybook(params) {
|
|
2245
|
+
const declaredRefs = new Set();
|
|
2246
|
+
for (const playbook of params.playbooks) {
|
|
2247
|
+
const ref = playbook.json?.ref;
|
|
2248
|
+
if (typeof ref === 'string' && ref.length > 0)
|
|
2249
|
+
declaredRefs.add(ref);
|
|
2250
|
+
// The folder name IS the loader address (rule 17 keeps the two equal), so it is admitted as an
|
|
2251
|
+
// identity too. Without it, a playbook whose structured source failed to parse would take every
|
|
2252
|
+
// composite that admits it down with it — one unreadable file reported as N dangling children.
|
|
2253
|
+
declaredRefs.add(playbook.playbookRef);
|
|
2254
|
+
}
|
|
2255
|
+
if (declaredRefs.size === 0)
|
|
2256
|
+
return;
|
|
2257
|
+
for (const playbook of params.playbooks) {
|
|
2258
|
+
for (const childRef of FrameworkKnowledgeAuditService.readPlaybookChoreographyAdmits(playbook)) {
|
|
2259
|
+
if (declaredRefs.has(childRef))
|
|
2260
|
+
continue;
|
|
2261
|
+
params.findings.push({
|
|
2262
|
+
rule: FrameworkKnowledgeAuditRule.PlaybookChoreographyAdmitsUnknownPlaybook,
|
|
2263
|
+
severity: FrameworkKnowledgeAuditSeverity.Fail,
|
|
2264
|
+
message: `Composite playbook "${playbook.playbookRef}" admits child "${childRef}" in method.choreography.admits, but no matching playbook folder exists under src/playbooks/. `
|
|
2265
|
+
+ 'The choreography loop filters an unresolvable child out of the eligible set, so the lane would run silently short of what it declares. '
|
|
2266
|
+
+ 'Either author the playbook, or remove the ref.',
|
|
2267
|
+
location: playbook.structuredSourceFilePath,
|
|
2268
|
+
});
|
|
2269
|
+
}
|
|
2270
|
+
}
|
|
2271
|
+
}
|
|
2272
|
+
static readPlaybookChoreographyAdmits(playbook) {
|
|
2273
|
+
const method = (playbook.json?.method ?? {});
|
|
2274
|
+
const choreography = method.choreography;
|
|
2275
|
+
const admits = choreography?.admits;
|
|
2276
|
+
if (!Array.isArray(admits)) {
|
|
2277
|
+
return [];
|
|
2278
|
+
}
|
|
2279
|
+
return admits.filter((entry) => typeof entry === 'string');
|
|
2280
|
+
}
|
|
2191
2281
|
static readPlaybookSkillRefs(playbook) {
|
|
2192
2282
|
const method = (playbook.json?.method ?? {});
|
|
2193
2283
|
const skillRefs = method.skillRefs;
|