@dereekb/util 13.12.3 → 13.12.5

package/eslint/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/eslint",
-  "version": "13.12.3",
+  "version": "13.12.5",
   "peerDependencies": {
-    "@dereekb/util": "13.12.3",
+    "@dereekb/util": "13.12.5",
     "@typescript-eslint/utils": "8.59.3"
   },
   "devDependencies": {

package/fetch/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "13.12.3",
+  "version": "13.12.5",
   "peerDependencies": {
-    "@dereekb/util": "13.12.3",
+    "@dereekb/util": "13.12.5",
     "make-error": "^1.3.6",
     "fast-content-type-parse": "^3.0.0"
   },

package/index.cjs.js

@@ -25209,6 +25209,275 @@ function _ts_generator(thisArg, body) {
     return result;
 }
 
+/**
+ * Spec-file naming conventions for API test files.
+ *
+ * Downstream Firebase Functions API apps keep their tests under
+ * `<apiDir>/src/app/function/<group>/`, with each spec file named so that
+ * "what does this test, and where do I add the next one?" can be answered
+ * from the filename alone. The canonical forms are:
+ *
+ * - `<group>.crud.spec.ts` — non-scenario tests of the CRUD function map for the group.
+ * - `<group>.crud.<sub>[.<sub>...].spec.ts` — CRUD tests focused on a sub-area
+ *   (e.g. `job.crud.requirement.spec.ts`).
+ * - `<group>.scenario.spec.ts` — generic multi-step scenario tests using fixture
+ *   chains.
+ * - `<group>.scenario.<sub>[.<sub>...].spec.ts` — focused scenario sub-bucket
+ *   (e.g. `job.scenario.requirement.worker.state.spec.ts`).
+ *
+ * Drift forms (still parsed, but flagged with a rename suggestion):
+ * - `<group>.<sub>.crud.spec.ts` — `crud` placed after a subgroup.
+ *   Suggestion: `<group>.crud.<sub>.spec.ts`.
+ * - `<group>.<sub>.scenario.spec.ts` — `scenario` placed after a subgroup
+ *   (e.g. `worker.payroll.scenario.spec.ts`, `school.job.publish.scenario.spec.ts`).
+ *   Suggestion: `<group>.scenario.<sub>.spec.ts`.
+ * - `<group>.<rest>.spec.ts` — no `crud` / `scenario` segment at all
+ *   (e.g. `worker.system.spec.ts`). Defaults to a scenario rename suggestion
+ *   because the missing bucket is more often scenario-like.
+ *
+ * This module is pure: classification and canonical-path rendering live
+ * here, with no disk I/O. It's consumed by `@dereekb/dbx-components-mcp`
+ * (the `dbx_model_test_*` tool cluster) and by
+ * `@dereekb/firebase/eslint` (the `require-canonical-api-spec-filename`
+ * and `require-api-crud-spec-for-group` rules).
+ */ /**
+ * Whether a given kind is on-convention. Drift kinds (`-misplaced`,
+ * `no-bucket`) are still parseable but earn a warning + rename suggestion.
+ */ var CANONICAL_KINDS = [
+    'crud',
+    'crud-subgroup',
+    'scenario',
+    'scenario-subgroup'
+];
+var SPEC_SUFFIX = '.spec.ts';
+/**
+ * Classifies a spec filename against the conventions for the given parent
+ * folder. Pure function — never touches the filesystem.
+ *
+ * @param config - Inputs.
+ * @param config.filename - Bare filename including the `.spec.ts` suffix
+ *   (e.g. `job.scenario.requirement.spec.ts`).
+ * @param config.parentFolderName - Name of the directory containing the file
+ *   (e.g. `job`). Used to detect cross-group misplacement.
+ * @returns The classification.
+ */ function classifySpecFile(config) {
+    var filename = config.filename, parentFolderName = config.parentFolderName;
+    var result;
+    if (!filename.endsWith(SPEC_SUFFIX)) {
+        result = {
+            filename: filename,
+            group: '',
+            kind: 'non-spec',
+            subgroups: [],
+            isCanonical: false
+        };
+    } else {
+        var _parts_;
+        var stem = filename.slice(0, -SPEC_SUFFIX.length);
+        var parts = stem.split('.');
+        var group = (_parts_ = parts[0]) !== null && _parts_ !== void 0 ? _parts_ : '';
+        if (group !== parentFolderName) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'non-group',
+                subgroups: [],
+                isCanonical: false
+            };
+        } else {
+            var rest = parts.slice(1);
+            result = classifyRemainingSegments({
+                filename: filename,
+                group: group,
+                rest: rest
+            });
+        }
+    }
+    return result;
+}
+function classifyRemainingSegments(config) {
+    var filename = config.filename, group = config.group, rest = config.rest;
+    var result;
+    var crudIdx = rest.indexOf('crud');
+    var scenarioIdx = rest.indexOf('scenario');
+    if (crudIdx === 0) {
+        if (rest.length === 1) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'crud',
+                subgroups: [],
+                isCanonical: true
+            };
+        } else {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'crud-subgroup',
+                subgroups: rest.slice(1),
+                isCanonical: true
+            };
+        }
+    } else if (scenarioIdx === 0) {
+        if (rest.length === 1) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'scenario',
+                subgroups: [],
+                isCanonical: true
+            };
+        } else {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'scenario-subgroup',
+                subgroups: rest.slice(1),
+                isCanonical: true
+            };
+        }
+    } else if (crudIdx > 0) {
+        var subgroups = rest.filter(function(_, i) {
+            return i !== crudIdx;
+        });
+        var recommendedRename = buildCanonicalFilename({
+            group: group,
+            bucket: 'crud',
+            subgroups: subgroups
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'crud-misplaced',
+            subgroups: subgroups,
+            isCanonical: false,
+            recommendedRename: recommendedRename,
+            driftReason: '`crud` segment is not directly after the group name.'
+        };
+    } else if (scenarioIdx > 0) {
+        var subgroups1 = rest.filter(function(_, i) {
+            return i !== scenarioIdx;
+        });
+        var recommendedRename1 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: subgroups1
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'scenario-misplaced',
+            subgroups: subgroups1,
+            isCanonical: false,
+            recommendedRename: recommendedRename1,
+            driftReason: '`scenario` segment is not directly after the group name.'
+        };
+    } else if (rest.length === 0) {
+        var recommendedRename2 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: []
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'no-bucket',
+            subgroups: [],
+            isCanonical: false,
+            recommendedRename: recommendedRename2,
+            driftReason: 'Missing `crud` or `scenario` segment.'
+        };
+    } else {
+        var recommendedRename3 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: rest
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'no-bucket',
+            subgroups: rest,
+            isCanonical: false,
+            recommendedRename: recommendedRename3,
+            driftReason: 'Missing `crud` or `scenario` segment — defaulting suggestion to `scenario`.'
+        };
+    }
+    return result;
+}
+/**
+ * Renders a canonical spec filename for the given group + bucket + subgroup
+ * chain. Pure data — used both by drift remediation and by the
+ * `recommendSpecPath()` helper below.
+ *
+ * @param config - Inputs.
+ * @param config.group - The model-group name (e.g. `job`).
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional ordered subgroup segments
+ *   (e.g. `['requirement','worker']`).
+ * @returns The canonical filename (e.g. `job.scenario.requirement.worker.spec.ts`).
+ */ function buildCanonicalFilename(config) {
+    var group = config.group, bucket = config.bucket, subgroups = config.subgroups;
+    var tail = subgroups.length === 0 ? '' : ".".concat(subgroups.join('.'));
+    return "".concat(group, ".").concat(bucket).concat(tail, ".spec.ts");
+}
+/**
+ * Renders the canonical relative path for a spec file under a given API app.
+ * The shape mirrors the layout used throughout the workspace:
+ * `<apiDir>/src/app/function/<group>/<filename>`.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - The relative API-app directory
+ *   (e.g. `apps/hellosubs-api`).
+ * @param config.group - The model-group name.
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional subgroup chain.
+ * @returns The canonical relative spec-file path.
+ */ function recommendSpecPath(config) {
+    var filename = buildCanonicalFilename({
+        group: config.group,
+        bucket: config.bucket,
+        subgroups: config.subgroups
+    });
+    return "".concat(config.apiDir, "/src/app/function/").concat(config.group, "/").concat(filename);
+}
+/**
+ * Returns the two canonical buckets for a given model group, with rendered
+ * paths and one-line summaries. Used by the list-app formatter.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - Relative API-app directory.
+ * @param config.group - Model-group name.
+ * @returns The crud + scenario recommendations.
+ */ function recommendBucketsForGroup(config) {
+    var crudPath = recommendSpecPath({
+        apiDir: config.apiDir,
+        group: config.group,
+        bucket: 'crud',
+        subgroups: []
+    });
+    var scenarioPath = recommendSpecPath({
+        apiDir: config.apiDir,
+        group: config.group,
+        bucket: 'scenario',
+        subgroups: []
+    });
+    return [
+        {
+            bucket: 'crud',
+            label: 'CRUD',
+            canonicalPath: crudPath,
+            summary: 'Non-scenario tests of the CRUD function map — create/read/update/delete + permission/error paths. Add focused buckets as `' + config.group + '.crud.<sub>.spec.ts`.'
+        },
+        {
+            bucket: 'scenario',
+            label: 'Scenario',
+            canonicalPath: scenarioPath,
+            summary: 'Multi-step scenarios using fixture chains (mirrors real workflows). Add focused buckets as `' + config.group + '.scenario.<sub>.spec.ts` (chain subgroups freely, e.g. `.scenario.requirement.worker.spec.ts`).'
+        }
+    ];
+}
+
 exports.ALL_DOUBLE_SLASHES_REGEX = ALL_DOUBLE_SLASHES_REGEX;
 exports.ALL_SLASHES_REGEX = ALL_SLASHES_REGEX;
 exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX = ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX;
