@mark1russell7/conventions 0.41.9 → 0.41.10
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/README.md +11 -0
- package/build/cli.js +1 -1
- package/build/index.d.ts +37 -1
- package/build/index.d.ts.map +1 -1
- package/build/index.js +2 -2
- package/build/{run-ByfXAlgu.js → run-CXVFwcgX.js} +157 -20
- package/build/run-CXVFwcgX.js.map +1 -0
- package/package.json +1 -1
- package/build/run-ByfXAlgu.js.map +0 -1
package/README.md
CHANGED
|
@@ -240,6 +240,17 @@ conventions map --overlay homes.json --markdown # with more homes from a JSON
|
|
|
240
240
|
|
|
241
241
|
Each home can give `signatures`: the names of functions that only the home has, as regular expressions of a whole name. The rule `home-package` breaks on a new function with such a name in another repository. Its message says if the home already exports the name. The index of the exports is `src/home-exports.ts`. The script `scripts/homes/exports.ts` of the template writes it from the latest version of each home on npm.
|
|
242
242
|
|
|
243
|
+
A home can give `pending`: the names of its packages that are not on npm yet. The table marks such a package "(not on npm)". A planned home has no packages, so its `pending` names are its planned packages.
|
|
244
|
+
|
|
245
|
+
The function `npmDrift(homes, facts)` compares the map with the answers of npm. It finds these differences:
|
|
246
|
+
|
|
247
|
+
- A package of a published home that is not on npm.
|
|
248
|
+
- A pending name that is on npm.
|
|
249
|
+
- A package of an unpublished home that is on npm.
|
|
250
|
+
- A name that npm did not answer.
|
|
251
|
+
|
|
252
|
+
A planned home with no pending name is a no read. In the template repository, `node scripts/homes/npm-drift.ts --check` asks npm for each name of the map and exits 1 on a difference. A workflow runs it each week, on each change of the map and on each pull request.
|
|
253
|
+
|
|
243
254
|
An overlay file has the shape `{ "homes": [...] }`. A home of the overlay takes the place of the home with the same area. The private repositories use an overlay, because the public map names only public packages.
|
|
244
255
|
|
|
245
256
|
## Add a rule
|
package/build/cli.js
CHANGED
package/build/index.d.ts
CHANGED
|
@@ -273,6 +273,12 @@ interface Home {
|
|
|
273
273
|
* The rule home-package does not break in them. Remove an entry when the move ends.
|
|
274
274
|
*/
|
|
275
275
|
readonly alsoIn?: readonly string[];
|
|
276
|
+
/**
|
|
277
|
+
* The package names of the home that are not on npm yet. A name of a published or unpublished home is also in
|
|
278
|
+
* `packages`. A planned home has no packages, so its names here are the planned names. The function `npmDrift` reads
|
|
279
|
+
* each name of the map on npm.
|
|
280
|
+
*/
|
|
281
|
+
readonly pending?: readonly string[];
|
|
276
282
|
/** The state of the home. */
|
|
277
283
|
readonly state: HomeState;
|
|
278
284
|
/** More words that find the area in a search. */
|
|
@@ -296,6 +302,36 @@ export declare function readOverlay(file: string): readonly Home[];
|
|
|
296
302
|
export declare function mergeHomes(base: readonly Home[], extra: readonly Home[]): readonly Home[];
|
|
297
303
|
/** This function gives the homes that match each word of `query`, best match first. */
|
|
298
304
|
export declare function findHomes(query: string, homes?: readonly Home[]): readonly Home[];
|
|
305
|
+
/** What npm says of one package name: on npm or not, or no read, with the error of the read. */
|
|
306
|
+
type NpmPresence = {
|
|
307
|
+
readonly onNpm: boolean;
|
|
308
|
+
} | {
|
|
309
|
+
readonly error: string;
|
|
310
|
+
};
|
|
311
|
+
/**
|
|
312
|
+
* The kind of a difference between the map and npm:
|
|
313
|
+
* - `missing`: a package of a published home is not on npm, and the home does not name it in `pending`.
|
|
314
|
+
* - `stale-pending`: a name in `pending` is on npm. Remove it from `pending`. When it is the last planned name of a
|
|
315
|
+
* planned home, the home is published: move the names to `packages`.
|
|
316
|
+
* - `stale-state`: a package of an unpublished home is on npm. The state of the home is published.
|
|
317
|
+
* - `no-read`: npm gave no answer for a name. A no read is not a pass.
|
|
318
|
+
* - `unnamed`: a planned home names no planned package, so nothing can be read for it.
|
|
319
|
+
*/
|
|
320
|
+
type NpmDriftKind = "missing" | "stale-pending" | "stale-state" | "no-read" | "unnamed";
|
|
321
|
+
/** One difference between the map and npm. `name` is the package, absent for the kind `unnamed`. */
|
|
322
|
+
interface NpmDrift {
|
|
323
|
+
readonly area: string;
|
|
324
|
+
readonly kind: NpmDriftKind;
|
|
325
|
+
readonly name?: string;
|
|
326
|
+
readonly text: string;
|
|
327
|
+
}
|
|
328
|
+
/** This function gives each package name of the homes that npm must answer for: the packages and the pending names. */
|
|
329
|
+
export declare function npmNames(homes?: readonly Home[]): readonly string[];
|
|
330
|
+
/**
|
|
331
|
+
* This function compares the map with the answers of npm (`facts`, by package name). A name with no answer is a no read.
|
|
332
|
+
* It gives each difference, in the order of the homes. An empty list means that each name of the map agrees with npm.
|
|
333
|
+
*/
|
|
334
|
+
export declare function npmDrift(homes: readonly Home[], facts: ReadonlyMap<string, NpmPresence>): readonly NpmDrift[];
|
|
299
335
|
/** This function writes the map as a Markdown table, with the rule first. */
|
|
300
336
|
export declare function mapMarkdown(homes?: readonly Home[]): string;
|
|
301
337
|
/** This function writes the homes as plain text for a terminal. */
|
|
@@ -863,5 +899,5 @@ export declare function npmUrl(name: string, version: string): string;
|
|
|
863
899
|
* link to npm. The Releases page of `site-pages` reads each list item as a change.
|
|
864
900
|
*/
|
|
865
901
|
export declare function releaseNotes(name: string, version: string, changelog: string | undefined): string;
|
|
866
|
-
export { type AllowedHit, type AuditSource, type Break, type CheckOptions, type CheckResult, type CliIo, type ConventionsConfig, type Edit, type FixResult, type Home, type HomeAnswer, type HomeFetch, type HomeState, type HookOptions, type LinePlace, type Manifest, type Minor, type NameHit, type NameRule, type OptionSpec, type OptionValue, type Options, type PackageInfo, type PagesCall, type PathFilter, type PrePushOptions, type PrivateNameList, type PrivatePattern, type PrivateSources, type RegistryAnswer, type RegistryLookup, type Rule, type RuleConfig, type RuleContext, type RuleOutcome, type RuleResult, type SecurityCaller, type TextBreakOptions, type Workflow, type WorkflowInput, type WorkflowJob, type WorkflowStep, type YamlFault, globFolders, globToRegExp, packageFolders, workspaceGlobs };
|
|
902
|
+
export { type AllowedHit, type AuditSource, type Break, type CheckOptions, type CheckResult, type CliIo, type ConventionsConfig, type Edit, type FixResult, type Home, type HomeAnswer, type HomeFetch, type HomeState, type HookOptions, type LinePlace, type Manifest, type Minor, type NameHit, type NameRule, type NpmDrift, type NpmDriftKind, type NpmPresence, type OptionSpec, type OptionValue, type Options, type PackageInfo, type PagesCall, type PathFilter, type PrePushOptions, type PrivateNameList, type PrivatePattern, type PrivateSources, type RegistryAnswer, type RegistryLookup, type Rule, type RuleConfig, type RuleContext, type RuleOutcome, type RuleResult, type SecurityCaller, type TextBreakOptions, type Workflow, type WorkflowInput, type WorkflowJob, type WorkflowStep, type YamlFault, globFolders, globToRegExp, packageFolders, workspaceGlobs };
|
|
867
903
|
//# sourceMappingURL=index.d.ts.map
|
package/build/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/rule.ts","../src/config.ts","../src/rules/cue-preset.ts","../src/rules/gate-after-cancel.ts","../src/rules/gate-trigger.ts","../src/rules/security-one-job.ts","../src/rules/setup-cue.ts","../src/rules/shared-ci.ts","../src/rules/service-run-main.ts","../src/map.ts","../src/rules/home-package.ts","../src/rules/license-file.ts","../src/rules/coverage-provider.ts","../src/rules/main-check.ts","../src/rules/no-build-output.ts","../src/private-names.ts","../src/rules/no-local-paths.ts","../src/rules/pack-no-buildinfo.ts","../src/rules/exports-require.ts","../src/rules/api-report-script.ts","../src/rules/pages-after-release.ts","../src/rules/pages-site.ts","../src/rules/pinned-git-deps.ts","../src/rules/pipe-fails.ts","../src/rules/push-main-only.ts","../src/rules/unreleased-change.ts","../src/rules/published-minor.ts","../src/rules/release-files.ts","../src/rules/required-scripts.ts","../src/rules/roadmap-parses.ts","../src/rules/runner-budget.ts","../src/rules/shared-docs.ts","../src/rules/source-main.ts","../src/rules/tests-required.ts","../src/rules/tsconfig-test.ts","../src/rules/typed-files.ts","../src/rules/typed-scripts.ts","../src/rules/trust-policy.ts","../src/rules/version-title.ts","../src/rules/workflow-parses.ts","../src/rules/workspace-protocol.ts","../src/rules/index.ts","../src/run.ts","../src/pre-push.ts","../src/home-exports.ts","../src/workflow.ts","../src/release-text.ts"],"mappings":";;;;;;;;;;;;;;;;UASiB;WACN;WACA;WACA;;;UAIM;;WAEN;;WAEA;WACA;;WAEA;;WAEA,iBAAiB;;;;;;UAOX;;WAEN;;WAEA;;WAEA;;;wBAIK,YAAY,cAAc,cAAc;;KAQ5C;;KAGA,UAAU,SAAS,eAAe;;UAG7B;WACN;WACA,SAAS;WACT;;;KAIC,WAAW,SAAS;;UAGf;;WAEN;;WAEA;;WAEA;;WAEA;WACA,UAAU;;;UAIJ;;WAEN;;WAEA,aAAa;;WAEb,mBAAmB;;WAEnB,KAAK,SAAS;;WAEd;;EAET;;EAEA,IAAI;;;KAIM,uBAAuB;WAAqB;;;qBAG3C;;UAGI;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA,kBAAkB;;WAElB,SAAS,SAAS,eAAe;;;;;WAKjC;;;;;;;WAOA;EACT,MAAM,SAAS,aAAa,SAAS,UAAU;;;qBAIpC;;wBAGG,aAAa,UAAU,UAAU;;wBAOjC,OAAO,cAAc,gBAAgB;;wBAOrC,QAAQ,cAAc,eAAe;;qBAMxC,WAAY,gBAAgB;;qBAG5B,YAAa;;wBAGV,WAAW,cAAc;;;;;;wBASzB,WAAW;;wBA2BX,UAAU;;wBAUV,OAAO,cAAc;;qBAOxB,UAAW,aAAa;;;;;wBAMrB,aAAa,SAAS,KAAK,oDAAoD;;UCpN9E;;WAEN;;WAEA;;;;;WAKA;;WAEA;;WAEA,SAAS;;;UAIH;;WAEN;;WAEA,OAAO,SAAS,eAAe;;;wBAW1B,eAAe,MAAM,OAAO;;;;;;;wBAU5B,YAAY,gBAAgB,gBAAgB,SAAS;;qBCxCxD;qBA4FA,WAAW;qBC5CX,iBAAiB;;UCzCb;WACN;WACA;WACA;;;wBAIK,cAAc,eAAe;;qBAoBhC;;wBAyBG,YAAY;;;;;;;wBAkBZ,YAAY,cAAc,cAAc;EAAoC;;EAAmB;;qBAwIlG,aAAa;;qBClNb;;qBAGA;;qBAGA;;UAQI;WACN;WACA;;;wBAkBK,gBAAgB,eAAe;;;;;;wBA8B/B,WAAW,cAAc;EAA0C;;EAAmB;;qBA4DzF,gBAAgB;qBChGhB,UAAU;;qBC5BV;;qBAaA;;qBAGA;;wBASG,cAAc,cAAc;qBAI/B,UAAU;;qBC9BV;;;;;;wBAgCG,SAAS;qBAmBZ,gBAAgB;;KC3DjB;;UAGK;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;;;;WAKA;;WAEA,OAAO;;WAEP;;;;;;WAMA;;WAEA;;;qBAIE;;qBAIA,gBAAgB;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/rule.ts","../src/config.ts","../src/rules/cue-preset.ts","../src/rules/gate-after-cancel.ts","../src/rules/gate-trigger.ts","../src/rules/security-one-job.ts","../src/rules/setup-cue.ts","../src/rules/shared-ci.ts","../src/rules/service-run-main.ts","../src/map.ts","../src/rules/home-package.ts","../src/rules/license-file.ts","../src/rules/coverage-provider.ts","../src/rules/main-check.ts","../src/rules/no-build-output.ts","../src/private-names.ts","../src/rules/no-local-paths.ts","../src/rules/pack-no-buildinfo.ts","../src/rules/exports-require.ts","../src/rules/api-report-script.ts","../src/rules/pages-after-release.ts","../src/rules/pages-site.ts","../src/rules/pinned-git-deps.ts","../src/rules/pipe-fails.ts","../src/rules/push-main-only.ts","../src/rules/unreleased-change.ts","../src/rules/published-minor.ts","../src/rules/release-files.ts","../src/rules/required-scripts.ts","../src/rules/roadmap-parses.ts","../src/rules/runner-budget.ts","../src/rules/shared-docs.ts","../src/rules/source-main.ts","../src/rules/tests-required.ts","../src/rules/tsconfig-test.ts","../src/rules/typed-files.ts","../src/rules/typed-scripts.ts","../src/rules/trust-policy.ts","../src/rules/version-title.ts","../src/rules/workflow-parses.ts","../src/rules/workspace-protocol.ts","../src/rules/index.ts","../src/run.ts","../src/pre-push.ts","../src/home-exports.ts","../src/workflow.ts","../src/release-text.ts"],"mappings":"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"}
|
package/build/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as unreleasedChangeRule, $t as MAP_RULE, A as typedFiles, An as
|
|
1
|
+
import { $ as unreleasedChangeRule, $t as MAP_RULE, A as typedFiles, An as gateAfterCancel, At as lineNameHits, B as roadmapParses, Bn as inFolder, Bt as LICENSE_TEXTS, C as versionTitle, Cn as securityOneJob, Ct as privateTextBreaks, D as typedScripts, Dn as gateTrigger, Dt as isAllowedHit, E as trustPolicy, En as convertGate, Et as firstNameMatch, F as HOME_TIMEOUT_MS, Fn as DEPENDENCY_FIELDS, Ft as REAL_COMPARE, G as publishedMinor, Gn as readJsonc, Gt as repositoryIsPublic, H as releaseFiles, Hn as lineOf, Ht as licenseFile, I as blockHash, In as RULE_WARN_DAYS, It as hasImportMetaMain, J as NPM_REGISTRY, Jn as specifiersOf, Jt as messageOf, K as publishedMinorRule, Kn as replaceLine, Kt as declaredName, L as githubFetch, Ln as cleanPath, Lt as mainCheck, M as isSourcePath, Mn as readWorkflow, Mt as parsePrivateNames, N as pathsOf, Nn as STRICT_OPTIONS, Nt as pathNameHit, O as configsOfScript, On as prPathFilters, Ot as isCommonUse, P as sourceMain, Pn as cuePreset, Pt as noBuildOutput, Q as unreleasedChange, Qt as HOMES, R as sharedDocsRule, Rn as codePackages, Rt as coverageProvider, S as setVersions, Sn as securityCallers, St as privatePatterns, T as TRAIN_SCOPES, Tn as ACTIONS_COMMIT, Tt as PrivateNameListError, U as lockedVersions, Un as matchesAny, Ut as licenseFileOf, V as requiredScripts, Vn as keyLine, Vt as authorOf, W as minorOf, Wn as parseJsonc, Wt as mitText, X as UNSHIPPED_FILES, Xn as parseConfig, Xt as reposOf, Y as SHIPPED_FIELDS, Yn as defaultOptions, Yt as repoOf, Z as npmLookup, Zt as signaturesOf, _ as workspaceProtocol, _n as sharedCi, _t as PRIVATE_NAMES_FILE_VARIABLE, a as listRules, an as npmNames, at as repositoryOfRemote, b as yamlFaults, bn as SECURITY_SCAN_INPUTS, bt as noLocalPaths, c as runCli, cn as SERVICE_PACKAGE, ct as pushMainOnly, d as HOOK_MARKER, dn as hasTests, dt as pagesSite, en as findHomes, et as pipeFails, f as NO_READ_LINE, fn as tsconfigTest, ft as exportsRequire, g as RULES, gn as callsSharedCi, gt as PRIVATE_NAMES_FILE_CONFIG, h as prePush, hn as SHARED_WORKFLOWS, ht as HOME_PATTERNS, i as formatResult, in as npmDrift, it as pagesAfterRelease, j as testsRequired, jn as readAction, jt as nameMatches, k as scriptsOf, kn as summaryName, kt as lineNameHit, l as runFix, ln as runCalls, lt as PAGES_WORKFLOWS, m as installHook, mn as SHARED_CI, mt as DEFAULT_ALLOWED, n as annotations, nn as mapText, nt as isPinned, o as readConfig, on as readOverlay, ot as runnerBudget, p as PRE_PUSH_HOOK, pn as SHARED_ACTIONS, pt as packNoBuildinfo, q as reachOf, qn as runGit, qt as homePackage, r as createContext, rn as mergeHomes, rt as pinnedGitDeps, s as runChecks, sn as HOME_EXPORTS, st as scheduleMinute, t as USAGE, tn as mapMarkdown, tt as isGitSpecifier, u as summaryMarkdown, un as serviceRunMain, ut as pagesCalls, v as GITHUB_YAML, vn as setupCue, vt as PRIVATE_PATTERNS_VARIABLE, w as IGNORE_AFTER, wn as withOneJob, wt as PRIVATE_NAME_LIST, x as namedVersions, xn as SECURITY_TIMEOUT_MINUTES, xt as privateNamesFile, y as workflowParses, yn as SECURITY_SCAN_COMMIT, yt as invalidPatternBreaks, z as roadmapOfLine, zn as hasFile, zt as apiReportScript } from "./run-CXVFwcgX.js";
|
|
2
2
|
import { i as packageFolders, n as globFolders, r as globToRegExp, s as workspaceGlobs } from "./workspace-Cx7p7bWn.js";
|
|
3
3
|
// src/release-text.ts
|
|
4
4
|
/**
|
|
@@ -65,6 +65,6 @@ function releaseNotes(name, version, changelog) {
|
|
|
65
65
|
if (section.length <= 1e5) return section;
|
|
66
66
|
return `${section.slice(0, MAX_NOTES)}\n\n(The CHANGELOG.md of \`${name}\` has the full text.)`;
|
|
67
67
|
}
|
|
68
|
-
export { ACTIONS_COMMIT, DEFAULT_ALLOWED, DEPENDENCY_FIELDS, GITHUB_YAML, HOMES, HOME_EXPORTS, HOME_PATTERNS, HOME_TIMEOUT_MS, HOOK_MARKER, IGNORE_AFTER, LICENSE_TEXTS, MAP_RULE, MAX_NOTES, NO_READ_LINE, NPM_REGISTRY, PAGES_WORKFLOWS, PRE_PUSH_HOOK, PRIVATE_NAMES_FILE_CONFIG, PRIVATE_NAMES_FILE_VARIABLE, PRIVATE_NAME_LIST, PRIVATE_PATTERNS_VARIABLE, PrivateNameListError, REAL_COMPARE, RULES, RULE_WARN_DAYS, SECURITY_SCAN_COMMIT, SECURITY_SCAN_INPUTS, SECURITY_TIMEOUT_MINUTES, SERVICE_PACKAGE, SHARED_ACTIONS, SHARED_CI, SHARED_WORKFLOWS, SHIPPED_FIELDS, STRICT_OPTIONS, TRAIN_SCOPES, UNSHIPPED_FILES, USAGE, annotations, apiReportScript, authorOf, blockHash, callsSharedCi, changelogSection, cleanPath, codePackages, configsOfScript, convertGate, coverageProvider, createContext, cuePreset, declaredName, defaultOptions, exportsRequire, findHomes, firstNameMatch, formatResult, gateAfterCancel, gateTrigger, githubFetch, globFolders, globToRegExp, hasFile, hasImportMetaMain, hasTests, homePackage, inFolder, installHook, invalidPatternBreaks, isAllowedHit, isCommonUse, isGitSpecifier, isPinned, isSourcePath, keyLine, licenseFile, licenseFileOf, lineNameHit, lineNameHits, lineOf, listRules, lockedVersions, mainCheck, mapMarkdown, mapText, matchesAny, mergeHomes, messageOf, minorOf, mitText, nameMatches, namedVersions, noBuildOutput, noLocalPaths, npmLookup, npmUrl, packNoBuildinfo, packageFolders, pagesAfterRelease, pagesCalls, pagesSite, parseConfig, parseJsonc, parsePrivateNames, pathNameHit, pathsOf, pinnedGitDeps, pipeFails, prPathFilters, prePush, privateNamesFile, privatePatterns, privateTextBreaks, publishedMinor, publishedMinorRule, pushMainOnly, reachOf, readAction, readConfig, readJsonc, readOverlay, readWorkflow, releaseFiles, releaseNotes, replaceLine, repoOf, reposOf, repositoryIsPublic, repositoryOfRemote, requiredScripts, roadmapOfLine, roadmapParses, runCalls, runChecks, runCli, runFix, runGit, runnerBudget, scheduleMinute, scriptsOf, securityCallers, securityOneJob, serviceRunMain, setVersions, setupCue, sharedCi, sharedDocsRule, signaturesOf, sourceMain, specifiersOf, summaryMarkdown, summaryName, tagName, testsRequired, trustPolicy, tsconfigTest, typedFiles, typedScripts, unreleasedChange, unreleasedChangeRule, versionTitle, withOneJob, workflowParses, workspaceGlobs, workspaceProtocol, yamlFaults };
|
|
68
|
+
export { ACTIONS_COMMIT, DEFAULT_ALLOWED, DEPENDENCY_FIELDS, GITHUB_YAML, HOMES, HOME_EXPORTS, HOME_PATTERNS, HOME_TIMEOUT_MS, HOOK_MARKER, IGNORE_AFTER, LICENSE_TEXTS, MAP_RULE, MAX_NOTES, NO_READ_LINE, NPM_REGISTRY, PAGES_WORKFLOWS, PRE_PUSH_HOOK, PRIVATE_NAMES_FILE_CONFIG, PRIVATE_NAMES_FILE_VARIABLE, PRIVATE_NAME_LIST, PRIVATE_PATTERNS_VARIABLE, PrivateNameListError, REAL_COMPARE, RULES, RULE_WARN_DAYS, SECURITY_SCAN_COMMIT, SECURITY_SCAN_INPUTS, SECURITY_TIMEOUT_MINUTES, SERVICE_PACKAGE, SHARED_ACTIONS, SHARED_CI, SHARED_WORKFLOWS, SHIPPED_FIELDS, STRICT_OPTIONS, TRAIN_SCOPES, UNSHIPPED_FILES, USAGE, annotations, apiReportScript, authorOf, blockHash, callsSharedCi, changelogSection, cleanPath, codePackages, configsOfScript, convertGate, coverageProvider, createContext, cuePreset, declaredName, defaultOptions, exportsRequire, findHomes, firstNameMatch, formatResult, gateAfterCancel, gateTrigger, githubFetch, globFolders, globToRegExp, hasFile, hasImportMetaMain, hasTests, homePackage, inFolder, installHook, invalidPatternBreaks, isAllowedHit, isCommonUse, isGitSpecifier, isPinned, isSourcePath, keyLine, licenseFile, licenseFileOf, lineNameHit, lineNameHits, lineOf, listRules, lockedVersions, mainCheck, mapMarkdown, mapText, matchesAny, mergeHomes, messageOf, minorOf, mitText, nameMatches, namedVersions, noBuildOutput, noLocalPaths, npmDrift, npmLookup, npmNames, npmUrl, packNoBuildinfo, packageFolders, pagesAfterRelease, pagesCalls, pagesSite, parseConfig, parseJsonc, parsePrivateNames, pathNameHit, pathsOf, pinnedGitDeps, pipeFails, prPathFilters, prePush, privateNamesFile, privatePatterns, privateTextBreaks, publishedMinor, publishedMinorRule, pushMainOnly, reachOf, readAction, readConfig, readJsonc, readOverlay, readWorkflow, releaseFiles, releaseNotes, replaceLine, repoOf, reposOf, repositoryIsPublic, repositoryOfRemote, requiredScripts, roadmapOfLine, roadmapParses, runCalls, runChecks, runCli, runFix, runGit, runnerBudget, scheduleMinute, scriptsOf, securityCallers, securityOneJob, serviceRunMain, setVersions, setupCue, sharedCi, sharedDocsRule, signaturesOf, sourceMain, specifiersOf, summaryMarkdown, summaryName, tagName, testsRequired, trustPolicy, tsconfigTest, typedFiles, typedScripts, unreleasedChange, unreleasedChangeRule, versionTitle, withOneJob, workflowParses, workspaceGlobs, workspaceProtocol, yamlFaults };
|
|
69
69
|
|
|
70
70
|
//# sourceMappingURL=index.js.map
|
|
@@ -8354,9 +8354,9 @@ const HOMES = [
|
|
|
8354
8354
|
area: "bench",
|
|
8355
8355
|
title: "Benchmarks and speed gates",
|
|
8356
8356
|
covers: "the bench harness: a fresh process per case, the order turned each round, A/A pairs, the CPU model, paired-time records, speed gates, determinism gates",
|
|
8357
|
-
packages: [],
|
|
8357
|
+
packages: ["@mark1russell7/rigor-bench"],
|
|
8358
8358
|
repo: "mark1russell7/rigor",
|
|
8359
|
-
state: "
|
|
8359
|
+
state: "published",
|
|
8360
8360
|
words: [
|
|
8361
8361
|
"benchmark",
|
|
8362
8362
|
"harness",
|
|
@@ -8379,15 +8379,19 @@ const HOMES = [
|
|
|
8379
8379
|
"ratchet",
|
|
8380
8380
|
"threshold"
|
|
8381
8381
|
],
|
|
8382
|
-
note: "Five repositories have their own harness today (vex, packing, highways, layout-stack, typeset). Do not grow a local harness: the shared one replaces them."
|
|
8382
|
+
note: "The entry /fresh runs each arm of each pair in a fresh process, and the entry /supervise stops a case that passes its time budget. Five repositories have their own harness today (vex, packing, highways, layout-stack, typeset). Do not grow a local harness: the shared one replaces them."
|
|
8383
8383
|
},
|
|
8384
8384
|
{
|
|
8385
8385
|
area: "test-generation",
|
|
8386
8386
|
title: "Test helpers and test generation",
|
|
8387
8387
|
covers: "property tests on fast-check, pairwise and covering arrays, metamorphic relations, chaos and load schedules, shared test fixtures, the capture of the OpenTelemetry SDK and the propagation gate for tests",
|
|
8388
|
-
packages: [
|
|
8388
|
+
packages: [
|
|
8389
|
+
"@mark1russell7/rigor-testkit",
|
|
8390
|
+
"@mark1russell7/rigor-chaos",
|
|
8391
|
+
"@mark1russell7/rigor-proxy"
|
|
8392
|
+
],
|
|
8389
8393
|
repo: "mark1russell7/rigor",
|
|
8390
|
-
state: "
|
|
8394
|
+
state: "published",
|
|
8391
8395
|
words: [
|
|
8392
8396
|
"test",
|
|
8393
8397
|
"testing",
|
|
@@ -8413,7 +8417,7 @@ const HOMES = [
|
|
|
8413
8417
|
"exporter",
|
|
8414
8418
|
"testkit"
|
|
8415
8419
|
],
|
|
8416
|
-
note: "
|
|
8420
|
+
note: "rigor-testkit has model-based tests on fast-check, the capture of the OpenTelemetry SDK for tests (captureTelemetry, entry /otel), the propagation gate (entry /propagation) and a scripted HTTP server with a wire record of each reply (entry /http). rigor-chaos has seeded fault plans (delay, cut, reset, split frame, reorder, duplicate, stall) as data, next to its load schedules. rigor-proxy applies a plan to TCP, WebSocket and HTTP streams and records each fault. Pairwise and covering arrays and metamorphic relations are planned in mark1russell7/rigor. @mark1russell7/vex-testkit is only for Vex domains. A fake shell for tests is in @procedures/shell."
|
|
8417
8421
|
},
|
|
8418
8422
|
{
|
|
8419
8423
|
area: "exact-math",
|
|
@@ -8424,6 +8428,7 @@ const HOMES = [
|
|
|
8424
8428
|
"@mark1russell7/rational",
|
|
8425
8429
|
"@mark1russell7/expression"
|
|
8426
8430
|
],
|
|
8431
|
+
pending: ["@mark1russell7/expression"],
|
|
8427
8432
|
repo: "mark1russell7/algebra",
|
|
8428
8433
|
state: "published",
|
|
8429
8434
|
words: [
|
|
@@ -8446,7 +8451,7 @@ const HOMES = [
|
|
|
8446
8451
|
"incircle",
|
|
8447
8452
|
"classifySegments"
|
|
8448
8453
|
],
|
|
8449
|
-
note: "
|
|
8454
|
+
note: "Statistics go to rigor-statistics, and geometry records go to layout-contract. There is no math package."
|
|
8450
8455
|
},
|
|
8451
8456
|
{
|
|
8452
8457
|
area: "units",
|
|
@@ -8466,7 +8471,7 @@ const HOMES = [
|
|
|
8466
8471
|
{
|
|
8467
8472
|
area: "state-machines",
|
|
8468
8473
|
title: "State machines and timers",
|
|
8469
|
-
covers: "state machines as data, closed forms of their timers, clocks (a real clock and a test clock, @mark1russell7/algebra/clock), failure detection, recovery and trace replay",
|
|
8474
|
+
covers: "state machines as data, closed forms of their timers, clocks (a real clock and a test clock, @mark1russell7/algebra/clock), civil time (the local time of an instant in an IANA time zone, daily and weekly windows across midnight, the next boundary of a window), failure detection, recovery and trace replay",
|
|
8470
8475
|
packages: ["@mark1russell7/algebra"],
|
|
8471
8476
|
repo: "mark1russell7/systems",
|
|
8472
8477
|
state: "published",
|
|
@@ -8479,7 +8484,11 @@ const HOMES = [
|
|
|
8479
8484
|
"detection",
|
|
8480
8485
|
"clock",
|
|
8481
8486
|
"test clock",
|
|
8482
|
-
"fake clock"
|
|
8487
|
+
"fake clock",
|
|
8488
|
+
"time zone",
|
|
8489
|
+
"local time",
|
|
8490
|
+
"quiet hours",
|
|
8491
|
+
"daylight saving"
|
|
8483
8492
|
],
|
|
8484
8493
|
note: "The npm name @mark1russell7/algebra is this package of systems, not the algebra repository."
|
|
8485
8494
|
},
|
|
@@ -8651,10 +8660,11 @@ const HOMES = [
|
|
|
8651
8660
|
],
|
|
8652
8661
|
signatures: [
|
|
8653
8662
|
"sendNotification",
|
|
8654
|
-
"
|
|
8655
|
-
"
|
|
8663
|
+
"callPushover",
|
|
8664
|
+
"pushoverSendRequest",
|
|
8665
|
+
"extractPushoverReceipt"
|
|
8656
8666
|
],
|
|
8657
|
-
note: "@procedures/notify is in mark1russell7/client.
|
|
8667
|
+
note: "@procedures/notify is in mark1russell7/client. ntfy and Pushover are on npm (Pushover since 0.56.0, entry /pushover). Twilio is planned. The rules of who gets what and when (rank, route, escalate) go to the area alerts."
|
|
8658
8668
|
},
|
|
8659
8669
|
{
|
|
8660
8670
|
area: "desktop",
|
|
@@ -8698,7 +8708,7 @@ const HOMES = [
|
|
|
8698
8708
|
{
|
|
8699
8709
|
area: "data-structures",
|
|
8700
8710
|
title: "Collections and graphs of dependencies",
|
|
8701
|
-
covers: "lists, deques, maps, trees and heaps; DAGs, cycles, topological order; the typed event emitter that evented collections use. @procedures/collections and @procedures/dag are the same code as procedures: new code goes to @mark1russell7/collections",
|
|
8711
|
+
covers: "lists, deques, maps, trees and heaps; DAGs, cycles, topological order, strongly connected components, the minimum hitting set (the vertex cover of a hypergraph); the typed event emitter that evented collections use. @procedures/collections and @procedures/dag are the same code as procedures: new code goes to @mark1russell7/collections",
|
|
8702
8712
|
packages: [
|
|
8703
8713
|
"@mark1russell7/collections",
|
|
8704
8714
|
"@procedures/collections",
|
|
@@ -8716,6 +8726,10 @@ const HOMES = [
|
|
|
8716
8726
|
"dag",
|
|
8717
8727
|
"topological",
|
|
8718
8728
|
"cycle",
|
|
8729
|
+
"strongly connected",
|
|
8730
|
+
"hitting set",
|
|
8731
|
+
"vertex cover",
|
|
8732
|
+
"hypergraph",
|
|
8719
8733
|
"event emitter",
|
|
8720
8734
|
"emitter",
|
|
8721
8735
|
"listener",
|
|
@@ -8801,6 +8815,7 @@ const HOMES = [
|
|
|
8801
8815
|
title: "Places on the Earth",
|
|
8802
8816
|
covers: "WGS84 points (latitude and longitude), great-circle distance and bearing, the destination from a point, a point in a polygon on the Earth, polygon overlap, buffers, bounding boxes, geohash, GeoJSON: plain functions with no dependencies",
|
|
8803
8817
|
packages: [],
|
|
8818
|
+
pending: ["@mark1russell7/geo"],
|
|
8804
8819
|
repo: "mark1russell7/geo",
|
|
8805
8820
|
alsoIn: ["mark1russell7/client"],
|
|
8806
8821
|
state: "planned",
|
|
@@ -8852,9 +8867,9 @@ const HOMES = [
|
|
|
8852
8867
|
area: "search",
|
|
8853
8868
|
title: "Search and optimization over a space",
|
|
8854
8869
|
covers: "search over a strategy space: sweeps, genetic algorithms, many objectives and Pareto fronts, hard and soft constraints, a seed for each run, a record of each evaluation",
|
|
8855
|
-
packages: [],
|
|
8870
|
+
packages: ["@mark1russell7/strategy-search"],
|
|
8856
8871
|
repo: "mark1russell7/strategy-space",
|
|
8857
|
-
state: "
|
|
8872
|
+
state: "published",
|
|
8858
8873
|
words: [
|
|
8859
8874
|
"optimizer",
|
|
8860
8875
|
"optimize",
|
|
@@ -8870,13 +8885,14 @@ const HOMES = [
|
|
|
8870
8885
|
"constraint solver",
|
|
8871
8886
|
"tuning"
|
|
8872
8887
|
],
|
|
8873
|
-
note: "
|
|
8888
|
+
note: "It knows no domain. The local sweeps of the layout projects move to it."
|
|
8874
8889
|
},
|
|
8875
8890
|
{
|
|
8876
8891
|
area: "market",
|
|
8877
8892
|
title: "Products, offers and price history",
|
|
8878
8893
|
covers: "a live catalog of products with the offers of many sellers, the price of each offer over time, trends, one adapter for each seller (the official API first)",
|
|
8879
8894
|
packages: [],
|
|
8895
|
+
pending: ["@mark1russell7/market", "@mark1russell7/market-sources"],
|
|
8880
8896
|
repo: "mark1russell7/market",
|
|
8881
8897
|
state: "planned",
|
|
8882
8898
|
words: [
|
|
@@ -9315,6 +9331,7 @@ const HOMES = [
|
|
|
9315
9331
|
title: "Alerts from many sources",
|
|
9316
9332
|
covers: "one event format based on CAP (the Common Alerting Protocol), a source adapter for each feed (describe, fetch, map, check), the merge of duplicate reports into one incident (idempotent and order-free), priority as a calculation, routes over channels with acknowledgement and escalation, the health and coverage of each source, the fault suite of the pipeline",
|
|
9317
9333
|
packages: [],
|
|
9334
|
+
pending: ["@mark1russell7/alerts"],
|
|
9318
9335
|
repo: "mark1russell7/alerts",
|
|
9319
9336
|
state: "planned",
|
|
9320
9337
|
words: [
|
|
@@ -9335,6 +9352,72 @@ const HOMES = [
|
|
|
9335
9352
|
"heartbeat"
|
|
9336
9353
|
],
|
|
9337
9354
|
note: "The planned packages are @mark1russell7/alerts (the core) and one package for each source and each channel. It knows no person and no place: the places and keys of a user are input data. Sending goes through @procedures/notify, fetches through polite-crawler, geography through @mark1russell7/geo, the service loop through @mark1russell7/service, fault tests through rigor-chaos and rigor-proxy."
|
|
9355
|
+
},
|
|
9356
|
+
{
|
|
9357
|
+
area: "network-labs",
|
|
9358
|
+
title: "Network labs and fault injection",
|
|
9359
|
+
covers: "labs of real software on false networks: Docker topologies of clients, routers and proxies as data, faults at layers 3 and 4 in the network namespace of a container (iptables rules and tc netem from a sidecar with NET_ADMIN, the toxics of Toxiproxy), replicated groups, kind clusters with faults in the namespaces of pods, observations on one monotonic clock; planned tiers: routed fabrics in containerlab, VMs with a kernel for each node, k3s",
|
|
9360
|
+
packages: ["@mark1russell7/harness", "@mark1russell7/kind"],
|
|
9361
|
+
repo: "mark1russell7/systems",
|
|
9362
|
+
state: "published",
|
|
9363
|
+
words: [
|
|
9364
|
+
"network lab",
|
|
9365
|
+
"toxiproxy",
|
|
9366
|
+
"toxic",
|
|
9367
|
+
"netem",
|
|
9368
|
+
"tc qdisc",
|
|
9369
|
+
"iptables",
|
|
9370
|
+
"net_admin",
|
|
9371
|
+
"sidecar",
|
|
9372
|
+
"dead peer",
|
|
9373
|
+
"black hole",
|
|
9374
|
+
"latency injection",
|
|
9375
|
+
"docker compose",
|
|
9376
|
+
"testcontainers",
|
|
9377
|
+
"kind cluster",
|
|
9378
|
+
"k3s",
|
|
9379
|
+
"k3d",
|
|
9380
|
+
"containerlab",
|
|
9381
|
+
"vrnetlab",
|
|
9382
|
+
"frr",
|
|
9383
|
+
"bgp",
|
|
9384
|
+
"bfd",
|
|
9385
|
+
"qemu"
|
|
9386
|
+
],
|
|
9387
|
+
note: "The labs need Docker, so they run in CI. Fault plans are data in rigor-chaos: the harness applies them at layers 3 and 4, and rigor-proxy applies them to TCP, WebSocket and HTTP streams. A repository that tests a client against a faulty network uses these labs: do not grow a local compose file with a Toxiproxy or an iptables sidecar. The containerlab, VM and k3s tiers, and with them a simulated homelab, are planned in the program S7 of mark1russell7/systems."
|
|
9388
|
+
},
|
|
9389
|
+
{
|
|
9390
|
+
area: "network-diagnosis",
|
|
9391
|
+
title: "Network diagnosis",
|
|
9392
|
+
covers: "the cause of a network fault at each layer (link, Wi-Fi, IP and routes, DNS, TCP, TLS, HTTP, the path through providers) and the next step: probes as adapters that give typed facts, a catalog of faults as data, the probability of each cause from the facts, the next probe by its expected information gain, the estimators of jitter, loss, delay variation, retransmission time-out and bandwidth",
|
|
9393
|
+
packages: [],
|
|
9394
|
+
pending: ["@mark1russell7/netdiag"],
|
|
9395
|
+
repo: "mark1russell7/netdiag",
|
|
9396
|
+
state: "planned",
|
|
9397
|
+
words: [
|
|
9398
|
+
"network diagnosis",
|
|
9399
|
+
"diagnose",
|
|
9400
|
+
"troubleshoot",
|
|
9401
|
+
"connectivity",
|
|
9402
|
+
"reachability",
|
|
9403
|
+
"unreachable",
|
|
9404
|
+
"ping",
|
|
9405
|
+
"traceroute",
|
|
9406
|
+
"mtr",
|
|
9407
|
+
"dns lookup",
|
|
9408
|
+
"nslookup",
|
|
9409
|
+
"dig",
|
|
9410
|
+
"jitter",
|
|
9411
|
+
"packet loss",
|
|
9412
|
+
"rtt",
|
|
9413
|
+
"mtu",
|
|
9414
|
+
"tls handshake",
|
|
9415
|
+
"wifi",
|
|
9416
|
+
"wi-fi",
|
|
9417
|
+
"iperf",
|
|
9418
|
+
"netdiag"
|
|
9419
|
+
],
|
|
9420
|
+
note: "The planned package is @mark1russell7/netdiag. Commands go through @procedures/shell, statistics through rigor-statistics, timers and backoff through @mark1russell7/algebra, scheduled checks through @mark1russell7/service. Its ground truth comes from the network labs: a lab injects each fault class, and a gate holds the hit rate of each class. It checks only the networks that its user owns or names."
|
|
9338
9421
|
}
|
|
9339
9422
|
];
|
|
9340
9423
|
/** A file of more homes, for example the private repositories, in the shape `{ "homes": Home[] }`. */
|
|
@@ -9344,6 +9427,7 @@ function readOverlay(file) {
|
|
|
9344
9427
|
for (const home of data.homes) {
|
|
9345
9428
|
if (typeof home.area !== "string" || typeof home.title !== "string" || typeof home.repo !== "string") throw new Error(`${file}: each home needs area, title and repo`);
|
|
9346
9429
|
if (home.alsoIn !== void 0 && !(Array.isArray(home.alsoIn) && home.alsoIn.every((repo) => typeof repo === "string"))) throw new Error(`${file}: alsoIn of ${home.area} must be an array of owner/name strings`);
|
|
9430
|
+
if (home.pending !== void 0 && !(Array.isArray(home.pending) && home.pending.every((name) => typeof name === "string"))) throw new Error(`${file}: pending of ${home.area} must be an array of package names`);
|
|
9347
9431
|
}
|
|
9348
9432
|
return data.homes;
|
|
9349
9433
|
}
|
|
@@ -9372,17 +9456,70 @@ function findHomes(query, homes = HOMES) {
|
|
|
9372
9456
|
score: score(home)
|
|
9373
9457
|
})).filter((row) => row.score > 0).sort((a, b) => b.score - a.score || a.index - b.index).map((row) => row.home);
|
|
9374
9458
|
}
|
|
9459
|
+
/** This function gives each package name of the homes that npm must answer for: the packages and the pending names. */
|
|
9460
|
+
function npmNames(homes = HOMES) {
|
|
9461
|
+
return [...new Set(homes.flatMap((home) => [...home.packages, ...home.pending ?? []]))];
|
|
9462
|
+
}
|
|
9463
|
+
/**
|
|
9464
|
+
* This function compares the map with the answers of npm (`facts`, by package name). A name with no answer is a no read.
|
|
9465
|
+
* It gives each difference, in the order of the homes. An empty list means that each name of the map agrees with npm.
|
|
9466
|
+
*/
|
|
9467
|
+
function npmDrift(homes, facts) {
|
|
9468
|
+
const found = [];
|
|
9469
|
+
for (const home of homes) {
|
|
9470
|
+
const pending = new Set(home.pending ?? []);
|
|
9471
|
+
if (home.state === "planned" && pending.size === 0) found.push({
|
|
9472
|
+
area: home.area,
|
|
9473
|
+
kind: "unnamed",
|
|
9474
|
+
text: `${home.area}: the planned home names no package in pending, so npm cannot be read for it`
|
|
9475
|
+
});
|
|
9476
|
+
for (const name of [...home.packages, ...[...pending].filter((name) => !home.packages.includes(name))]) {
|
|
9477
|
+
const fact = facts.get(name);
|
|
9478
|
+
if (fact === void 0 || "error" in fact) found.push({
|
|
9479
|
+
area: home.area,
|
|
9480
|
+
kind: "no-read",
|
|
9481
|
+
name,
|
|
9482
|
+
text: `${home.area}: no read of ${name} on npm (${fact === void 0 ? "no answer" : fact.error})`
|
|
9483
|
+
});
|
|
9484
|
+
else if (pending.has(name)) {
|
|
9485
|
+
if (fact.onNpm) found.push({
|
|
9486
|
+
area: home.area,
|
|
9487
|
+
kind: "stale-pending",
|
|
9488
|
+
name,
|
|
9489
|
+
text: `${home.area}: ${name} is on npm, so it leaves pending${home.state === "planned" ? " and the home moves toward published" : ""}`
|
|
9490
|
+
});
|
|
9491
|
+
} else if (home.state === "published" && !fact.onNpm) found.push({
|
|
9492
|
+
area: home.area,
|
|
9493
|
+
kind: "missing",
|
|
9494
|
+
name,
|
|
9495
|
+
text: `${home.area}: ${name} is not on npm, and pending does not name it`
|
|
9496
|
+
});
|
|
9497
|
+
else if (home.state === "unpublished" && fact.onNpm) found.push({
|
|
9498
|
+
area: home.area,
|
|
9499
|
+
kind: "stale-state",
|
|
9500
|
+
name,
|
|
9501
|
+
text: `${home.area}: ${name} is on npm, so the state of the home is published`
|
|
9502
|
+
});
|
|
9503
|
+
}
|
|
9504
|
+
}
|
|
9505
|
+
return found;
|
|
9506
|
+
}
|
|
9375
9507
|
const STATE_TEXT = {
|
|
9376
9508
|
published: "",
|
|
9377
9509
|
unpublished: " (not on npm)",
|
|
9378
9510
|
planned: " (planned)",
|
|
9379
9511
|
none: " (no home)"
|
|
9380
9512
|
};
|
|
9513
|
+
/** This function gives the packages of a home, each with " (not on npm)" when the home names it in `pending`. */
|
|
9514
|
+
function packageList(home, quote) {
|
|
9515
|
+
const pending = new Set(home.state === "published" ? home.pending ?? [] : []);
|
|
9516
|
+
return home.packages.map((name) => `${quote(name)}${pending.has(name) ? " (not on npm)" : ""}`).join(", ");
|
|
9517
|
+
}
|
|
9381
9518
|
/** This function writes the map as a Markdown table, with the rule first. */
|
|
9382
9519
|
function mapMarkdown(homes = HOMES) {
|
|
9383
9520
|
const cell = (text) => text.replaceAll("|", "\\|");
|
|
9384
9521
|
const rows = homes.map((home) => {
|
|
9385
|
-
const where = home.packages.length > 0 ? home
|
|
9522
|
+
const where = home.packages.length > 0 ? packageList(home, (name) => `\`${name}\``) : `\`${home.repo}\``;
|
|
9386
9523
|
const covers = home.note === void 0 ? home.covers : `${home.covers}. ${home.note}`;
|
|
9387
9524
|
return `| ${cell(home.title)} | ${where}${STATE_TEXT[home.state]} | ${cell(covers)} |`;
|
|
9388
9525
|
});
|
|
@@ -9399,7 +9536,7 @@ function mapMarkdown(homes = HOMES) {
|
|
|
9399
9536
|
function mapText(homes) {
|
|
9400
9537
|
if (homes.length === 0) return "No area matches. Ask the maintainer for a home before you write the code.\n";
|
|
9401
9538
|
return homes.map((home) => {
|
|
9402
|
-
const where = home.packages.length > 0 ? home
|
|
9539
|
+
const where = home.packages.length > 0 ? packageList(home, (name) => name) : home.repo;
|
|
9403
9540
|
const lines = [
|
|
9404
9541
|
`${home.title} (${home.area}): ${where}${STATE_TEXT[home.state]}`,
|
|
9405
9542
|
` covers: ${home.covers}`,
|
|
@@ -15468,6 +15605,6 @@ function runHook(args, io) {
|
|
|
15468
15605
|
git: (gitArgs) => runGit(io.cwd, gitArgs)
|
|
15469
15606
|
}, io);
|
|
15470
15607
|
}
|
|
15471
|
-
export { unreleasedChangeRule as $, MAP_RULE as $t, typedFiles as A,
|
|
15608
|
+
export { unreleasedChangeRule as $, MAP_RULE as $t, typedFiles as A, gateAfterCancel as An, lineNameHits as At, roadmapParses as B, inFolder as Bn, LICENSE_TEXTS as Bt, versionTitle as C, securityOneJob as Cn, privateTextBreaks as Ct, typedScripts as D, gateTrigger as Dn, isAllowedHit as Dt, trustPolicy as E, convertGate as En, firstNameMatch as Et, HOME_TIMEOUT_MS as F, DEPENDENCY_FIELDS as Fn, REAL_COMPARE as Ft, publishedMinor as G, readJsonc as Gn, repositoryIsPublic as Gt, releaseFiles as H, lineOf as Hn, licenseFile as Ht, blockHash as I, RULE_WARN_DAYS as In, hasImportMetaMain as It, NPM_REGISTRY as J, specifiersOf as Jn, messageOf as Jt, publishedMinorRule as K, replaceLine as Kn, declaredName as Kt, githubFetch as L, cleanPath as Ln, mainCheck as Lt, isSourcePath as M, readWorkflow as Mn, parsePrivateNames as Mt, pathsOf as N, STRICT_OPTIONS as Nn, pathNameHit as Nt, configsOfScript as O, prPathFilters as On, isCommonUse as Ot, sourceMain as P, cuePreset as Pn, noBuildOutput as Pt, unreleasedChange as Q, HOMES as Qt, sharedDocsRule as R, codePackages as Rn, coverageProvider as Rt, setVersions as S, securityCallers as Sn, privatePatterns as St, TRAIN_SCOPES as T, ACTIONS_COMMIT as Tn, PrivateNameListError as Tt, lockedVersions as U, matchesAny as Un, licenseFileOf as Ut, requiredScripts as V, keyLine as Vn, authorOf as Vt, minorOf as W, parseJsonc as Wn, mitText as Wt, UNSHIPPED_FILES as X, parseConfig as Xn, reposOf as Xt, SHIPPED_FIELDS as Y, defaultOptions as Yn, repoOf as Yt, npmLookup as Z, signaturesOf as Zt, workspaceProtocol as _, sharedCi as _n, PRIVATE_NAMES_FILE_VARIABLE as _t, listRules as a, npmNames as an, repositoryOfRemote as at, yamlFaults as b, SECURITY_SCAN_INPUTS as bn, noLocalPaths as bt, runCli as c, SERVICE_PACKAGE as cn, pushMainOnly as ct, HOOK_MARKER as d, hasTests as dn, pagesSite as dt, findHomes as en, pipeFails as et, NO_READ_LINE as f, tsconfigTest as fn, exportsRequire as ft, RULES as g, callsSharedCi as gn, PRIVATE_NAMES_FILE_CONFIG as gt, prePush as h, SHARED_WORKFLOWS as hn, HOME_PATTERNS as ht, formatResult as i, npmDrift as in, pagesAfterRelease as it, testsRequired as j, readAction as jn, nameMatches as jt, scriptsOf as k, summaryName as kn, lineNameHit as kt, runFix as l, runCalls as ln, PAGES_WORKFLOWS as lt, installHook as m, SHARED_CI as mn, DEFAULT_ALLOWED as mt, annotations as n, mapText as nn, isPinned as nt, readConfig as o, readOverlay as on, runnerBudget as ot, PRE_PUSH_HOOK as p, SHARED_ACTIONS as pn, packNoBuildinfo as pt, reachOf as q, runGit as qn, homePackage as qt, createContext as r, mergeHomes as rn, pinnedGitDeps as rt, runChecks as s, HOME_EXPORTS as sn, scheduleMinute as st, USAGE as t, mapMarkdown as tn, isGitSpecifier as tt, summaryMarkdown as u, serviceRunMain as un, pagesCalls as ut, GITHUB_YAML as v, setupCue as vn, PRIVATE_PATTERNS_VARIABLE as vt, IGNORE_AFTER as w, withOneJob as wn, PRIVATE_NAME_LIST as wt, namedVersions as x, SECURITY_TIMEOUT_MINUTES as xn, privateNamesFile as xt, workflowParses as y, SECURITY_SCAN_COMMIT as yn, invalidPatternBreaks as yt, roadmapOfLine as z, hasFile as zn, apiReportScript as zt };
|
|
15472
15609
|
|
|
15473
|
-
//# sourceMappingURL=run-
|
|
15610
|
+
//# sourceMappingURL=run-CXVFwcgX.js.map
|