github.com/google/uuid v1.6.0: NewDCEPerson, NewDCEGroup, Domain

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:golang/github.com/google/uuid@v1.6.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/google/uuid@v1.6.0
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@11.8.0
  - runtime: node@24.13.1

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:5226887b98d83bf9785ef6aa55a7fe043dd3a5a1da65891aaf04b1288b3df4ac","contract":["uuid.NewDCEPerson generates a valid DCE Security (version 2) UUID for Person domain with RFC4122 variant","uuid.NewDCEGroup generates a valid DCE Security (version 2) UUID for Group domain with RFC4122 variant","uuid.Domain constants Person, Group, and Org return expected string representations from String method","UUID.Domain and UUID.ID methods extract domain and principal identifier from DCE Security UUID","uuid.NewDCESecurity generates version 2 UUID preserving custom domain and identifier","uuid.Parse round-trips DCE Security UUID strings preserving Domain and ID"],"goal":"verify pkg:golang/github.com/google/uuid@v1.6.0","kind":"HOW","packages":["pkg:golang/github.com/google/uuid@v1.6.0"],"schemaVersion":1,"symbols":["github.com/google/uuid.NewDCEPerson","github.com/google/uuid.NewDCEGroup","github.com/google/uuid.Domain"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","ecosystem":"golang","os":"windows","osVersionBucket":"11","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/google/uuid@v1.6.0"],"schemaVersion":1,"symbols":["github.com/google/uuid.NewDCEPerson","github.com/google/uuid.NewDCEGroup","github.com/google/uuid.Domain"],"verifierAdapter":"golang@1"}

module sample

go 1.22.0

require github.com/google/uuid v1.6.0

github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=

package main

import (
	"fmt"
	"log"

	"github.com/google/uuid"
)

// GenerateDCEPersonUUID generates a version 2 DCE Security UUID for a Person domain.
func GenerateDCEPersonUUID(uid uint32) (uuid.UUID, error) {
	return uuid.NewDCESecurity(uuid.Person, uid)
}

// GenerateDCEGroupUUID generates a version 2 DCE Security UUID for a Group domain.
func GenerateDCEGroupUUID(gid uint32) (uuid.UUID, error) {
	return uuid.NewDCESecurity(uuid.Group, gid)
}

// InspectDCEUUID extracts the Domain and local ID from a DCE Security UUID.
func InspectDCEUUID(id uuid.UUID) (uuid.Domain, uint32) {
	return id.Domain(), id.ID()
}

func main() {
	personUUID, err := uuid.NewDCEPerson()
	if err != nil {
		log.Fatalf("failed to generate DCE Person UUID: %v", err)
	}
	fmt.Printf("DCE Person UUID: %s (version: %d, domain: %s, id: %d)\n",
		personUUID.String(), personUUID.Version(), personUUID.Domain().String(), personUUID.ID())

	groupUUID, err := uuid.NewDCEGroup()
	if err != nil {
		log.Fatalf("failed to generate DCE Group UUID: %v", err)
	}
	fmt.Printf("DCE Group UUID: %s (version: %d, domain: %s, id: %d)\n",
		groupUUID.String(), groupUUID.Version(), groupUUID.Domain().String(), groupUUID.ID())
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/google/uuid@v1.6.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/google/uuid@v1.6.0"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@11.8.0",
    "runtime": "node@24.13.1"
  }
}

package main

import (
	"fmt"
	"os"

	"github.com/google/uuid"
)