@@ -25228,6 +25497,7 @@ exports.AssertMin = AssertMin;
 exports.AssertionError = AssertionError;
 exports.AssertionIssueHandler = AssertionIssueHandler;
 exports.BooleanStringKeyArrayUtility = BooleanStringKeyArrayUtility;
+exports.CANONICAL_KINDS = CANONICAL_KINDS;
 exports.CATCH_ALL_HANDLE_RESULT_KEY = CATCH_ALL_HANDLE_RESULT_KEY;
 exports.COMMA_JOINER = COMMA_JOINER;
 exports.COMMA_STRING_SPLIT_JOIN = COMMA_STRING_SPLIT_JOIN;
@@ -25453,6 +25723,7 @@ exports.boundToRectangle = boundToRectangle;
 exports.breadthFirstExploreTreeTraversalFactoryFunction = breadthFirstExploreTreeTraversalFactoryFunction;
 exports.bufferHasValidPdfMarkings = bufferHasValidPdfMarkings;
 exports.build = build;
+exports.buildCanonicalFilename = buildCanonicalFilename;
 exports.cachedGetter = cachedGetter;
 exports.calculateExpirationDate = calculateExpirationDate;
 exports.camelOrPascalToScreamingSnake = camelOrPascalToScreamingSnake;
@@ -25466,6 +25737,7 @@ exports.chainMapSameFunctions = chainMapSameFunctions;
 exports.characterPrefixSuffixInstance = characterPrefixSuffixInstance;
 exports.checkAnyHaveExpired = checkAnyHaveExpired;
 exports.checkAtleastOneNotExpired = checkAtleastOneNotExpired;
+exports.classifySpecFile = classifySpecFile;
 exports.coerceToEmailParticipants = coerceToEmailParticipants;
 exports.combineMaps = combineMaps;
 exports.compareEqualityWithValueFromItemsFunction = compareEqualityWithValueFromItemsFunction;
@@ -26006,6 +26278,8 @@ exports.readableError = readableError;
 exports.readableStreamToBase64 = readableStreamToBase64;
 exports.readableStreamToBuffer = readableStreamToBuffer;
 exports.readableStreamToStringFunction = readableStreamToStringFunction;
+exports.recommendBucketsForGroup = recommendBucketsForGroup;
+exports.recommendSpecPath = recommendSpecPath;
 exports.rectangleOverlapsRectangle = rectangleOverlapsRectangle;
 exports.reduceBooleansFn = reduceBooleansFn;
 exports.reduceBooleansWithAnd = reduceBooleansWithAnd;

