@foss.global/codefeed 5.4.0 → 5.5.0

package/changelog.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2026-11-14 - 5.5.0
+
+### Features
+
+- record each repository's issues with their comments, labels and milestones in a collaboration unit, split the collaboration measures by kind and count project boards (giteasourceinventory)
+  - `discover(signal, { classes: ['collaboration'] })` sets discovery's `collaboration: true`, and `units()` then adds one `{ kind: 'collaboration', owner, name, id }` unit per repository, keyed by its discovered id; a discovery that selects collaboration while a repository has no id rejects with `repository-id-missing` (S8 ruling D12, U3; S8 U1 ruling 1).
+  - A collaboration unit is an `IForgeSourceCollaborationInventory` (`@foss.global/interfaces` 3.4): `highestNumber`, the highest number Gitea lists among the repository's issues and pull requests (not measured when it lists neither), every repository label and milestone, and every issue sorted by number with its comments, all verbatim: title, body, `ref`, times, poster and original author, assignees, label, milestone and project ids, `locked`, `pinOrder`, `dueDate`, `timeEstimate`, and the counts of tracked times, dependencies, attachments and reactions. Gitea's `content_version` is not recorded. A list is `notMeasured`, without a read of it, while Gitea's API hides it: the issues when the issue unit is disabled or an external tracker, or when time tracking (for the repository or the instance) or dependencies are switched off, since Gitea then refuses every issue's tracked times or dependencies with 404 and a refused read must never count as none. Any failed read fails the unit, and so do an issue naming a milestone the listing lacks (`issue-milestone-unlisted`), a number listed twice (`duplicate-number`) and a result over `forgeSourceInventoryUnitMaxBytes` (`unit-over-bound`); records are never partial or truncated. Every read is a GET with the administrator's token, without `Sudo`.
+  - Gitea 28.2.0's REST API never reports `original_author` or `original_author_id`, so `originalAuthor` is null for every record; content Gitea imported from another service keeps its source authors only in Gitea's database and reads as posted by the importing account, which the Docker Gitea test shows with an import. An imported repository's issues are therefore `notMeasured` whenever its record's `original_url` is set and the listing holds an issue, with the reason "Gitea imported this repository (original_url is set); its API names the importing account as poster and never reports the original author.", and none of its issues is read further; an imported repository without issues keeps a complete empty list, and the rule does not depend on `mirror` (S8 U3 ruling, Q1). `original_url` is never recorded. A forge that fills the original author still has it recorded.
+  - Each organization owner records `labelRecords`, its labels sorted by id (null while `labels` is not complete); the composed inventory keeps them, and carries `collaboration` sorted by owner and name, exactly when discovery selects collaboration. A collaboration unit that failed, was not measured or answers for another name is a reason (`collaboration: unit failed: <code>`), and a list that is not measured is a reason by its path (`collaboration.issues: <reason>`).
+  - A repository's `collaboration.byKind` splits comments, reactions, attachments and attachment bytes into their issue and pull request kinds and counts open, closed and merged pull requests; each mixed measure is the sum of its kinds (S8 ruling D13, D14). `collaboration.projects` counts the repository's project boards, which Gitea serves while the projects unit is disabled, and is not measured while the unit allows only owner boards; each owner's `projects` counts its own boards, read with the administrator's token for private owners too (S8 U1 ruling 8).
+  - Compatibility: repository and owner units each read one more listing (`/projects`); a repository record whose `projects_mode` is not `repo`, `owner` or `all` (`invalid-projects-mode`; `invalid-string` when missing), or whose `has_issues` disagrees with its trackers (`inconsistent-issue-unit`), fails the repository unit, as Gitea 28.2.0 cannot produce either state (S8 U3 ruling, Q3). A collaboration unit whose repository record lacks `original_url` as a string fails with `invalid-string`. Time tracking or dependencies switched off leave every affected repository's issues `notMeasured`, for the owner's per-repository decision (S8 ruling D13). Composing a stored result from a reader before this version names the missing `labelRecords`, `projects` and `byKind` as reasons, so the inventory stays incomplete until those units are measured again.
+  - Dependencies: `@foss.global/interfaces` ^3.5.1, which defines the collaboration records (3.4.0) and documents the original-author and `labelRecords` rules above (3.5.1); for the Docker Gitea test, `@foss.global/forgefixtures` ^1.2.0, whose default seed holds the issue cases and records their fields.
+
+### Fixes
+
+- measure a repository's issues while only its pull request unit is disabled, and the reverse (giteasourceinventory)
+  - Gitea 28.2.0 lists every issue and issue comment while only the pull request unit is disabled (`ListIssues` and `ListRepoIssueComments` filter by the readable unit), but 5.4.0 reported every issue, pull request, comment, review, reaction and attachment measure as `notMeasured` when either unit was off (S8 ruling, G2). Each kind is now measured while its own unit is readable; only the measures of the hidden kind, and the mixed measures that include it, are `notMeasured`.
+  - An issue unit configured as an external tracker keeps Gitea's `has_issues` true while its API lists none of the repository's issues; 5.4.0 counted them as a complete zero. They are now `notMeasured` with the reason that the issues unit is an external tracker.
+
 ## 2026-11-13 - 5.4.0
 
 ### Fixes

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@foss.global/codefeed',
-    version: '5.4.0',
+    version: '5.5.0',
     description: 'The @foss.global/codefeed module generates commit/activity feeds from forge providers including Gitea and GitManager.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVIQUF1SDtDQUNySSxDQUFBIn0=