func main() {
	// Assertion 1: uuid.NewDCEPerson generates a valid DCE Security (version 2) UUID for Person domain with RFC4122 variant
	personUUID, err := uuid.NewDCEPerson()
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.NewDCEPerson failed: %v\n", err)
		os.Exit(1)
	}
	if personUUID.Version() != 2 {
		fmt.Fprintf(os.Stderr, "FAIL: expected version 2 for NewDCEPerson, got %d\n", personUUID.Version())
		os.Exit(1)
	}
	if personUUID.Variant() != uuid.RFC4122 {
		fmt.Fprintf(os.Stderr, "FAIL: expected RFC4122 variant, got %v\n", personUUID.Variant())
		os.Exit(1)
	}
	if personUUID.Domain() != uuid.Person {
		fmt.Fprintf(os.Stderr, "FAIL: expected Domain Person, got %v\n", personUUID.Domain())
		os.Exit(1)
	}

	// Assertion 2: uuid.NewDCEGroup generates a valid DCE Security (version 2) UUID for Group domain with RFC4122 variant
	groupUUID, err := uuid.NewDCEGroup()
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.NewDCEGroup failed: %v\n", err)
		os.Exit(1)
	}
	if groupUUID.Version() != 2 {
		fmt.Fprintf(os.Stderr, "FAIL: expected version 2 for NewDCEGroup, got %d\n", groupUUID.Version())
		os.Exit(1)
	}
	if groupUUID.Variant() != uuid.RFC4122 {
		fmt.Fprintf(os.Stderr, "FAIL: expected RFC4122 variant, got %v\n", groupUUID.Variant())
		os.Exit(1)
	}
	if groupUUID.Domain() != uuid.Group {
		fmt.Fprintf(os.Stderr, "FAIL: expected Domain Group, got %v\n", groupUUID.Domain())
		os.Exit(1)
	}

	// Assertion 3: uuid.Domain constants Person, Group, and Org return expected string representations from String method
	if uuid.Person.String() != "Person" {
		fmt.Fprintf(os.Stderr, "FAIL: expected 'Person', got %q\n", uuid.Person.String())
		os.Exit(1)
	}
	if uuid.Group.String() != "Group" {
		fmt.Fprintf(os.Stderr, "FAIL: expected 'Group', got %q\n", uuid.Group.String())
		os.Exit(1)
	}
	if uuid.Org.String() != "Org" {
		fmt.Fprintf(os.Stderr, "FAIL: expected 'Org', got %q\n", uuid.Org.String())
		os.Exit(1)
	}
	if uuid.Domain(3).String() != "Domain3" {
		fmt.Fprintf(os.Stderr, "FAIL: expected 'Domain3', got %q\n", uuid.Domain(3).String())
		os.Exit(1)
	}

	// Assertion 4: UUID.Domain and UUID.ID methods extract domain and principal identifier from DCE Security UUID
	const testUID uint32 = 1005
	dcePerson, err := uuid.NewDCESecurity(uuid.Person, testUID)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.NewDCESecurity failed: %v\n", err)
		os.Exit(1)
	}
	if dcePerson.Domain() != uuid.Person {
		fmt.Fprintf(os.Stderr, "FAIL: expected Domain Person, got %v\n", dcePerson.Domain())
		os.Exit(1)
	}
	if dcePerson.ID() != testUID {
		fmt.Fprintf(os.Stderr, "FAIL: expected ID %d, got %d\n", testUID, dcePerson.ID())
		os.Exit(1)
	}

	// Assertion 5: uuid.NewDCESecurity generates version 2 UUID preserving custom domain and identifier
	const testGID uint32 = 2005
	dceGroup, err := uuid.NewDCESecurity(uuid.Group, testGID)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.NewDCESecurity(Group) failed: %v\n", err)
		os.Exit(1)
	}
	if dceGroup.Version() != 2 || dceGroup.Domain() != uuid.Group || dceGroup.ID() != testGID {
		fmt.Fprintf(os.Stderr, "FAIL: expected Group DCE UUID: version=%d domain=%v id=%d\n", dceGroup.Version(), dceGroup.Domain(), dceGroup.ID())
		os.Exit(1)
	}

	const testOrgID uint32 = 3005
	dceOrg, err := uuid.NewDCESecurity(uuid.Org, testOrgID)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.NewDCESecurity(Org) failed: %v\n", err)
		os.Exit(1)
	}
	if dceOrg.Version() != 2 || dceOrg.Domain() != uuid.Org || dceOrg.ID() != testOrgID {
		fmt.Fprintf(os.Stderr, "FAIL: expected Org DCE UUID: version=%d domain=%v id=%d\n", dceOrg.Version(), dceOrg.Domain(), dceOrg.ID())
		os.Exit(1)
	}

	// Assertion 6: uuid.Parse round-trips DCE Security UUID strings preserving Domain and ID
	parsedPerson, err := uuid.Parse(dcePerson.String())
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: uuid.Parse failed on DCE UUID string: %v\n", err)
		os.Exit(1)
	}
	if parsedPerson != dcePerson {
		fmt.Fprintf(os.Stderr, "FAIL: parsed UUID mismatch: got %v, want %v\n", parsedPerson, dcePerson)
		os.Exit(1)
	}
	if parsedPerson.Domain() != uuid.Person || parsedPerson.ID() != testUID {
		fmt.Fprintf(os.Stderr, "FAIL: parsed DCE UUID properties mismatch: domain=%v id=%d\n", parsedPerson.Domain(), parsedPerson.ID())
		os.Exit(1)
	}

	fmt.Println("PASS: all contract assertions passed for DCE Security UUIDs in github.com/google/uuid@v1.6.0")
}