attepack

Attepack

Attepack is a shared library of packet envelope primitives, schema contracts, and error packet normalization routines for tool ecosystems.

Purpose

Across a tool ecosystem, public tools such as Remogram, Skillpress, and ReleasePress exchange structured JSON packets (e.g. remogram.forge_facts.v1, skillpress.capability_manifest.v1, release.evidence_manifest.v1, consumer.audit_view_model.v1). Attepack standardizes these packet envelopes and error structures to eliminate duplicate parsing and prevent schema drift.

Modules

Module	Purpose
attepack	Primary entrypoint exporting envelope validation and error packet constructors
attepack/envelope	Enforces packet envelope validation (type, schema_version, observed_at, ok)
attepack/evidence-protocol	Validates neutral producer-native evidence packet conformance without product-specific schemas

Install

npm install attepack

Quick Start

import { validatePacketEnvelope, buildErrorPacket } from 'attepack';

const envelope = validatePacketEnvelope({
  type: 'attepack.sample.v1',
  schema_version: 1,
  observed_at: new Date().toISOString(),
  ok: true
});

Neutral Evidence Protocol

Producer tools should validate their own native packets against the neutral evidence protocol instead of importing downstream product schemas or goldens. Downstream products may consume, compose, archive, report, and evaluate policy over those packets; they are not the protocol owner.

import { validateNeutralEvidencePacket } from 'attepack/evidence-protocol';

validateNeutralEvidencePacket({
  type: 'remogram.forge_facts.v1',
  schema_version: 1,
  ok: true,
  authority_role: 'authoritative'
});

Attepack rejects legacy producer-section fields by default. To reject coupling to a downstream product namespace, pass forbiddenProductNamespaces.