@codometer/measurement 0.0.78 → 0.0.79

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 0.0.79 (2026-11-11)
+
+### 🚀 Features
+
+- **codometer:** ✨ tighten the comment budgets and shorten every comment over them ([#2262](https://github.com/organizzolini/codebase/pull/2262), [#2261](https://github.com/organizzolini/codebase/issues/2261))
+
+### 🧱 Updated Dependencies
+
+- Updated codometer-configuration to 0.0.79
+- Updated codometer-languages to 0.0.79
+- Updated codometer-core to 0.0.79
+
 ## 0.0.78 (2026-11-10)
 
 ### 🚀 Features

package/dist/src/index.d.ts

@@ -166,20 +166,18 @@ declare interface DuplicateTargetFinding {
 }
 
 /**
- * Raised when a target carrying a limit matched no files at all.
+ * Raised when a target carrying a limit matched no files.
  *
- * Writing a limit asserts the files exist, so nothing to measure means a glob
- * that no longer matches or a build that never ran — either way a number that
- * would pass every limit written against it. A target nobody limited is left
- * alone: there it is simply zero, and unremarkable.
+ * A limit asserts its files exist, so an empty match means a stale glob or a
+ * build that never ran, and a zero would pass every limit.
+ *
+ * Targets nobody limited are left alone.
  */
 export declare class EmptyTargetError extends Error {
     constructor(target: string, metric: string);
 }
 
-/**
- * What one limit found once it was pointed at its metric. A breach carries `breached`; a held limit is reported alike.
- */
+/** One limit's result against its metric; a breach sets `breached`. */
 export declare interface EvaluatedLimit {
     /** Whether the measured value came out above the limit. */
     breached: boolean;
@@ -222,9 +220,7 @@ declare class IgnoreRulesService {
     readScope(args: ReadIgnoreScopeArguments): IgnoreScope | undefined;
 }
 
-/**
- * A gitignore rule set and the directory its patterns are relative to, so `/output` claims that project's `output`.
- */
+/** `.gitignore` rules and the directory their patterns are relative to. */
 declare interface IgnoreScope {
     /** Directory the patterns are relative to, `/`-separated from the walk root. `""` is the root itself. */
     directory: string;
@@ -234,9 +230,7 @@ declare interface IgnoreScope {
 /** What a directory entry counts as while an input's tree is walked. */
 export declare type InputEntryKind = "directory" | "file" | "other";
 
-/**
- * What every analysis declared for one input reported over its files. Analyses not requested report `undefined`, never a zero.
- */
+/** One input's analysis results; skipped ones are `undefined`, not zero. */
 export declare interface InputMeasurement {
     /** How many files the input's globs claimed. */
     files: number;
@@ -316,18 +310,14 @@ export declare class InputsService {
     matchFiles(args: MatchInputFilesArguments): string[];
 }
 
-/**
- * One limit that could not be held against anything. Collected rather than thrown, so one run reports every such limit.
- */
+/** A limit that bound to nothing, collected rather than thrown. */
 declare interface LimitFailure {
     /** The dotted path exactly as the limit was written. */
     metric: string;
     reason: string;
 }
 
-/**
- * Every declared limit's result, plus those that bound to nothing. A limit that could not bind is neither a breach nor a pass.
- */
+/** Every limit's result, with unbound limits neither breached nor passed. */
 declare interface LimitsEvaluation {
     failures: LimitFailure[];
     limits: EvaluatedLimit[];
@@ -342,10 +332,9 @@ export declare class LimitsModule {
 /**
  * Holds measured metrics to the limits declared against them.
  *
- * Every metric is addressable, whichever analysis produced it, by a dotted
- * path of target name and metric path. Nothing here decides what a breach
- * costs: it reports which limits were exceeded and how badly, and what that is
- * worth is the caller's to say.
+ * Every metric is addressable by a dotted path of target and metric name.
+ * Nothing here decides what a breach costs: it reports which limits were
+ * exceeded and by how much; the caller decides the rest.
  */
 export declare class LimitsService {
     constructor();
@@ -375,10 +364,7 @@ export declare class LimitsService {
     evaluate(args: EvaluateLimitsArguments): LimitsEvaluation;
 }
 
-/**
- * Values beside a log line rather than inside it: counts and durations change
- * per occurrence, so they stay queryable fields.
- */
+/** Values beside the log line, kept as queryable fields. */
 declare interface LogData {
     [key: string]: unknown;
     /** How many things the operation handled. */
@@ -392,11 +378,10 @@ declare interface LogData {
 }
 
 /**
- * Transient logger, so each injecting class gets its own instance. Each
- * consumer calls `setContext(ClassName.name)`. Backed by pino: JSON in
- * production, pretty-printed in development. Messages start with an emoji
- * naming the subject, then a verb in present progressive or past tense.
- * Varying values such as counts go in `data`, so messages stay groupable.
+ * Transient logger, so each injecting class gets its own instance. Consumers
+ * call `setContext(ClassName.name)`. Backed by pino: JSON in production,
+ * pretty-printed in development. Messages start with an emoji naming the subject,
+ * then a present or past-tense verb. Varying values such as counts go in `data`.
  */
 declare @Injectable({ scope: Scope.TRANSIENT })
 class LoggerService
@@ -414,7 +399,7 @@ implements LoggerServiceContract
     private static readonly isProduction =
     process.env["NODE_ENV"] === "production";
 
-    /** Built on first use, so `logToStandardError` can still choose the destination after import. */
+    /** Built lazily, so `logToStandardError` can still set the destination. */
     private static rootLogger: pino.Logger | undefined;
 
     /** Whether lines go to standard error instead of standard output. */
@@ -674,7 +659,7 @@ implements LoggerServiceContract
     }
 }
 
-/** The public logger shape used to type test doubles without importing its service. */
+/** Public logger shape, for test doubles without the service. */
 declare interface LoggerServiceContract extends ConsoleLogger {
     /** Normalizes unknown errors into a stable message and timestamped log line. */
     buildErrorLogEntry(
@@ -709,9 +694,7 @@ export declare interface MeasureArguments {
     workingDirectory: string;
 }
 
-/**
- * What one target measured, as the limits layer reads it. Declared here so this layer needs no measurement types.
- */
+/** One target's measurements, as the limits layer reads them. */
 declare interface MeasuredTarget {
     files: number;
     language: CodeStatisticsResult | undefined;
@@ -719,9 +702,7 @@ declare interface MeasuredTarget {
     size: SizeResult | undefined;
 }
 
-/**
- * Everything one run measured, input by input. `statistics` holds the codebase's language metrics, held out for consumers.
- */
+/** Everything one run measured, input by input; `statistics` stands apart. */
 export declare interface MeasurementResult {
     /**
      * What the run could not do, collected rather than thrown.
@@ -810,10 +791,9 @@ declare interface MetricIndexResult {
 /**
  * Makes every measured number addressable by a dotted path.
  *
- * The same index answers two questions that used to be one layer's private
- * business: which metric a limit is written against, and which metrics the
- * report has to list. Both need every number a target measured, named the same
- * way, so the naming lives here rather than in either caller.
+ * One index answers both which metric a limit targets and which metrics the
+ * report lists. Both need every number named the same way, so the naming lives
+ * here, not in either caller.
  */
 export declare class MetricIndexService {
     constructor();
@@ -843,7 +823,7 @@ export declare class MetricIndexService {
     index(targets: readonly MeasuredTarget[]): MetricIndexResult;
 }
 
-/** A message split into the emoji the console shows and the prose telemetry stores. */
+/** Message split into emoji and the prose telemetry stores. */
 declare interface ParsedLogMessage {
     emoji: string | undefined;
     text: string;
@@ -912,10 +892,9 @@ export declare interface TargetMetricIndex {
 /**
  * Raised when a limit's dotted path does not name exactly one metric.
  *
- * Both halves of that are failures worth stopping for. A path naming nothing
- * gates nothing while looking like a gate, and a path naming several would
- * have to pick one — and a limit quietly holding the wrong metric is a limit
- * nobody would ever discover was wrong.
+ * A path naming nothing gates nothing while looking like a gate. A path naming
+ * several would have to pick one, and a limit quietly holding the wrong metric
+ * would never be discovered.
  */
 export declare class UnboundMetricError extends Error {
     constructor(path: string, reason: string);
@@ -924,11 +903,11 @@ export declare class UnboundMetricError extends Error {
 /**
  * Raised when a file a target matched cannot be read.
  *
- * Louder than the unreadable *directory* discovery tolerates, and deliberately
- * so: a directory nobody can read narrows what was measured, while a matched
- * file nobody can read makes the reported total wrong by definition. Size
- * analysis exists to gate, and a number quietly short by one file lets a real
- * breach pass.
+ * Louder than discovery's directory tolerance, on purpose: an unreadable
+ * directory narrows the measurement, while an unreadable matched file makes the
+ * total wrong.
+ *
+ * Quietly short by one file, a number would let a breach pass.
  */
 export declare class UnreadableTargetFileError extends Error {
     constructor(filePath: string, reason: string);

package/package.json

@@ -4,9 +4,9 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@codometer/configuration": "0.0.78",
-    "@codometer/core": "0.0.78",
-    "@codometer/languages": "0.0.78",
+    "@codometer/configuration": "0.0.79",
+    "@codometer/core": "0.0.79",
+    "@codometer/languages": "0.0.79",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "ignore": "7.0.14",
     "pino": "^10.3.1",
@@ -64,5 +64,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.78"
+  "version": "0.0.79"
 }