package/index.esm.js

@@ -25207,4 +25207,273 @@ function _ts_generator(thisArg, body) {
     return result;
 }
 
-export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, ALL_TIME_UNITS, APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD, APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanStringKeyArrayUtility, CATCH_ALL_HANDLE_RESULT_KEY, COMMA_JOINER, COMMA_STRING_SPLIT_JOIN, CSV_MIME_TYPE, CUT_VALUE_TO_ZERO_PRECISION, DASH_CHARACTER_PREFIX_INSTANCE, DATE_NOW_VALUE, DAYS_IN_WEEK, DAYS_IN_YEAR, DEFAULT_AUTH_ROLE_CLAIMS_CLAIM_VALUE, DEFAULT_AUTH_ROLE_CLAIMS_EMPTY_VALUE, DEFAULT_CUT_STRING_END_TEXT, DEFAULT_ENCRYPTED_FIELD_PREFIX, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_NUMBER_STRING_DENCODER_64_NEGATIVE_PREFIX, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD, DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, DOCX_MIME_TYPE, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, ExploreTreeVisitNodeDecision, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FlattenTreeAddNodeDecision, FullStorageObject, GIF_MIME_TYPE, HAS_PORT_NUMBER_REGEX, HAS_WEBSITE_DOMAIN_NAME_REGEX, HEIF_MIME_TYPE, HEX_PATTERN, HOURS_IN_DAY, HOUR_OF_DAY_MAXMIMUM, HOUR_OF_DAY_MINIUMUM, HTML_MIME_TYPE, HTTP_OR_HTTPS_REGEX, HashSet, IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD, IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, JPEG_MIME_TYPE, JPEG_MIME_TYPES, JPG_MIME_TYPE, JSON_MIME_TYPE, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MARKDOWN_MIME_TYPE, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MINUTE_OF_DAY_MAXMIMUM, MINUTE_OF_DAY_MINIUMUM, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MS_IN_WEEK, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, NUMBER_STRING_DENCODER_64, NUMBER_STRING_DENCODER_64_DIGITS, OAUTH_OOB_REDIRECT_URI, PDF_ENCRYPT_MARKER, PDF_EOF_MARKER, PDF_HEADER, PDF_MIME_TYPE, PHONE_EXTENSION_NUMBER_REGEX, PJPEG_MIME_TYPE, PNG_MIME_TYPE, PRIMATIVE_KEY_DENCODER_VALUE, PropertyDescriptorUtility, RAW_MIME_TYPE, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_DAY, SECONDS_IN_HOUR, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, SPACE_JOINER, SPACE_STRING_SPLIT_JOIN, SPLIT_STRING_TREE_NODE_ROOT_VALUE, SVG_MIME_TYPE, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, SlashPathPathMatcherPartCode, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TIFF_MIME_TYPE, TIME_UNIT_LABEL_MAP, TIME_UNIT_SHORT_LABEL_MAP, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TXT_MIME_TYPE, TimeAM, TimerCancelledError, TypedServiceRegistryInstance, UNLOADED_PAGE, UNSET_INDEX_NUMBER, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEBP_MIME_TYPE, WEBSITE_TLD_DETECTION_REGEX, WEB_PROTOCOL_PREFIX_REGEX, XLSX_MIME_TYPE, XML_MIME_TYPE, YAML_MIME_TYPE, ZIP_CODE_STRING_REGEX, ZIP_FILE_MIME_TYPE, addHttpToUrl, addLatLngPoints, addMilliseconds, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, addToSplitStringTree, addTrailingSlash, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, allowValueOnceFilter, applicationFileExtensionForMimeType, applyBestFit, applySplitStringTreeWithMultipleValues, applyToMultipleFields, approximateTimerEndDate, areEqualContext, areEqualPOJOValues, areEqualPOJOValuesUsingPojoFilter, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asMinuteOfDay, asNonEmptyArray, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, booleanKeyArrayUtility, boundNumber, boundNumberFunction, boundToRectangle, breadthFirstExploreTreeTraversalFactoryFunction, bufferHasValidPdfMarkings, build, cachedGetter, calculateExpirationDate, camelOrPascalToScreamingSnake, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, characterPrefixSuffixInstance, checkAnyHaveExpired, checkAtleastOneNotExpired, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, compareStrings, compareStringsNumeric, compareWithMappedValuesFunction, computeNextFractionalHour, computeNextFreeIndexFunction, computeNextFreeIndexOnSortedValuesFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertMaybeToNonEmptyArray, convertParticipantToEmailParticipantString, convertTimeDuration, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countAllInNestedArray, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cssTokenVar, cssVariableVar, cutString, cutStringFunction, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromDateOrTimeMillisecondsNumber, dateFromDateOrTimeSecondsNumber, dateFromLogicalDate, dateFromMinuteOfDay, dateOrMillisecondsToDate, dateToHoursAndMinutes, dateToMinuteOfDay, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, decodeRadix36Number, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, depthFirstExploreTreeTraversalFactoryFunction, diffLatLngBoundPoints, diffLatLngPoints, documentFileExtensionForMimeType, dollarAmountString, dollarAmountStringWithUnitFunction, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, encodeRadix36Number, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringCharactersFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandSlashPathPathMatcherPartToDecisionFunctions, expandTreeFunction, expandTrees, expirationDetails, exploreTreeFunction, exponentialPromiseRateLimiter, extendLatLngBound, fileExtensionForMimeType, filterAndMapFunction, filterEmptyArrayValues, filterEmptyPojoValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterKeysOnPOJOFunction, filterMaybeArrayFunction, filterMaybeArrayValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterTuplesOnPOJOFunction, filterUndefinedValues, filterUniqueByIndex, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findBestSplitStringTreeChildMatch, findBestSplitStringTreeChildMatchPath, findBestSplitStringTreeMatch, findBestSplitStringTreeMatchPath, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenObject, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenWhitespace, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, generatePkceCodeChallenge, generatePkceCodeVerifier, getArrayNextIndex, getBaseLog, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasPortNumber, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hasWebsiteTopLevelDomain, hashSetForIndexed, hourToFractionalHour, hoursAndMinutesToString, hoursAndMinutesToTimeUnit, idBatchFactory, imageFileExtensionForMimeType, inMemoryAsyncKeyedValueCache, inMemoryAsyncValueCache, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexRefMap, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, invertMaybeBoolean, invertStringRecord, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEqualDate, isEqualToValueDecisionFunction, isEvenNumber, isExpired, isFalseBooleanKeyArray, isFinalPage, isGetter, isHex, isHexWithByteLength, isHourOfDay, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isKnownHttpWebsiteProtocol, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isMinuteOfDay, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotFalse, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPast, isPdfPasswordProtected, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStandardInternetAccessibleWebsiteUrl, isStringOrTrue, isThrottled, isTrueBooleanKeyArray, isUTCDateString, isUnderThreshold, isUniqueKeyedFunction, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterableToSet, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStrings, joinStringsInstance, joinStringsWithCommas, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, labeledValueMap, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeDefaultNonConcurrentTaskKeyFactory, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeTimer, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectKeysFunction, mapObjectKeysToLowercase, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, memoizeAsyncKeyedValueCache, memoizeAsyncValueCache, mergeArrays, mergeArraysIntoArray, mergeAsyncKeyedValueCaches, mergeAsyncValueCaches, mergeFilterFunctions, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, millisecondsToMinutes, millisecondsToMinutesAndSeconds, millisecondsToTimeUnit, mimeTypeForApplicationFileExtension, mimeTypeForDocumentFileExtension, mimeTypeForFileExtension, mimeTypeForImageFileExtension, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, minutesToHoursAndMinutes, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, monthOfYearFromUTCDate, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, noop, numberStringDencoder, numberStringDencoderDecodedNumberValueFunction, numberStringDencoderEncodedStringValueFunction, numberStringDencoderFunction, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, padStartFunction, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, MAP_IDENTITY as passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksFromFactoryInParallelFunction, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readPortNumber, readUniqueModelKey, readWebsiteProtocol, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFirstMatchingSuffix, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeSuffix, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeValuesAtIndexesFromArrayCopy, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, resetPeriodPromiseRateLimiter, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, runNamedAsyncTasks, runNamedAsyncTasksFunction, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, screamingSnakeToCamelCase, searchStringFilterFunction, secondsToMinutesAndSeconds, selectiveFieldEncryptor, separateValues, separateValuesToSets, sequentialIncrementingNumberStringModelIdFactory, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, simplifyWhitespace, slashPathDetails, slashPathDirectoryTree, slashPathFactory, slashPathFolder, slashPathFolderFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathPathMatcher, slashPathPathMatcherConfig, slashPathStartTypeFactory, slashPathSubPathMatcher, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sliceStringFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitFront, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, splitStringTreeFactory, startOfDayForSystemDateInUTC, startOfDayForUTCDateInUTC, stepsFromIndex, stepsFromIndexFunction, stringCharactersToIndexRecord, stringContains, stringFactoryFromFactory, stringFromDateFactory, stringFromTimeFactory, stringSplitJoinInstance, stringToBoolean, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, stripObject, stripObjectFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, terminatingFactoryFromArray, throwKeyIsRequired, timeDurationToHoursAndMinutes, timeDurationToMilliseconds, timePeriodCounter, timeUnitToMilliseconds, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toMinuteOfDay, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, toggleTimerRunning, transformNumberFunction, transformNumberFunctionConfig, transformStringFunction, transformStringFunctionConfig, transformStrings, trimArray, trueOrFalseString, tryConvertToE164PhoneNumber, tryWithPromiseFactoriesFunction, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, unixDateTimeSecondsNumberForNow, unixDateTimeSecondsNumberFromDate, unixDateTimeSecondsNumberFromDateOrTimeNumber, unixDateTimeSecondsNumberToDate, unixMillisecondsNumberToDate, updateMaybeValue, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlDetails, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapTuples, wrapUseAsyncFunction, wrapUseFunction };
+/**
+ * Spec-file naming conventions for API test files.
+ *
+ * Downstream Firebase Functions API apps keep their tests under
+ * `<apiDir>/src/app/function/<group>/`, with each spec file named so that
+ * "what does this test, and where do I add the next one?" can be answered
+ * from the filename alone. The canonical forms are:
+ *
+ * - `<group>.crud.spec.ts` — non-scenario tests of the CRUD function map for the group.
+ * - `<group>.crud.<sub>[.<sub>...].spec.ts` — CRUD tests focused on a sub-area
+ *   (e.g. `job.crud.requirement.spec.ts`).
+ * - `<group>.scenario.spec.ts` — generic multi-step scenario tests using fixture
+ *   chains.
+ * - `<group>.scenario.<sub>[.<sub>...].spec.ts` — focused scenario sub-bucket
+ *   (e.g. `job.scenario.requirement.worker.state.spec.ts`).
+ *
+ * Drift forms (still parsed, but flagged with a rename suggestion):
+ * - `<group>.<sub>.crud.spec.ts` — `crud` placed after a subgroup.
+ *   Suggestion: `<group>.crud.<sub>.spec.ts`.
+ * - `<group>.<sub>.scenario.spec.ts` — `scenario` placed after a subgroup
+ *   (e.g. `worker.payroll.scenario.spec.ts`, `school.job.publish.scenario.spec.ts`).
+ *   Suggestion: `<group>.scenario.<sub>.spec.ts`.
+ * - `<group>.<rest>.spec.ts` — no `crud` / `scenario` segment at all
+ *   (e.g. `worker.system.spec.ts`). Defaults to a scenario rename suggestion
+ *   because the missing bucket is more often scenario-like.
+ *
+ * This module is pure: classification and canonical-path rendering live
+ * here, with no disk I/O. It's consumed by `@dereekb/dbx-components-mcp`
+ * (the `dbx_model_test_*` tool cluster) and by
+ * `@dereekb/firebase/eslint` (the `require-canonical-api-spec-filename`
+ * and `require-api-crud-spec-for-group` rules).
+ */ /**
+ * Whether a given kind is on-convention. Drift kinds (`-misplaced`,
+ * `no-bucket`) are still parseable but earn a warning + rename suggestion.
+ */ var CANONICAL_KINDS = [
+    'crud',
+    'crud-subgroup',
+    'scenario',
+    'scenario-subgroup'
+];
+var SPEC_SUFFIX = '.spec.ts';
+/**
+ * Classifies a spec filename against the conventions for the given parent
+ * folder. Pure function — never touches the filesystem.
+ *
+ * @param config - Inputs.
+ * @param config.filename - Bare filename including the `.spec.ts` suffix
+ *   (e.g. `job.scenario.requirement.spec.ts`).
+ * @param config.parentFolderName - Name of the directory containing the file
+ *   (e.g. `job`). Used to detect cross-group misplacement.
+ * @returns The classification.
+ */ function classifySpecFile(config) {
+    var filename = config.filename, parentFolderName = config.parentFolderName;
+    var result;
+    if (!filename.endsWith(SPEC_SUFFIX)) {
+        result = {
+            filename: filename,
+            group: '',
+            kind: 'non-spec',
+            subgroups: [],
+            isCanonical: false
+        };
+    } else {
+        var _parts_;
+        var stem = filename.slice(0, -SPEC_SUFFIX.length);
+        var parts = stem.split('.');
+        var group = (_parts_ = parts[0]) !== null && _parts_ !== void 0 ? _parts_ : '';
+        if (group !== parentFolderName) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'non-group',
+                subgroups: [],
+                isCanonical: false
+            };
+        } else {
+            var rest = parts.slice(1);
+            result = classifyRemainingSegments({
+                filename: filename,
+                group: group,
+                rest: rest
+            });
+        }
+    }
+    return result;
+}
+function classifyRemainingSegments(config) {
+    var filename = config.filename, group = config.group, rest = config.rest;
+    var result;
+    var crudIdx = rest.indexOf('crud');
+    var scenarioIdx = rest.indexOf('scenario');
+    if (crudIdx === 0) {
+        if (rest.length === 1) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'crud',
+                subgroups: [],
+                isCanonical: true
+            };
+        } else {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'crud-subgroup',
+                subgroups: rest.slice(1),
+                isCanonical: true
+            };
+        }
+    } else if (scenarioIdx === 0) {
+        if (rest.length === 1) {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'scenario',
+                subgroups: [],
+                isCanonical: true
+            };
+        } else {
+            result = {
+                filename: filename,
+                group: group,
+                kind: 'scenario-subgroup',
+                subgroups: rest.slice(1),
+                isCanonical: true
+            };
+        }
+    } else if (crudIdx > 0) {
+        var subgroups = rest.filter(function(_, i) {
+            return i !== crudIdx;
+        });
+        var recommendedRename = buildCanonicalFilename({
+            group: group,
+            bucket: 'crud',
+            subgroups: subgroups
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'crud-misplaced',
+            subgroups: subgroups,
+            isCanonical: false,
+            recommendedRename: recommendedRename,
+            driftReason: '`crud` segment is not directly after the group name.'
+        };
+    } else if (scenarioIdx > 0) {
+        var subgroups1 = rest.filter(function(_, i) {
+            return i !== scenarioIdx;
+        });
+        var recommendedRename1 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: subgroups1
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'scenario-misplaced',
+            subgroups: subgroups1,
+            isCanonical: false,
+            recommendedRename: recommendedRename1,
+            driftReason: '`scenario` segment is not directly after the group name.'
+        };
+    } else if (rest.length === 0) {
+        var recommendedRename2 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: []
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'no-bucket',
+            subgroups: [],
+            isCanonical: false,
+            recommendedRename: recommendedRename2,
+            driftReason: 'Missing `crud` or `scenario` segment.'
+        };
+    } else {
+        var recommendedRename3 = buildCanonicalFilename({
+            group: group,
+            bucket: 'scenario',
+            subgroups: rest
+        });
+        result = {
+            filename: filename,
+            group: group,
+            kind: 'no-bucket',
+            subgroups: rest,
+            isCanonical: false,
+            recommendedRename: recommendedRename3,
+            driftReason: 'Missing `crud` or `scenario` segment — defaulting suggestion to `scenario`.'
+        };
+    }
+    return result;
+}
+/**
+ * Renders a canonical spec filename for the given group + bucket + subgroup
+ * chain. Pure data — used both by drift remediation and by the
+ * `recommendSpecPath()` helper below.
+ *
+ * @param config - Inputs.
+ * @param config.group - The model-group name (e.g. `job`).
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional ordered subgroup segments
+ *   (e.g. `['requirement','worker']`).
+ * @returns The canonical filename (e.g. `job.scenario.requirement.worker.spec.ts`).
+ */ function buildCanonicalFilename(config) {
+    var group = config.group, bucket = config.bucket, subgroups = config.subgroups;
+    var tail = subgroups.length === 0 ? '' : ".".concat(subgroups.join('.'));
+    return "".concat(group, ".").concat(bucket).concat(tail, ".spec.ts");
+}
+/**
+ * Renders the canonical relative path for a spec file under a given API app.
+ * The shape mirrors the layout used throughout the workspace:
+ * `<apiDir>/src/app/function/<group>/<filename>`.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - The relative API-app directory
+ *   (e.g. `apps/hellosubs-api`).
+ * @param config.group - The model-group name.
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional subgroup chain.
+ * @returns The canonical relative spec-file path.
+ */ function recommendSpecPath(config) {
+    var filename = buildCanonicalFilename({
+        group: config.group,
+        bucket: config.bucket,
+        subgroups: config.subgroups
+    });
+    return "".concat(config.apiDir, "/src/app/function/").concat(config.group, "/").concat(filename);
+}
+/**
+ * Returns the two canonical buckets for a given model group, with rendered
+ * paths and one-line summaries. Used by the list-app formatter.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - Relative API-app directory.
+ * @param config.group - Model-group name.
+ * @returns The crud + scenario recommendations.
+ */ function recommendBucketsForGroup(config) {
+    var crudPath = recommendSpecPath({
+        apiDir: config.apiDir,
+        group: config.group,
+        bucket: 'crud',
+        subgroups: []
+    });
+    var scenarioPath = recommendSpecPath({
+        apiDir: config.apiDir,
+        group: config.group,
+        bucket: 'scenario',
+        subgroups: []
+    });
+    return [
+        {
+            bucket: 'crud',
+            label: 'CRUD',
+            canonicalPath: crudPath,
+            summary: 'Non-scenario tests of the CRUD function map — create/read/update/delete + permission/error paths. Add focused buckets as `' + config.group + '.crud.<sub>.spec.ts`.'
+        },
+        {
+            bucket: 'scenario',
+            label: 'Scenario',
+            canonicalPath: scenarioPath,
+            summary: 'Multi-step scenarios using fixture chains (mirrors real workflows). Add focused buckets as `' + config.group + '.scenario.<sub>.spec.ts` (chain subgroups freely, e.g. `.scenario.requirement.worker.spec.ts`).'
+        }
+    ];
+}
+
+export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, ALL_TIME_UNITS, APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD, APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanStringKeyArrayUtility, CANONICAL_KINDS, CATCH_ALL_HANDLE_RESULT_KEY, COMMA_JOINER, COMMA_STRING_SPLIT_JOIN, CSV_MIME_TYPE, CUT_VALUE_TO_ZERO_PRECISION, DASH_CHARACTER_PREFIX_INSTANCE, DATE_NOW_VALUE, DAYS_IN_WEEK, DAYS_IN_YEAR, DEFAULT_AUTH_ROLE_CLAIMS_CLAIM_VALUE, DEFAULT_AUTH_ROLE_CLAIMS_EMPTY_VALUE, DEFAULT_CUT_STRING_END_TEXT, DEFAULT_ENCRYPTED_FIELD_PREFIX, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_NUMBER_STRING_DENCODER_64_NEGATIVE_PREFIX, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD, DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, DOCX_MIME_TYPE, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, ExploreTreeVisitNodeDecision, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FlattenTreeAddNodeDecision, FullStorageObject, GIF_MIME_TYPE, HAS_PORT_NUMBER_REGEX, HAS_WEBSITE_DOMAIN_NAME_REGEX, HEIF_MIME_TYPE, HEX_PATTERN, HOURS_IN_DAY, HOUR_OF_DAY_MAXMIMUM, HOUR_OF_DAY_MINIUMUM, HTML_MIME_TYPE, HTTP_OR_HTTPS_REGEX, HashSet, IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD, IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, JPEG_MIME_TYPE, JPEG_MIME_TYPES, JPG_MIME_TYPE, JSON_MIME_TYPE, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MARKDOWN_MIME_TYPE, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MINUTE_OF_DAY_MAXMIMUM, MINUTE_OF_DAY_MINIUMUM, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MS_IN_WEEK, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, NUMBER_STRING_DENCODER_64, NUMBER_STRING_DENCODER_64_DIGITS, OAUTH_OOB_REDIRECT_URI, PDF_ENCRYPT_MARKER, PDF_EOF_MARKER, PDF_HEADER, PDF_MIME_TYPE, PHONE_EXTENSION_NUMBER_REGEX, PJPEG_MIME_TYPE, PNG_MIME_TYPE, PRIMATIVE_KEY_DENCODER_VALUE, PropertyDescriptorUtility, RAW_MIME_TYPE, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_DAY, SECONDS_IN_HOUR, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, SPACE_JOINER, SPACE_STRING_SPLIT_JOIN, SPLIT_STRING_TREE_NODE_ROOT_VALUE, SVG_MIME_TYPE, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, SlashPathPathMatcherPartCode, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TIFF_MIME_TYPE, TIME_UNIT_LABEL_MAP, TIME_UNIT_SHORT_LABEL_MAP, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TXT_MIME_TYPE, TimeAM, TimerCancelledError, TypedServiceRegistryInstance, UNLOADED_PAGE, UNSET_INDEX_NUMBER, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEBP_MIME_TYPE, WEBSITE_TLD_DETECTION_REGEX, WEB_PROTOCOL_PREFIX_REGEX, XLSX_MIME_TYPE, XML_MIME_TYPE, YAML_MIME_TYPE, ZIP_CODE_STRING_REGEX, ZIP_FILE_MIME_TYPE, addHttpToUrl, addLatLngPoints, addMilliseconds, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, addToSplitStringTree, addTrailingSlash, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, allowValueOnceFilter, applicationFileExtensionForMimeType, applyBestFit, applySplitStringTreeWithMultipleValues, applyToMultipleFields, approximateTimerEndDate, areEqualContext, areEqualPOJOValues, areEqualPOJOValuesUsingPojoFilter, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asMinuteOfDay, asNonEmptyArray, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, booleanKeyArrayUtility, boundNumber, boundNumberFunction, boundToRectangle, breadthFirstExploreTreeTraversalFactoryFunction, bufferHasValidPdfMarkings, build, buildCanonicalFilename, cachedGetter, calculateExpirationDate, camelOrPascalToScreamingSnake, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, characterPrefixSuffixInstance, checkAnyHaveExpired, checkAtleastOneNotExpired, classifySpecFile, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, compareStrings, compareStringsNumeric, compareWithMappedValuesFunction, computeNextFractionalHour, computeNextFreeIndexFunction, computeNextFreeIndexOnSortedValuesFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertMaybeToNonEmptyArray, convertParticipantToEmailParticipantString, convertTimeDuration, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countAllInNestedArray, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cssTokenVar, cssVariableVar, cutString, cutStringFunction, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromDateOrTimeMillisecondsNumber, dateFromDateOrTimeSecondsNumber, dateFromLogicalDate, dateFromMinuteOfDay, dateOrMillisecondsToDate, dateToHoursAndMinutes, dateToMinuteOfDay, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, decodeRadix36Number, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, depthFirstExploreTreeTraversalFactoryFunction, diffLatLngBoundPoints, diffLatLngPoints, documentFileExtensionForMimeType, dollarAmountString, dollarAmountStringWithUnitFunction, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, encodeRadix36Number, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringCharactersFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandSlashPathPathMatcherPartToDecisionFunctions, expandTreeFunction, expandTrees, expirationDetails, exploreTreeFunction, exponentialPromiseRateLimiter, extendLatLngBound, fileExtensionForMimeType, filterAndMapFunction, filterEmptyArrayValues, filterEmptyPojoValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterKeysOnPOJOFunction, filterMaybeArrayFunction, filterMaybeArrayValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterTuplesOnPOJOFunction, filterUndefinedValues, filterUniqueByIndex, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findBestSplitStringTreeChildMatch, findBestSplitStringTreeChildMatchPath, findBestSplitStringTreeMatch, findBestSplitStringTreeMatchPath, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenObject, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenWhitespace, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, generatePkceCodeChallenge, generatePkceCodeVerifier, getArrayNextIndex, getBaseLog, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasPortNumber, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hasWebsiteTopLevelDomain, hashSetForIndexed, hourToFractionalHour, hoursAndMinutesToString, hoursAndMinutesToTimeUnit, idBatchFactory, imageFileExtensionForMimeType, inMemoryAsyncKeyedValueCache, inMemoryAsyncValueCache, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexRefMap, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, invertMaybeBoolean, invertStringRecord, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEqualDate, isEqualToValueDecisionFunction, isEvenNumber, isExpired, isFalseBooleanKeyArray, isFinalPage, isGetter, isHex, isHexWithByteLength, isHourOfDay, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isKnownHttpWebsiteProtocol, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isMinuteOfDay, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotFalse, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPast, isPdfPasswordProtected, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStandardInternetAccessibleWebsiteUrl, isStringOrTrue, isThrottled, isTrueBooleanKeyArray, isUTCDateString, isUnderThreshold, isUniqueKeyedFunction, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterableToSet, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStrings, joinStringsInstance, joinStringsWithCommas, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, labeledValueMap, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeDefaultNonConcurrentTaskKeyFactory, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeTimer, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectKeysFunction, mapObjectKeysToLowercase, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, memoizeAsyncKeyedValueCache, memoizeAsyncValueCache, mergeArrays, mergeArraysIntoArray, mergeAsyncKeyedValueCaches, mergeAsyncValueCaches, mergeFilterFunctions, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, millisecondsToMinutes, millisecondsToMinutesAndSeconds, millisecondsToTimeUnit, mimeTypeForApplicationFileExtension, mimeTypeForDocumentFileExtension, mimeTypeForFileExtension, mimeTypeForImageFileExtension, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, minutesToHoursAndMinutes, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, monthOfYearFromUTCDate, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, noop, numberStringDencoder, numberStringDencoderDecodedNumberValueFunction, numberStringDencoderEncodedStringValueFunction, numberStringDencoderFunction, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, padStartFunction, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, MAP_IDENTITY as passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksFromFactoryInParallelFunction, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readPortNumber, readUniqueModelKey, readWebsiteProtocol, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, recommendBucketsForGroup, recommendSpecPath, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFirstMatchingSuffix, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeSuffix, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeValuesAtIndexesFromArrayCopy, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, resetPeriodPromiseRateLimiter, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, runNamedAsyncTasks, runNamedAsyncTasksFunction, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, screamingSnakeToCamelCase, searchStringFilterFunction, secondsToMinutesAndSeconds, selectiveFieldEncryptor, separateValues, separateValuesToSets, sequentialIncrementingNumberStringModelIdFactory, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, simplifyWhitespace, slashPathDetails, slashPathDirectoryTree, slashPathFactory, slashPathFolder, slashPathFolderFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathPathMatcher, slashPathPathMatcherConfig, slashPathStartTypeFactory, slashPathSubPathMatcher, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sliceStringFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitFront, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, splitStringTreeFactory, startOfDayForSystemDateInUTC, startOfDayForUTCDateInUTC, stepsFromIndex, stepsFromIndexFunction, stringCharactersToIndexRecord, stringContains, stringFactoryFromFactory, stringFromDateFactory, stringFromTimeFactory, stringSplitJoinInstance, stringToBoolean, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, stripObject, stripObjectFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, terminatingFactoryFromArray, throwKeyIsRequired, timeDurationToHoursAndMinutes, timeDurationToMilliseconds, timePeriodCounter, timeUnitToMilliseconds, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toMinuteOfDay, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, toggleTimerRunning, transformNumberFunction, transformNumberFunctionConfig, transformStringFunction, transformStringFunctionConfig, transformStrings, trimArray, trueOrFalseString, tryConvertToE164PhoneNumber, tryWithPromiseFactoriesFunction, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, unixDateTimeSecondsNumberForNow, unixDateTimeSecondsNumberFromDate, unixDateTimeSecondsNumberFromDateOrTimeNumber, unixDateTimeSecondsNumberToDate, unixMillisecondsNumberToDate, updateMaybeValue, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlDetails, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapTuples, wrapUseAsyncFunction, wrapUseFunction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "13.12.3",
+  "version": "13.12.5",
   "sideEffects": false,
   "exports": {
     "./test": {

package/src/lib/index.d.ts

@@ -35,3 +35,4 @@ export * from './path';
 export * from './sort';
 export * from './type';
 export * from './encryption';
+export * from './test';

package/src/lib/test/index.d.ts

@@ -0,0 +1 @@
+export * from './spec-file-conventions';

package/src/lib/test/spec-file-conventions.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Spec-file naming conventions for API test files.
+ *
+ * Downstream Firebase Functions API apps keep their tests under
+ * `<apiDir>/src/app/function/<group>/`, with each spec file named so that
+ * "what does this test, and where do I add the next one?" can be answered
+ * from the filename alone. The canonical forms are:
+ *
+ * - `<group>.crud.spec.ts` — non-scenario tests of the CRUD function map for the group.
+ * - `<group>.crud.<sub>[.<sub>...].spec.ts` — CRUD tests focused on a sub-area
+ *   (e.g. `job.crud.requirement.spec.ts`).
+ * - `<group>.scenario.spec.ts` — generic multi-step scenario tests using fixture
+ *   chains.
+ * - `<group>.scenario.<sub>[.<sub>...].spec.ts` — focused scenario sub-bucket
+ *   (e.g. `job.scenario.requirement.worker.state.spec.ts`).
+ *
+ * Drift forms (still parsed, but flagged with a rename suggestion):
+ * - `<group>.<sub>.crud.spec.ts` — `crud` placed after a subgroup.
+ *   Suggestion: `<group>.crud.<sub>.spec.ts`.
+ * - `<group>.<sub>.scenario.spec.ts` — `scenario` placed after a subgroup
+ *   (e.g. `worker.payroll.scenario.spec.ts`, `school.job.publish.scenario.spec.ts`).
+ *   Suggestion: `<group>.scenario.<sub>.spec.ts`.
+ * - `<group>.<rest>.spec.ts` — no `crud` / `scenario` segment at all
+ *   (e.g. `worker.system.spec.ts`). Defaults to a scenario rename suggestion
+ *   because the missing bucket is more often scenario-like.
+ *
+ * This module is pure: classification and canonical-path rendering live
+ * here, with no disk I/O. It's consumed by `@dereekb/dbx-components-mcp`
+ * (the `dbx_model_test_*` tool cluster) and by
+ * `@dereekb/firebase/eslint` (the `require-canonical-api-spec-filename`
+ * and `require-api-crud-spec-for-group` rules).
+ */
+/**
+ * The naming buckets recognised by the classifier. `non-spec` is emitted when
+ * the input does not end in `.spec.ts`; `non-group` when the first filename
+ * segment doesn't match the parent folder name (the file belongs to a different
+ * model group or to no group at all).
+ */
+export type SpecFileKind = 'crud' | 'crud-subgroup' | 'scenario' | 'scenario-subgroup' | 'crud-misplaced' | 'scenario-misplaced' | 'no-bucket' | 'non-spec' | 'non-group';
+/**
+ * Whether a given kind is on-convention. Drift kinds (`-misplaced`,
+ * `no-bucket`) are still parseable but earn a warning + rename suggestion.
+ */
+export declare const CANONICAL_KINDS: readonly SpecFileKind[];
+/**
+ * One classified spec file. Drift entries carry a {@link recommendedRename}
+ * suggesting the canonical filename; canonical entries leave it undefined.
+ */
+export interface SpecFileClassification {
+    readonly filename: string;
+    readonly group: string;
+    readonly kind: SpecFileKind;
+    /**
+     * Segments between the group name and the `crud` / `scenario` marker for
+     * `crud-subgroup` / `scenario-subgroup` kinds (e.g. `['requirement','worker']`
+     * for `job.scenario.requirement.worker.spec.ts`). Empty for `crud` /
+     * `scenario` and for non-group kinds.
+     */
+    readonly subgroups: readonly string[];
+    /**
+     * `true` when the kind is one of {@link CANONICAL_KINDS}.
+     */
+    readonly isCanonical: boolean;
+    /**
+     * Suggested canonical filename when the input is drift. `undefined` for
+     * canonical entries and for {@link `non-spec`} / {@link `non-group`}.
+     */
+    readonly recommendedRename?: string;
+    /**
+     * Human-readable reason emitted with drift kinds; `undefined` for canonical
+     * entries. Used by the formatter so each warning line explains itself.
+     */
+    readonly driftReason?: string;
+}
+/**
+ * Classifies a spec filename against the conventions for the given parent
+ * folder. Pure function — never touches the filesystem.
+ *
+ * @param config - Inputs.
+ * @param config.filename - Bare filename including the `.spec.ts` suffix
+ *   (e.g. `job.scenario.requirement.spec.ts`).
+ * @param config.parentFolderName - Name of the directory containing the file
+ *   (e.g. `job`). Used to detect cross-group misplacement.
+ * @returns The classification.
+ */
+export declare function classifySpecFile(config: {
+    readonly filename: string;
+    readonly parentFolderName: string;
+}): SpecFileClassification;
+/**
+ * Renders a canonical spec filename for the given group + bucket + subgroup
+ * chain. Pure data — used both by drift remediation and by the
+ * `recommendSpecPath()` helper below.
+ *
+ * @param config - Inputs.
+ * @param config.group - The model-group name (e.g. `job`).
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional ordered subgroup segments
+ *   (e.g. `['requirement','worker']`).
+ * @returns The canonical filename (e.g. `job.scenario.requirement.worker.spec.ts`).
+ */
+export declare function buildCanonicalFilename(config: {
+    readonly group: string;
+    readonly bucket: 'crud' | 'scenario';
+    readonly subgroups: readonly string[];
+}): string;
+/**
+ * Renders the canonical relative path for a spec file under a given API app.
+ * The shape mirrors the layout used throughout the workspace:
+ * `<apiDir>/src/app/function/<group>/<filename>`.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - The relative API-app directory
+ *   (e.g. `apps/hellosubs-api`).
+ * @param config.group - The model-group name.
+ * @param config.bucket - `crud` or `scenario`.
+ * @param config.subgroups - Optional subgroup chain.
+ * @returns The canonical relative spec-file path.
+ */
+export declare function recommendSpecPath(config: {
+    readonly apiDir: string;
+    readonly group: string;
+    readonly bucket: 'crud' | 'scenario';
+    readonly subgroups: readonly string[];
+}): string;
+/**
+ * One recommendation slot rendered by the list-app tool's "where to add a new
+ * test" section. `subgroups` is left empty for the base buckets; callers
+ * substitute their own subgroup chain when scaffolding a focused file.
+ */
+export interface SpecBucketRecommendation {
+    readonly bucket: 'crud' | 'scenario';
+    readonly label: string;
+    readonly canonicalPath: string;
+    readonly summary: string;
+}
+/**
+ * Returns the two canonical buckets for a given model group, with rendered
+ * paths and one-line summaries. Used by the list-app formatter.
+ *
+ * @param config - Inputs.
+ * @param config.apiDir - Relative API-app directory.
+ * @param config.group - Model-group name.
+ * @returns The crud + scenario recommendations.
+ */
+export declare function recommendBucketsForGroup(config: {
+    readonly apiDir: string;
+    readonly group: string;
+}): readonly SpecBucketRecommendation[];

package/test/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/test",
-  "version": "13.12.3",
+  "version": "13.12.5",
   "peerDependencies": {
-    "@dereekb/util": "13.12.3",
+    "@dereekb/util": "13.12.5",
     "make-error": "^1.3.6"
   },
   "exports": {