{
  "markdown": "# Alexandria\n\n> The arctic vault. One canonical place for everything I use to build software.\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![CI](https://github.com/duizendstra/alexandria/actions/workflows/ci.yml/badge.svg)](https://github.com/duizendstra/alexandria/actions/workflows/ci.yml)\n\nAlexandria owns the shared knowledge, libraries, contracts, and tooling of the\n[duizendstra](https://github.com/duizendstra) ecosystem.\n\n## What's Inside\n\n| Directory | Concern | Description |\n|---|---|---|\n| [`go/`](go/) | **BUILD** | Go modules — each with its own `go.mod`, independently versioned |\n| [`contracts/`](contracts/) | **DEFINE** | API contracts — Protocol Buffer and ConnectRPC service definitions |\n| [`skills/`](skills/) | **TEACH** | Antigravity AI skills — shareable agent instructions |\n| [`blueprints/`](blueprints/) | **SCAFFOLD** | Golden configuration templates — ko service builds, git hooks, golangci profiles |\n| [`docs/`](docs/) | **KNOW** | Documentation vault — full 8-folder OKF structure |\n\n## Go Modules\n\n| Module | Import Path | Status | Description |\n|---|---|---|---|\n| [retry](go/retry/) | `github.com/duizendstra/alexandria/go/retry` | v1.1.0 | Exponential backoff/jitter retries and transient HTTP roundtrip retries |\n| [retry/gcp](go/retry/gcp/) | `github.com/duizendstra/alexandria/go/retry/gcp` | v1.1.1 | GCP/Google API error classification and retry utilities |\n| [slog-gcp](go/slog-gcp/) | `github.com/duizendstra/alexandria/go/slog-gcp` | v0.1.1 | `slog.Handler` decorator for GCP Cloud Logging (trace URLs, error reporting) |\n| [slog-gcp/otelgcp](go/slog-gcp/otelgcp/) | `github.com/duizendstra/alexandria/go/slog-gcp/otelgcp` | v0.1.0 | OpenTelemetry trace-context bridge for slog-gcp |\n| [google](go/google/) | `github.com/duizendstra/alexandria/go/google` | v0.4.3 | Google Workspace authenticator builders, client factories, CRM & Service Usage clients |\n| [dataquality/datadiff](go/dataquality/datadiff/) | `github.com/duizendstra/alexandria/go/dataquality/datadiff` | v0.3.1 | Proves two datasets equivalent through layered comparison |\n| [observability/audit](go/observability/audit/) | `github.com/duizendstra/alexandria/go/observability/audit` | v1.1.0 | Structured append-only audit logging |\n| [contracts](go/contracts/) | `github.com/duizendstra/alexandria/go/contracts` | v1.0.0 | Compiled Protocol Buffer messages and ConnectRPC services |\n| [discovery/privacyfilter](go/discovery/privacyfilter/) | `github.com/duizendstra/alexandria/go/discovery/privacyfilter` | v0.1.1 | Content filtering before indexing |\n| [discovery/search](go/discovery/search/) | `github.com/duizendstra/alexandria/go/discovery/search` | v0.2.0 | Core types and port interfaces for the Discovery bounded context |\n| [discovery/search/searchtest](go/discovery/search/searchtest/) | `github.com/duizendstra/alexandria/go/discovery/search/searchtest` | v0.0.2 | Reusable contract tests for `search.Index` adapters |\n| [platform/apierr](go/platform/apierr/) | `github.com/duizendstra/alexandria/go/platform/apierr` | v0.1.0 | Sentinel errors for vendor API interactions |\n| [platform/async](go/platform/async/) | `github.com/duizendstra/alexandria/go/platform/async` | v0.1.1 | In-memory async task runner with lifecycle states |\n| [platform/buildstamp](go/platform/buildstamp/) | `github.com/duizendstra/alexandria/go/platform/buildstamp` | v0.3.0 | Build provenance stamping and strict pre-run verification (commit, dirty tree, dependency revisions) |\n| [platform/cache](go/platform/cache/) | `github.com/duizendstra/alexandria/go/platform/cache` | v0.0.2 | Generic, concurrent-safe in-memory TTL cache |\n| [platform/coordination](go/platform/coordination/) | `github.com/duizendstra/alexandria/go/platform/coordination` | v0.2.0 | Interfaces and primitives for process and workload mutual exclusion and coordination |\n| [platform/gcpenv](go/platform/gcpenv/) | `github.com/duizendstra/alexandria/go/platform/gcpenv` | v0.1.0 | Canonical GCP project ID resolution (env vars + metadata service) |\n| [platform/passstore](go/platform/passstore/) | `github.com/duizendstra/alexandria/go/platform/passstore` | v0.1.0 | Deploy-time secret retrieval from the local pass store |\n| [platform/procrun](go/platform/procrun/) | `github.com/duizendstra/alexandria/go/platform/procrun` | v0.3.1 | Run external commands under a controlled environment (scrubbed env, fixed PATH, output to file) |\n| [platform/runstate](go/platform/runstate/) | `github.com/duizendstra/alexandria/go/platform/runstate` | v0.4.0 | Per-subject run lock and short-lived, fingerprint-bound leases on disk |\n| [platform/web](go/platform/web/) | `github.com/duizendstra/alexandria/go/platform/web` | v0.1.1 | Project-agnostic HTTP server, client, and response utilities |\n| [platform/workflow](go/platform/workflow/) | `github.com/duizendstra/alexandria/go/platform/workflow` | v0.2.0 | Context-aware sequential step procedure engine with panic recovery, skip predicates, and lifecycle hooks |\n| [governance](go/governance/) | `github.com/duizendstra/alexandria/go/governance` | v1.0.2 | Pure-Go governance domain model (scope, tiers, hierarchy, classification) |\n| [iac/pulumi/gcpinfra](go/iac/pulumi/gcpinfra/) | `github.com/duizendstra/alexandria/go/iac/pulumi/gcpinfra` | v1.1.0 | Pulumi adapter packages for Google Cloud infrastructure |\n| [iac/pulumi/runner](go/iac/pulumi/runner/) | `github.com/duizendstra/alexandria/go/iac/pulumi/runner` | v0.2.2 | Programmatic Pulumi CLI automation engine built on procrun |\n| [iac/pulumi/stackref](go/iac/pulumi/stackref/) | `github.com/duizendstra/alexandria/go/iac/pulumi/stackref` | v0.1.0 | Typed readers for Pulumi stack reference outputs |\n| [iac/delivery](go/iac/delivery/) | `github.com/duizendstra/alexandria/go/iac/delivery` | v0.1.2 | Configuration-driven Pulumi blueprint provisioning a CI/CD project (registry, Git connection, build triggers, consumer grants) |\n| [iac/finops](go/iac/finops/) | `github.com/duizendstra/alexandria/go/iac/finops` | v0.1.1 | Configuration-driven Pulumi blueprint provisioning a FinOps project (billing dataset, org budget with alerts) |\n| [iac/governance](go/iac/governance/) | `github.com/duizendstra/alexandria/go/iac/governance` | v0.1.2 | Configuration-driven Pulumi blueprint provisioning GCP governance |\n| [iac/identity](go/iac/identity/) | `github.com/duizendstra/alexandria/go/iac/identity` | v0.1.1 | Configuration-driven Pulumi blueprint provisioning an identity project (secrets, SAs, IAM) |\n| [iac/observability](go/iac/observability/) | `github.com/duizendstra/alexandria/go/iac/observability` | v0.3.2 | Configuration-driven Pulumi blueprint provisioning an observability project (log dataset, org audit-log sink, optional uptime checks + alert channel) |\n| [iac/workloads](go/iac/workloads/) | `github.com/duizendstra/alexandria/go/iac/workloads` | v0.1.0 | Configuration-driven Pulumi blueprint provisioning multi-project workload environments with per-concern exports |\n\nVersion numbers signal maturity: `v0.0.x` modules are experimental; `v0.1.x`\nmeans the API shape has been validated by at least one real consumer (see\n[ADR-0001](docs/04-decisions/adr-0001-monorepo-strategy.md)).\n\n\n## Documentation\n\nThe `docs/` directory is an [Open Knowledge Format (OKF)](https://okf.md) bundle\nwith an 8-domain structure designed for both human and agentic consumption.\nSee the [Alexandria OKF Profile](docs/08-reference/okf-profile.md) for details.\n\n| # | Domain | Verb |\n|---|---|---|\n| 01 | governance | GOVERN |\n| 02 | strategy | STRATEGIZE |\n| 03 | architecture | DESIGN |\n| 04 | decisions | DECIDE |\n| 05 | security | PROTECT |\n| 06 | operations | RUN |\n| 07 | playbooks | GUIDE |\n| 08 | reference | LOOK UP |\n\n## License\n\nCode (`go/`, `contracts/`, `.github/`, `.githooks/`) is licensed under\n[Apache-2.0](LICENSE).\n\nDocumentation, skills, and blueprints (`docs/`, `skills/`, `blueprints/`) are\nlicensed under [CC-BY-4.0](docs/LICENSE).\n\nCopyright 2026 Jasper Duizendstra.\n",
  "bytes": 8002,
  "sha": "4462a30a6a0d1dd7869d1481adaca196bb4bb807b8e57796ea006955dce092c4",
  "repo_slug": "duizendstra/alexandria",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_duizendstra_alexandria_docs_index_md_7988397d/readme"
}