{"_id":"@arch-governance/architecture-profile","name":"@arch-governance/architecture-profile","dist-tags":{"next":"0.1.0","latest":"0.1.0"},"versions":{"0.1.0":{"name":"@arch-governance/architecture-profile","version":"0.1.0","description":"Architecture-domain profile aliases for deterministic AGP architecture governance consumers.","license":"Apache-2.0","type":"module","sideEffects":false,"exports":{".":"./dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/agp-protocol/agp.git","directory":"packages/architecture-profile"},"homepage":"https://github.com/agp-protocol/agp/tree/main/packages/architecture-profile#readme","bugs":{"url":"https://github.com/agp-protocol/agp/issues"},"scripts":{"build":"tsc --build"},"engines":{"node":">=18.0.0"},"dependencies":{"@arch-governance/runtime":"1.7.0"},"devDependencies":{"typescript":"^6.0.3"},"gitHead":"6566e497a313b4a2df1935352fac4481f818d2f4","_id":"@arch-governance/architecture-profile@0.1.0","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-o4XBzWTcOCFzbGu2HG+aCFhbJ9v+LJcr4q5QUchDaj16hBhWcHzYAdjDjH57Y/zNPHYEnBvetmJJPwcL4D9KFw==","shasum":"fc2110b45513c674b833dc8fce4641a092a7da40","tarball":"https://registry.npmjs.org/@arch-governance/architecture-profile/-/architecture-profile-0.1.0.tgz","fileCount":4,"unpackedSize":19146,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDWz5KuuGm5VEHB0nEPN6w7Huk0DHoyCNydl51ARzaNfAiEAgic50zv1rwZvr+PUP7Mv+EQ9d8IViN2StYMhR6toZEM="}]},"_npmUser":{"name":"tharcyn","email":"thaasyn@gmail.com"},"directories":{},"maintainers":[{"name":"tharcyn","email":"thaasyn@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/architecture-profile_0.1.0_1777861017988_0.5075973264921285"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T02:16:57.888Z","0.1.0":"2026-05-04T02:16:58.135Z","modified":"2026-05-04T02:16:58.351Z"},"maintainers":[{"name":"tharcyn","email":"thaasyn@gmail.com"}],"description":"Architecture-domain profile aliases for deterministic AGP architecture governance consumers.","homepage":"https://github.com/agp-protocol/agp/tree/main/packages/architecture-profile#readme","repository":{"type":"git","url":"git+https://github.com/agp-protocol/agp.git","directory":"packages/architecture-profile"},"bugs":{"url":"https://github.com/agp-protocol/agp/issues"},"license":"Apache-2.0","readme":"# @arch-governance/architecture-profile\n\n> AGP is the protocol brand. The public npm packages are published under the `@arch-governance` scope.\n\nAGP-native architecture profile — the public-facing TypeScript surface for AGP consumers, CI tools, and the future Arch-Engine emitter.\n\nThis package is a **thin alias layer** over [`@arch-governance/runtime`](../runtime) v1.7.0. It exposes architecture-governance vocabulary (closure-graph hash, producer attestation, topology snapshot, agent-safe mutation boundary, architecture artifact, etc.) so consumers never need to reason in the runtime substrate's `dataset_*`-prefixed naming.\n\n> **Status:** v0.1.0 alpha / preview. The profile may break between v0.x → v1.0. AGP overall is not yet production-stable.\n\n## What this package contains\n\nIn v0.1.0 the profile is **pure naming**:\n\n- **13 evaluator aliases** — direct `export const X = Y` re-exports. Zero call indirection. Identical TypeScript signatures.\n- **13 error-code record aliases** — re-exports of frozen `*_ERROR_CODES` records under AGP-native names. Each alias points to the same `Object.frozen` instance the runtime exports.\n- **13 error class re-exports** — under their **runtime names** (`DatasetPipelineError`, `SnapshotContractError`, etc.). `instanceof DatasetPipelineError` works identically whether the error was thrown from a runtime-direct or profile-aliased call path.\n- **34 type aliases** — `export type ProfileName = RuntimeName` for every public Query / Outcome / input-record type. Compile-time identity; field names inside types are unchanged in v0.1.\n- **1 profile anchor** — `PROFILE_VERSION = 'agp_architecture_profile.v0.1'`.\n\nWhat this package does **not** contain:\n\n- ❌ New algorithms — every evaluator delegates to `@arch-governance/runtime`.\n- ❌ Output transformation — outcomes are returned bit-for-bit from the runtime.\n- ❌ Error wrapping — runtime errors propagate unchanged.\n- ❌ Field renaming inside types — outcomes / queries / records still expose `dataset_*`-prefixed fields. Field-name renaming is a v0.2+ concern.\n- ❌ Crypto, network, filesystem, or I/O.\n- ❌ Trust scoring, certificate validation, or key resolution.\n- ❌ External runtime dependencies — `@arch-governance/runtime` is the only runtime dep.\n\n## Installation\n\n```\nnpm install @arch-governance/architecture-profile\n```\n\n`@arch-governance/runtime` is the only runtime dependency; npm installs it transitively.\n\n## Example — evaluating a topology snapshot\n\n```typescript\nimport {\n  evaluateTopologySnapshotContractV1,\n  TopologySnapshotContractQuery,\n  TopologySnapshotContractOutcome,\n  SnapshotContractError,\n} from '@arch-governance/architecture-profile';\n\ndeclare const query: TopologySnapshotContractQuery;\n\ntry {\n  const outcome: TopologySnapshotContractOutcome =\n    evaluateTopologySnapshotContractV1(query);\n  // …consume admissibility decision\n} catch (err) {\n  if (err instanceof SnapshotContractError) {\n    // Typed runtime error — class name preserved in v0.1.\n  }\n  throw err;\n}\n```\n\n## Example — evaluating producer key registry admission\n\n```typescript\nimport {\n  evaluateProducerKeyRegistryContractV1,\n  ProducerKeyRegistryContractQuery,\n  ProducerKeyRegistryRecord,\n  PRODUCER_KEY_REGISTRY_CONTRACT_V1_ERROR_CODES,\n} from '@arch-governance/architecture-profile';\n\ndeclare const records: ReadonlyArray<ProducerKeyRegistryRecord>;\ndeclare const query: ProducerKeyRegistryContractQuery;\n\nconst outcome = evaluateProducerKeyRegistryContractV1(query);\n\n// Frozen error-code record is the same instance @arch-governance/runtime exports:\nconsole.log(Object.isFrozen(PRODUCER_KEY_REGISTRY_CONTRACT_V1_ERROR_CODES));\n```\n\n## Vocabulary mapping\n\nThe full mapping between runtime and profile names is in [`specs/architecture-profile/AGP_ARCHITECTURE_PROFILE_MAPPING_SPEC.md`](../../specs/architecture-profile/AGP_ARCHITECTURE_PROFILE_MAPPING_SPEC.md). Highlights:\n\n| Runtime | AGP profile |\n|---|---|\n| `evaluateDatasetPipeline` | `evaluateArchitectureArtifactPipeline` |\n| `evaluateDatasetMutationPipeline` | `evaluateAgentMutationBoundaryPipeline` |\n| `evaluateDatasetCapabilityPipeline` | `evaluateActorAuthorityPipeline` |\n| `evaluateDatasetSnapshotPipeline` | `evaluateTopologySnapshotPipeline` |\n| `evaluateDatasetFederationPipeline` | `evaluateArchitectureFederationPipeline` |\n| `evaluateDatasetTrustPolicyPipeline` | `evaluateArchitectureTrustPolicyPipeline` |\n| `evaluateCapabilityContractV2` | `evaluateAuthorityDelegationContractV1` |\n| `evaluateDatasetLifecycleContractV1` | `evaluateArchitectureLifecycleContractV1` |\n| `evaluateDatasetReleaseContractV1` | `evaluateArchitectureReleaseContractV1` |\n| `evaluateSnapshotContractV1` | `evaluateTopologySnapshotContractV1` |\n| `evaluateSnapshotHashBindingContractV1` | `evaluateClosureGraphHashBindingContractV1` |\n| `evaluateSnapshotSignatureContractV1` | `evaluateProducerAttestationContractV1` |\n| `evaluateKeyRegistryContractV1` | `evaluateProducerKeyRegistryContractV1` |\n\n## Where this fits in the AGP stack\n\n```\nAGP open protocol spec\n        ↓\nArch-Engine  (extractor / emitter — future)\n        ↓ emits records typed against this profile\n@arch-governance/architecture-profile  ← you are here\n        ↓ delegates evaluation\n@arch-governance/runtime  (deterministic-admission substrate, sealed v1.7.0)\n```\n\nSee [`docs/architecture.md`](../../docs/architecture.md) for the full four-layer model.\n\n## SemVer\n\n- **v0.x** — alias names, type alias names, error-code alias names, and the profile anchor literal **may break**. Underlying runtime semantics, frozen runtime error codes, and runtime anchor literals do not break.\n- **v1.0** — gated on AGP being production-stable (profile spec accepted + runtime extracted + Arch-Engine MVP + CI demo + at least one external pilot). See [`docs/roadmap.md`](../../docs/roadmap.md).\n\n## License\n\nApache-2.0. See the [LICENSE](https://github.com/agp-protocol/agp/blob/main/LICENSE) file at the repo root for the full text.\n","readmeFilename":"README.md","_rev":"1-313f3da615f9e279f9a4425ec5c88a11"}