package/dist_ts/classes.giteasourceinventory.d.ts

@@ -43,13 +43,16 @@ export interface IGiteaSourceInventoryOptions {
     packageTransferTimeoutMs?: number;
 }
 /** A class of source data a run measures only when its discovery selects it. */
-export type TGiteaSourceInventoryClass = 'packages';
+export type TGiteaSourceInventoryClass = 'packages' | 'collaboration';
 export interface IGiteaSourceDiscoveryOptions {
     /**
      * Classes beside the instance, owners and repositories to list for
      * measurement. `packages` lists every package, so `units` measures one unit
      * per package; without it, discovery carries no `packages` and the package
-     * class is unread.
+     * class is unread. `collaboration` sets discovery's `collaboration: true`,
+     * so `units` measures one collaboration unit per repository, and the
+     * composed inventory carries the records and every organization's
+     * `labelRecords`; without it, collaboration records are unread.
      */
     classes?: readonly TGiteaSourceInventoryClass[];
 }
@@ -90,17 +93,21 @@ export declare class GiteaSourceInventory {
     get metrics(): IForgeRequestMetrics;
     /**
      * Identifies the source and its reader and lists every owner and repository
-     * with its id, and with `classes: ['packages']` every package from the
-     * administrator package listing (`packages`, absent otherwise). Rejects
-     * unless the token belongs to a site administrator, and rejects an unknown
-     * class with `invalid-options`; a listing that does not finish, or that
-     * lists a repository id twice, is reported in `incompleteReasons`.
+     * with its id, with `classes: ['packages']` every package from the
+     * administrator package listing (`packages`, absent otherwise), and with
+     * `classes: ['collaboration']` sets `collaboration: true`. Rejects unless
+     * the token belongs to a site administrator, and rejects an unknown class
+     * with `invalid-options`; a listing that does not finish, or that lists a
+     * repository id twice, is reported in `incompleteReasons`.
      */
     discover(signalArg?: AbortSignal, optionsArg?: IGiteaSourceDiscoveryOptions): Promise<IDiscovery>;
     /**
      * Every unit a run over this discovery measures: the instance, then owners,
      * then repositories, then the packages discovery lists when it selected
-     * them.
+     * them, then, when it selected collaboration, one collaboration unit per
+     * repository, keyed by the repository's id. A discovery that selects
+     * collaboration while a repository has no id rejects with
+     * `repository-id-missing`; it never falls back to keying by name.
      */
     units(discoveryArg: IDiscovery): TUnit[];
     /**
@@ -114,12 +121,13 @@ export declare class GiteaSourceInventory {
     lookupRepository(idArg: string, signalArg?: AbortSignal): Promise<TGiteaSourceRepositoryLookup>;
     /**
      * Measures one unit. Never rejects: a unit whose primary record cannot be
-     * read is `failed`, and so is a repository unit carrying an id that its name
-     * no longer answers with (`repository-identity-changed`). A package unit is
-     * read whole or fails, never partly: a listing that does not finish, an
-     * index that is not what its file list promises (`unexpected-manifest-shape`)
-     * and a result over `forgeSourceInventoryUnitMaxBytes` of UTF-8 JSON
-     * (`unit-over-bound`) fail it, and its record is never truncated.
+     * read is `failed`, and so is a repository or collaboration unit carrying an
+     * id that its name no longer answers with (`repository-identity-changed`).
+     * Package and collaboration units are read whole or fail, never partly: a
+     * listing that does not finish, an index that is not what its file list
+     * promises (`unexpected-manifest-shape`) and a result over
+     * `forgeSourceInventoryUnitMaxBytes` of UTF-8 JSON (`unit-over-bound`) fail
+     * it, and its records are never truncated.
      */
     measureUnit(unitArg: TUnit, signalArg?: AbortSignal): Promise<TUnitResult>;
     /**
@@ -139,7 +147,11 @@ export declare class GiteaSourceInventory {
  * `packages` and `totals.packageContent` (`composeGiteaPackageContent`) are
  * present exactly when discovery lists packages, an empty list included; a
  * package without a record is left out, never truncated, and makes its
- * content measures partial.
+ * content measures partial. `collaboration` and every organization's
+ * `labelRecords` are present exactly when discovery selects collaboration: a
+ * repository without a collaboration result for its discovered id is left
+ * out and named in the reasons, and a record list that is not measured is a
+ * reason by its path, such as `collaboration.issues`.
  */
 export declare const composeGiteaSourceInventory: (discoveryArg: IDiscovery, resultsArg: TUnitResult[], generatorsArg: plugins.fossInterfaces.data.IForgeSourceInventoryGenerator[]) => IInventory;
 export {};