@foss.global/interfaces 0.12.0 → 0.13.0

package/changelog.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026-09-05 - 0.13.0
+
+### Features
+
+- add issue observation contract (forgeinventory)
+  - Add IForgeInventoryIssue for provider issue identity, repository-local numbers, metadata, author identity and timestamps.
+  - Document issue inventory semantics and add type-level round-trip contract coverage.
+
 ## 2026-09-04 - 0.12.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@foss.global/interfaces',
-    version: '0.12.0',
+    version: '0.13.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the foss.global Git platform ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHFHQUFxRztDQUNuSCxDQUFBIn0=

package/dist_ts/data/forgeinventory.d.ts

@@ -79,6 +79,30 @@ export interface IForgeInventoryRepository {
     /** Git storage bytes only; never an admission estimate for an outgoing push. */
     gitSizeBytes: TForgeInventoryQuantity;
 }
+/** Issue metadata observed from a provider, never a complete historical import payload. */
+export interface IForgeInventoryIssue {
+    /** Provider row identity; an issue's displayed number is a separate locator. */
+    identity: TForgeInventoryIdentity;
+    repository: TForgeInventoryIdentity;
+    location: IForgeInventoryLocation;
+    /** Canonical positive decimal repository-local number (GitLab iid). */
+    number: string;
+    title: string;
+    /** Provider text verbatim, including empty text; null means not exposed. */
+    body: string | null;
+    state: 'open' | 'closed' | null;
+    /** Provider issue classification, such as GitLab issue/incident/task; null if unknown. */
+    providerType: string | null;
+    /** null means unknown or unsupported, never implicit public visibility. */
+    confidential: boolean | null;
+    /** Reported provider author identity; does not establish an imported original author. */
+    author: TForgeInventoryIdentity;
+    /** ISO 8601 provider content times, distinct from inventory observation times. */
+    createdAt: string | null;
+    updatedAt: string | null;
+    /** null means no observed close time; state determines whether the issue is open. */
+    closedAt: string | null;
+}
 export type TForgeInventoryEntityClass = 'namespaces' | 'users' | 'teams' | 'memberships' | 'repositories' | 'gitRefs' | 'gitObjects' | 'protectedRefs' | 'publicSshKeys' | 'deployKeys' | 'issues' | 'issueComments' | 'pullRequests' | 'reviews' | 'reviewComments' | 'labels' | 'milestones' | 'assignees' | 'reactions' | 'releases' | 'releaseAssets' | 'lfsObjects' | 'packages' | 'packageVersions' | 'packageBlobs' | 'webhooks' | 'webhookDeliveries' | 'ciWorkflows' | 'ciRuns' | 'ciArtifacts' | 'wikis' | 'projects';
 /** Availability of an inventory read, never a claim of write/import fidelity. */
 export type TForgeInventoryCapability = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foss.global/interfaces",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the foss.global Git platform ecosystem.",
   "exports": {

package/readme.md

@@ -98,7 +98,7 @@ Protocol v1 describes OCI execution with Docker or Podman and `tar.gz` source ar
 ### Forge inventory contracts
 
 `IForgeInventoryReport`, `IForgeInventoryPage<TItem>`, `IForgeInventoryNamespace`,
-and `IForgeInventoryRepository` describe operator inventory observations. They
+`IForgeInventoryRepository` and `IForgeInventoryIssue` describe operator inventory observations. They
 are exported from both the package root and `data`. This package supplies types;
 it does not scan a forge or validate network responses.
 
@@ -108,6 +108,15 @@ subgroups and literal hyphens. A source without a stable identifier reports an
 unresolved identity. URLs must be credential-free, and inventory responses need
 operator authorization rather than anonymous public exposure.
 
+Issue observations separate the provider row ID from its repository-local
+`number` (GitLab `iid`) and retain the repository identity. They preserve empty
+body text, unknown metadata, open/closed state, provider issue classification,
+confidentiality, reported author identity and provider content timestamps.
+The reported author does not prove original attribution for previously imported
+issues. Comments, labels, milestones, assignees, attachments and history require
+their own inventory and preservation work; this metadata DTO does not claim
+that those collections or external writes are implemented.
+
 Every canonical entity class has an explicit capability and collection result,
 including classes not inspected or unavailable. Additional provider features
 have their own entries. `enumerated` means the selected collection was exhausted

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@foss.global/interfaces',
-  version: '0.12.0',
+  version: '0.13.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the foss.global Git platform ecosystem.'
 }

package/ts/data/forgeinventory.ts

@@ -81,6 +81,31 @@ export interface IForgeInventoryRepository {
   gitSizeBytes: TForgeInventoryQuantity;
 }
 
+/** Issue metadata observed from a provider, never a complete historical import payload. */
+export interface IForgeInventoryIssue {
+  /** Provider row identity; an issue's displayed number is a separate locator. */
+  identity: TForgeInventoryIdentity;
+  repository: TForgeInventoryIdentity;
+  location: IForgeInventoryLocation;
+  /** Canonical positive decimal repository-local number (GitLab iid). */
+  number: string;
+  title: string;
+  /** Provider text verbatim, including empty text; null means not exposed. */
+  body: string | null;
+  state: 'open' | 'closed' | null;
+  /** Provider issue classification, such as GitLab issue/incident/task; null if unknown. */
+  providerType: string | null;
+  /** null means unknown or unsupported, never implicit public visibility. */
+  confidential: boolean | null;
+  /** Reported provider author identity; does not establish an imported original author. */
+  author: TForgeInventoryIdentity;
+  /** ISO 8601 provider content times, distinct from inventory observation times. */
+  createdAt: string | null;
+  updatedAt: string | null;
+  /** null means no observed close time; state determines whether the issue is open. */
+  closedAt: string | null;
+}
+
 export type TForgeInventoryEntityClass =
   | 'namespaces'
   | 'users'