@foss.global/forgefixtures 0.2.0

package/dist_ts/gitlabseed.default.js

@@ -0,0 +1,84 @@
+/** Projects created in `bulk-group` so project listings span more than one default page (20). */
+export const defaultGitlabBulkProjectCount = 22;
+/**
+ * A compact seed covering the GitLab behaviours inventory readers must handle:
+ * nested groups with public, internal and private visibility, a personal
+ * project, confidential issues and incidents, separate issue and merge request
+ * IID sequences, closed items, labels, milestones, assignees, notes, tags,
+ * releases, a deleted author whose content GitLab moves to its ghost user, and
+ * more projects than one page of a project listing.
+ */
+export const createDefaultGitlabSeedSpec = () => ({
+    users: [
+        { username: 'alice', name: 'Alice Example' },
+        { username: 'bob', name: 'Bob Example' },
+        { username: 'carol' },
+        { username: 'dora' },
+    ],
+    groups: [
+        { path: 'parent-group', visibility: 'public' },
+        { path: 'sub-group', parent: 'parent-group', visibility: 'internal' },
+        { path: 'deep-group', parent: 'parent-group/sub-group', visibility: 'private', members: [{ username: 'alice', accessLevel: 'reporter' }] },
+        { path: 'bulk-group', visibility: 'public' },
+    ],
+    projects: [
+        {
+            namespace: 'parent-group/sub-group',
+            path: 'app',
+            visibility: 'internal',
+            description: 'Internal project in a subgroup',
+            members: [
+                { username: 'alice', accessLevel: 'developer' },
+                { username: 'bob', accessLevel: 'developer' },
+            ],
+            files: [{ path: 'src/index.ts', content: 'export const seeded = true;\n' }],
+            branches: [{ name: 'feature-a', files: [{ path: 'src/feature.ts', content: 'export const feature = 1;\n' }] }],
+            labels: [
+                { name: 'bug', color: '#d73a4a' },
+                { name: 'enhancement', color: '#a2eeef' },
+            ],
+            milestones: [
+                { title: 'v1', state: 'active' },
+                { title: 'v0', state: 'closed' },
+            ],
+            tags: [{ name: 'v1.0.0', ref: 'main', message: 'First release' }],
+            issuesAndMergeRequests: [
+                {
+                    kind: 'issue', key: 'open-labelled', title: 'Open labelled issue', description: 'See !1', author: 'alice',
+                    state: 'opened', labels: ['bug'], milestone: 'v1', assignees: ['bob'], notes: [{ author: 'bob', body: 'Confirmed.' }],
+                },
+                { kind: 'mergeRequest', key: 'feature-mr', title: 'Add feature', author: 'bob', sourceBranch: 'feature-a', targetBranch: 'main', state: 'opened', labels: ['enhancement'] },
+                { kind: 'issue', key: 'confidential', title: 'Confidential issue', author: 'alice', state: 'opened', confidential: true },
+                { kind: 'issue', key: 'incident', title: 'Production incident', author: 'bob', state: 'closed', issueType: 'incident' },
+                {
+                    kind: 'issue', key: 'closed-by-deleted-user', title: 'Closed issue from a deleted user', author: 'dora', state: 'closed',
+                    milestone: 'v0', notes: [{ author: 'dora', body: 'Note from a user who will be deleted.' }],
+                },
+            ],
+            releases: [{ tagName: 'v1.0.0', ref: 'main', name: 'v1.0.0', description: 'Release notes' }],
+        },
+        {
+            namespace: 'parent-group/sub-group/deep-group',
+            path: 'secret',
+            visibility: 'private',
+            issuesAndMergeRequests: [{ kind: 'issue', key: 'private-issue', title: 'Issue in a private project', author: 'alice', state: 'opened' }],
+        },
+        {
+            namespace: 'alice',
+            path: 'personal',
+            visibility: 'public',
+            branches: [{ name: 'topic', files: [{ path: 'notes.md', content: '# Notes\n' }] }],
+            issuesAndMergeRequests: [
+                { kind: 'mergeRequest', key: 'closed-mr', title: 'Closed proposal', author: 'alice', sourceBranch: 'topic', targetBranch: 'main', state: 'closed' },
+                { kind: 'issue', key: 'carol-issue', title: 'Issue from another user', author: 'carol', state: 'closed' },
+            ],
+        },
+        ...Array.from({ length: defaultGitlabBulkProjectCount }, (_valueArg, indexArg) => ({
+            namespace: 'bulk-group',
+            path: `bulk-${String(indexArg + 1).padStart(2, '0')}`,
+            visibility: 'public',
+        })),
+    ],
+    deleteUsers: ['dora'],
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0bGFic2VlZC5kZWZhdWx0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvZ2l0bGFic2VlZC5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLGlHQUFpRztBQUNqRyxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxFQUFFLENBQUM7QUFFaEQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLEdBQW9CLEVBQUUsQ0FBQyxDQUFDO0lBQ2pFLEtBQUssRUFBRTtRQUNMLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsZUFBZSxFQUFFO1FBQzVDLEVBQUUsUUFBUSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsYUFBYSxFQUFFO1FBQ3hDLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRTtRQUNyQixFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUU7S0FDckI7SUFDRCxNQUFNLEVBQUU7UUFDTixFQUFFLElBQUksRUFBRSxjQUFjLEVBQUUsVUFBVSxFQUFFLFFBQVEsRUFBRTtRQUM5QyxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsTUFBTSxFQUFFLGNBQWMsRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFO1FBQ3JFLEVBQUUsSUFBSSxFQUFFLFlBQVksRUFBRSxNQUFNLEVBQUUsd0JBQXdCLEVBQUUsVUFBVSxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLFFBQVEsRUFBRSxPQUFPLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxDQUFDLEVBQUU7UUFDMUksRUFBRSxJQUFJLEVBQUUsWUFBWSxFQUFFLFVBQVUsRUFBRSxRQUFRLEVBQUU7S0FDN0M7SUFDRCxRQUFRLEVBQUU7UUFDUjtZQUNFLFNBQVMsRUFBRSx3QkFBd0I7WUFDbkMsSUFBSSxFQUFFLEtBQUs7WUFDWCxVQUFVLEVBQUUsVUFBVTtZQUN0QixXQUFXLEVBQUUsZ0NBQWdDO1lBQzdDLE9BQU8sRUFBRTtnQkFDUCxF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

package/dist_ts/index.d.ts

@@ -0,0 +1,17 @@
+export * from './00_commitinfo_data.js';
+export * from './interfaces.js';
+export * from './interfaces.giteaseed.js';
+export * from './interfaces.gitlabseed.js';
+export { giteaFixtureImage, gitlabFixtureImage, forgeFixtureLabelPrefix, forgeFixtureLabels } from './constants.js';
+export * from './classes.certificateauthority.js';
+export * from './classes.tlsterminator.js';
+export * from './classes.httpclient.js';
+export { ForgeFixtureReaper, listForgeFixtureResources } from './classes.reaper.js';
+export type { IForgeFixtureReaperOptions, IForgeFixtureInventory } from './classes.reaper.js';
+export { ForgeFixtureStoppedError } from './classes.containerlifecycle.js';
+export * from './classes.giteafixture.js';
+export * from './classes.gitlabfixture.js';
+export * from './classes.giteaseed.js';
+export * from './giteaseed.default.js';
+export * from './classes.gitlabseed.js';
+export * from './gitlabseed.default.js';

package/dist_ts/index.js

@@ -0,0 +1,17 @@
+export * from './00_commitinfo_data.js';
+export * from './interfaces.js';
+export * from './interfaces.giteaseed.js';
+export * from './interfaces.gitlabseed.js';
+export { giteaFixtureImage, gitlabFixtureImage, forgeFixtureLabelPrefix, forgeFixtureLabels } from './constants.js';
+export * from './classes.certificateauthority.js';
+export * from './classes.tlsterminator.js';
+export * from './classes.httpclient.js';
+export { ForgeFixtureReaper, listForgeFixtureResources } from './classes.reaper.js';
+export { ForgeFixtureStoppedError } from './classes.containerlifecycle.js';
+export * from './classes.giteafixture.js';
+export * from './classes.gitlabfixture.js';
+export * from './classes.giteaseed.js';
+export * from './giteaseed.default.js';
+export * from './classes.gitlabseed.js';
+export * from './gitlabseed.default.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxrQkFBa0IsRUFBRSx1QkFBdUIsRUFBRSxrQkFBa0IsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ3BILGNBQWMsbUNBQW1DLENBQUM7QUFDbEQsY0FBYyw0QkFBNEIsQ0FBQztBQUMzQyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSx5QkFBeUIsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRXBGLE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzNFLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyw0QkFBNEIsQ0FBQztBQUMzQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLHlCQUF5QixDQUFDIn0=

package/dist_ts/interfaces.d.ts

@@ -0,0 +1,92 @@
+export type TForgeFixtureKind = 'gitea' | 'gitlab';
+/** A published forge image, pinned by its multi-architecture index digest. */
+export interface IForgeFixtureImage {
+    /** Upstream release the image is expected to report through its version API. */
+    version: string;
+    /** Human-readable tag, retained as evidence only. The digest is what gets pulled. */
+    tag: string;
+    /** Complete `repository@sha256:<index digest>` reference, pulled and verified exactly. */
+    repoDigest: string;
+}
+/** Options shared by every fixture lifecycle. */
+export interface IForgeFixtureLifecycleOptions {
+    /**
+     * Docker Engine socket. Omit to use `@apiclient.xyz/docker` resolution
+     * (`DOCKER_HOST`, then `/var/run/docker.sock`).
+     */
+    dockerSocketPath?: string;
+    /**
+     * Upper bound for this lifecycle. Once exceeded, any later reaper run may
+     * remove its resources even if the owning process is still alive.
+     */
+    maxLifetimeMs?: number;
+    /** Deadline for pulling the pinned image, including its digest verification. */
+    pullTimeoutMs?: number;
+    /** Deadline from container start until the forge answers as ready. */
+    startupTimeoutMs?: number;
+}
+/** Ownership evidence written into the labels of every Docker resource of one lifecycle. */
+export interface IForgeFixtureOwner {
+    lifecycleId: string;
+    kind: TForgeFixtureKind;
+    /** systemd machine id (`/etc/machine-id`); distinguishes hosts that share a host name. */
+    machineId: string;
+    hostname: string;
+    bootId: string;
+    /** PID namespace of the owner (`pid:[<inode>]`); PIDs are only comparable inside it. */
+    pidNamespace: string;
+    pid: number;
+    /** Process start time in clock ticks since boot, guarding against PID reuse. */
+    processStartTicks: string;
+    createdAt: string;
+    expiresAt: string;
+}
+export type TForgeFixtureReapReason = 'owner-exited' | 'owner-rebooted' | 'expired';
+export interface IForgeFixtureReapReport {
+    removedContainers: string[];
+    removedNetworks: string[];
+    removedVolumes: string[];
+    /** Lifecycles removed, with the reason each was considered stale. */
+    reapedLifecycles: Array<{
+        lifecycleId: string;
+        reason: TForgeFixtureReapReason;
+    }>;
+    /** Managed resources whose ownership labels could not be interpreted. They are never removed. */
+    unrecognizedResources: Array<{
+        type: 'container' | 'network' | 'volume';
+        id: string;
+    }>;
+}
+/** Material a test needs to talk to a started fixture over verified TLS. */
+export interface IForgeFixtureEndpoint {
+    /** HTTPS instance root without trailing slash, for example `https://127.0.0.1:41234`. */
+    baseUrl: string;
+    /** PEM of the lifecycle-local certificate authority that issued the endpoint certificate. */
+    caCertificatePem: string;
+}
+export interface IGiteaFixtureRuntime extends IForgeFixtureEndpoint {
+    kind: 'gitea';
+    lifecycleId: string;
+    /** Version reported by `/api/v1/version`, verified against the image pin. */
+    version: string;
+    image: IForgeFixtureImage;
+    /** Site administrator created at bootstrap. Its password is random and never retained. */
+    admin: {
+        username: string;
+        /** Access token with scope `all`. */
+        token: string;
+    };
+}
+export interface IGitlabFixtureRuntime extends IForgeFixtureEndpoint {
+    kind: 'gitlab';
+    lifecycleId: string;
+    /** Version reported by `/api/v4/version`, verified against the image pin. */
+    version: string;
+    image: IForgeFixtureImage;
+    /** The built-in `root` administrator. Its password is generated by GitLab and never read. */
+    admin: {
+        username: string;
+        /** Personal access token with scopes `api` and `sudo`. */
+        token: string;
+    };
+}

package/dist_ts/interfaces.giteaseed.d.ts

@@ -0,0 +1,182 @@
+export type TGiteaVisibility = 'public' | 'limited' | 'private';
+export interface IGiteaSeedFile {
+    path: string;
+    content: string;
+}
+export interface IGiteaSeedUser {
+    username: string;
+    fullName?: string;
+    visibility?: TGiteaVisibility;
+}
+export interface IGiteaSeedOrganization {
+    /** Created by the fixture administrator, who becomes its owner. */
+    name: string;
+    visibility: TGiteaVisibility;
+}
+export interface IGiteaSeedIssue {
+    kind: 'issue';
+    /** Spec-local identifier used to find this issue in the manifest. */
+    key: string;
+    title: string;
+    body?: string;
+    /** Existing user who opens the issue (through the administrator's sudo). */
+    author: string;
+    state: 'open' | 'closed';
+    /** Applied by the administrator, so they are not dropped for authors without write access. */
+    labels?: string[];
+    milestone?: string;
+    assignees?: string[];
+    comments?: Array<{
+        author: string;
+        body: string;
+    }>;
+}
+export interface IGiteaSeedPullRequest {
+    kind: 'pullRequest';
+    key: string;
+    title: string;
+    body?: string;
+    author: string;
+    /** Branch in the same repository. */
+    head: string;
+    base: string;
+    state: 'open' | 'closed';
+    labels?: string[];
+}
+export interface IGiteaSeedRepository {
+    /** A seeded user or organization. */
+    owner: string;
+    name: string;
+    private: boolean;
+    description?: string;
+    collaborators?: Array<{
+        username: string;
+        permission: 'read' | 'write' | 'admin';
+    }>;
+    /** Committed to the default branch (`main`) after auto-initialisation. */
+    files?: IGiteaSeedFile[];
+    /** Each branch is created by one commit of its files on top of `from` (default `main`). */
+    branches?: Array<{
+        name: string;
+        from?: string;
+        files: [IGiteaSeedFile, ...IGiteaSeedFile[]];
+    }>;
+    tags?: Array<{
+        name: string;
+        target: string;
+        message?: string;
+    }>;
+    labels?: Array<{
+        name: string;
+        color: string;
+        description?: string;
+    }>;
+    milestones?: Array<{
+        title: string;
+        description?: string;
+        state?: 'open' | 'closed';
+    }>;
+    /** Created in order; Gitea numbers issues and pull requests from one shared sequence. */
+    issuesAndPullRequests?: Array<IGiteaSeedIssue | IGiteaSeedPullRequest>;
+    releases?: Array<{
+        tagName: string;
+        target: string;
+        name: string;
+        body?: string;
+        draft?: boolean;
+        prerelease?: boolean;
+    }>;
+    /** Uploaded through the Git LFS batch API; their pointers are committed to the default branch. */
+    lfsObjects?: IGiteaSeedFile[];
+}
+export interface IGiteaSeedSpec {
+    users: IGiteaSeedUser[];
+    organizations: IGiteaSeedOrganization[];
+    repositories: IGiteaSeedRepository[];
+    /** Deleted after everything else; content they authored is then attributed to Gitea's ghost user. */
+    deleteUsers?: string[];
+}
+/** What Gitea itself reported after seeding, read back once all mutations finished. */
+export interface IGiteaSeedManifest {
+    baseUrl: string;
+    version: string;
+    users: Array<{
+        username: string;
+        id: number;
+        deleted: boolean;
+    }>;
+    organizations: Array<{
+        name: string;
+        id: number;
+        visibility: TGiteaVisibility;
+    }>;
+    repositories: IGiteaSeedManifestRepository[];
+}
+export interface IGiteaSeedManifestAuthor {
+    id: number;
+    login: string;
+}
+export interface IGiteaSeedManifestRepository {
+    owner: string;
+    name: string;
+    fullName: string;
+    id: number;
+    ownerId: number;
+    private: boolean;
+    internal: boolean;
+    defaultBranch: string;
+    htmlUrl: string;
+    cloneUrl: string;
+    branches: Array<{
+        name: string;
+        commitSha: string;
+    }>;
+    tags: Array<{
+        name: string;
+        commitSha: string;
+    }>;
+    labels: Array<{
+        name: string;
+        id: number;
+    }>;
+    milestones: Array<{
+        title: string;
+        id: number;
+        state: 'open' | 'closed';
+    }>;
+    issues: Array<{
+        key: string;
+        id: number;
+        number: number;
+        state: 'open' | 'closed';
+        author: IGiteaSeedManifestAuthor;
+        labels: string[];
+        milestone: string | null;
+        assignees: string[];
+        comments: Array<{
+            id: number;
+            author: IGiteaSeedManifestAuthor;
+        }>;
+    }>;
+    pullRequests: Array<{
+        key: string;
+        id: number;
+        number: number;
+        state: 'open' | 'closed';
+        author: IGiteaSeedManifestAuthor;
+        head: string;
+        base: string;
+        headSha: string;
+    }>;
+    releases: Array<{
+        tagName: string;
+        id: number;
+        draft: boolean;
+        prerelease: boolean;
+    }>;
+    lfsObjects: Array<{
+        path: string;
+        oid: string;
+        size: number;
+    }>;
+}

package/dist_ts/interfaces.giteaseed.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5naXRlYXNlZWQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbnRlcmZhY2VzLmdpdGVhc2VlZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts/interfaces.gitlabseed.d.ts

@@ -0,0 +1,183 @@
+export type TGitlabVisibility = 'public' | 'internal' | 'private';
+export interface IGitlabSeedFile {
+    path: string;
+    content: string;
+}
+export interface IGitlabSeedUser {
+    username: string;
+    name?: string;
+}
+export interface IGitlabSeedGroup {
+    /** Group path segment. The full path is `<parent>/<path>`. */
+    path: string;
+    /** Full path of an earlier group in the spec, making this a subgroup. */
+    parent?: string;
+    visibility: TGitlabVisibility;
+    members?: Array<{
+        username: string;
+        accessLevel: TGitlabAccessLevel;
+    }>;
+}
+/** GitLab access levels by name: guest 10, reporter 20, developer 30, maintainer 40, owner 50. */
+export type TGitlabAccessLevel = 'guest' | 'reporter' | 'developer' | 'maintainer' | 'owner';
+export interface IGitlabSeedIssue {
+    kind: 'issue';
+    /** Spec-local identifier used to find this issue in the manifest. */
+    key: string;
+    title: string;
+    description?: string;
+    /** Existing user who opens the issue (through the administrator's sudo). */
+    author: string;
+    issueType?: 'issue' | 'incident';
+    confidential?: boolean;
+    state: 'opened' | 'closed';
+    /** Applied by the administrator, so they are not dropped for authors without planning rights. */
+    labels?: string[];
+    milestone?: string;
+    assignees?: string[];
+    notes?: Array<{
+        author: string;
+        body: string;
+    }>;
+}
+export interface IGitlabSeedMergeRequest {
+    kind: 'mergeRequest';
+    key: string;
+    title: string;
+    description?: string;
+    author: string;
+    /** Branch in the same project. */
+    sourceBranch: string;
+    targetBranch: string;
+    state: 'opened' | 'closed';
+    labels?: string[];
+}
+export interface IGitlabSeedProject {
+    /** Full path of a seeded group, or a seeded username for a personal project. */
+    namespace: string;
+    path: string;
+    visibility: TGitlabVisibility;
+    description?: string;
+    members?: Array<{
+        username: string;
+        accessLevel: TGitlabAccessLevel;
+    }>;
+    /** Committed to `main` after initialisation with a README. */
+    files?: IGitlabSeedFile[];
+    /** Each branch is created by one commit of its files on top of `from` (default `main`). */
+    branches?: Array<{
+        name: string;
+        from?: string;
+        files: [IGitlabSeedFile, ...IGitlabSeedFile[]];
+    }>;
+    tags?: Array<{
+        name: string;
+        ref: string;
+        message?: string;
+    }>;
+    labels?: Array<{
+        name: string;
+        color: string;
+        description?: string;
+    }>;
+    /** Closed milestones are closed after the items: GitLab ignores a closed milestone assigned through the API. */
+    milestones?: Array<{
+        title: string;
+        description?: string;
+        state?: 'active' | 'closed';
+    }>;
+    /** Issues and merge requests have separate IID sequences; within each kind they are created in order. */
+    issuesAndMergeRequests?: Array<IGitlabSeedIssue | IGitlabSeedMergeRequest>;
+    releases?: Array<{
+        tagName: string;
+        ref: string;
+        name: string;
+        description?: string;
+    }>;
+}
+export interface IGitlabSeedSpec {
+    users: IGitlabSeedUser[];
+    groups: IGitlabSeedGroup[];
+    projects: IGitlabSeedProject[];
+    /** Deleted after everything else (without hard delete); GitLab moves their contributions to its ghost user. */
+    deleteUsers?: string[];
+}
+export interface IGitlabSeedManifestAuthor {
+    id: number;
+    username: string;
+}
+/** What GitLab itself reported after seeding, read back once all mutations finished. */
+export interface IGitlabSeedManifest {
+    baseUrl: string;
+    version: string;
+    users: Array<{
+        username: string;
+        id: number;
+        deleted: boolean;
+    }>;
+    groups: Array<{
+        fullPath: string;
+        id: number;
+        parentId: number | null;
+        visibility: TGitlabVisibility;
+    }>;
+    projects: IGitlabSeedManifestProject[];
+}
+export interface IGitlabSeedManifestProject {
+    pathWithNamespace: string;
+    id: number;
+    namespaceId: number;
+    namespaceKind: 'group' | 'user';
+    visibility: TGitlabVisibility;
+    defaultBranch: string;
+    webUrl: string;
+    httpUrlToRepo: string;
+    branches: Array<{
+        name: string;
+        commitSha: string;
+    }>;
+    tags: Array<{
+        name: string;
+        commitSha: string;
+    }>;
+    labels: Array<{
+        name: string;
+        id: number;
+    }>;
+    milestones: Array<{
+        title: string;
+        id: number;
+        iid: number;
+        state: 'active' | 'closed';
+    }>;
+    issues: Array<{
+        key: string;
+        id: number;
+        iid: number;
+        state: 'opened' | 'closed';
+        issueType: string;
+        confidential: boolean;
+        author: IGitlabSeedManifestAuthor;
+        labels: string[];
+        milestone: string | null;
+        assignees: string[];
+        notes: Array<{
+            id: number;
+            author: IGitlabSeedManifestAuthor;
+        }>;
+    }>;
+    mergeRequests: Array<{
+        key: string;
+        id: number;
+        iid: number;
+        state: 'opened' | 'closed';
+        author: IGitlabSeedManifestAuthor;
+        sourceBranch: string;
+        targetBranch: string;
+        sha: string;
+    }>;
+    releases: Array<{
+        tagName: string;
+        name: string;
+    }>;
+}

package/dist_ts/interfaces.gitlabseed.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5naXRsYWJzZWVkLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvaW50ZXJmYWNlcy5naXRsYWJzZWVkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist_ts/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist_ts/ownership.d.ts

@@ -0,0 +1,29 @@
+import type { IForgeFixtureOwner, TForgeFixtureKind, TForgeFixtureReapReason } from './interfaces.js';
+export interface IForgeFixtureProcessIdentity {
+    machineId: string;
+    hostname: string;
+    bootId: string;
+    pidNamespace: string;
+    pid: number;
+    processStartTicks: string;
+}
+/**
+ * Reads field 22 (`starttime`) of `/proc/<pid>/stat`. Returns `undefined` when
+ * the process does not exist. The command name may contain spaces and
+ * parentheses, so fields are counted after its closing parenthesis.
+ */
+export declare const readProcessStartTicks: (pidArg: number) => Promise<string | undefined>;
+export declare const readCurrentProcessIdentity: () => Promise<IForgeFixtureProcessIdentity>;
+export declare const createForgeFixtureOwner: (kindArg: TForgeFixtureKind, maxLifetimeMsArg: number) => Promise<IForgeFixtureOwner>;
+/** Labels carried by every Docker resource of one lifecycle. */
+export declare const forgeFixtureOwnerLabels: (ownerArg: IForgeFixtureOwner) => Record<string, string>;
+/** Parses ownership labels; returns `undefined` for anything this package did not write. */
+export declare const parseForgeFixtureOwnerLabels: (labelsArg: Record<string, string> | undefined) => IForgeFixtureOwner | undefined;
+/**
+ * Decides whether a lifecycle is stale. A PID identifies a process only inside
+ * its PID namespace: host-network containers sharing the Docker socket share
+ * hostname and boot id but not PIDs, and machines sharing a remote daemon can
+ * share a host name. Owners on another machine (machine id or host name) or in
+ * another PID namespace are therefore judged by expiry only.
+ */
+export declare const classifyForgeFixtureOwner: (ownerArg: IForgeFixtureOwner, currentArg: IForgeFixtureProcessIdentity, nowArg: Date) => Promise<TForgeFixtureReapReason | "alive">;