@medicine-wheel/developer-repository-mapping 0.0.0-stage → 0.22.0

package/dist/schemas.d.ts

@@ -0,0 +1,409 @@
+/**
+ * Zod schemas for every row a mapping folder holds.
+ *
+ * Strict objects, for the reason `@medicine-wheel/capabilities` gives: in rows
+ * written by models, an unknown key is far more often a misspelling than a new
+ * field. Endpoint kinds are checked per relation name, so a `realizes` that
+ * starts from a repository fails on its own line, not later in a graph.
+ *
+ * Each shape lists the row's identity first and its attribution last. Parsing
+ * returns keys in shape order, so a row read and written back comes out in the
+ * same order every time, and rewriting one row leaves the others' lines as they were.
+ */
+import { z } from 'zod';
+export declare const LifecycleSchema: z.ZodEnum<["unclassified", "prototype", "implementation", "maintained", "archived"]>;
+export declare const LifecycleEventSchema: z.ZodEnum<["explore", "implement", "concretize", "release", "archive", "reopen"]>;
+export declare const OriginSchema: z.ZodEnum<["own", "agent", "community-fork"]>;
+export declare const DeveloperEdgeNameSchema: z.ZodEnum<["forked-from", "grew-into", "provides", "realizes", "consumes", "field-aligns-with"]>;
+export declare const RepositoryNodeIdSchema: z.ZodString;
+export declare const FeatureNodeIdSchema: z.ZodString;
+export declare const ResearchFieldNodeIdSchema: z.ZodString;
+export declare const PrototypeNodeIdSchema: z.ZodString;
+export declare const ActivityReadingSchema: z.ZodObject<{
+    observedBy: z.ZodString;
+    observedAt: z.ZodString;
+    commits: z.ZodNumber;
+    commitsLast90Days: z.ZodNumber;
+    firstCommitAt: z.ZodOptional<z.ZodString>;
+    lastCommitAt: z.ZodOptional<z.ZodString>;
+    tags: z.ZodNumber;
+    branch: z.ZodOptional<z.ZodString>;
+    head: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    observedBy: string;
+    observedAt: string;
+    commits: number;
+    commitsLast90Days: number;
+    tags: number;
+    firstCommitAt?: string | undefined;
+    lastCommitAt?: string | undefined;
+    branch?: string | undefined;
+    head?: string | undefined;
+}, {
+    observedBy: string;
+    observedAt: string;
+    commits: number;
+    commitsLast90Days: number;
+    tags: number;
+    firstCommitAt?: string | undefined;
+    lastCommitAt?: string | undefined;
+    branch?: string | undefined;
+    head?: string | undefined;
+}>;
+export declare const RepositoryFacetSchema: z.ZodEffects<z.ZodObject<{
+    statedBy: z.ZodString;
+    statedAt: z.ZodString;
+    grounding: z.ZodArray<z.ZodString, "many">;
+    revision: z.ZodEnum<["pending", "revised", "affirmed"]>;
+    revisedBy: z.ZodOptional<z.ZodString>;
+    revisedAt: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodString;
+    origin: z.ZodEnum<["own", "agent", "community-fork"]>;
+    lifecycle: z.ZodEnum<["unclassified", "prototype", "implementation", "maintained", "archived"]>;
+    purpose: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    horizon: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    status: z.ZodEnum<["clear", "unclear", "undefinable", "needs-resolution"]>;
+    fields: z.ZodArray<z.ZodString, "many">;
+    prototypes: z.ZodArray<z.ZodString, "many">;
+    holder: z.ZodOptional<z.ZodString>;
+    observed: z.ZodOptional<z.ZodObject<{
+        observedBy: z.ZodString;
+        observedAt: z.ZodString;
+        commits: z.ZodNumber;
+        commitsLast90Days: z.ZodNumber;
+        firstCommitAt: z.ZodOptional<z.ZodString>;
+        lastCommitAt: z.ZodOptional<z.ZodString>;
+        tags: z.ZodNumber;
+        branch: z.ZodOptional<z.ZodString>;
+        head: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    }, {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    nodeId: string;
+    lifecycle: "unclassified" | "prototype" | "implementation" | "maintained" | "archived";
+    origin: "own" | "agent" | "community-fork";
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    fields: string[];
+    prototypes: string[];
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    observed?: {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
+    purpose?: string | undefined;
+    horizon?: string | undefined;
+    holder?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+}, {
+    nodeId: string;
+    lifecycle: "unclassified" | "prototype" | "implementation" | "maintained" | "archived";
+    origin: "own" | "agent" | "community-fork";
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    fields: string[];
+    prototypes: string[];
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    observed?: {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
+    purpose?: string | undefined;
+    horizon?: string | undefined;
+    holder?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+}>, {
+    nodeId: string;
+    lifecycle: "unclassified" | "prototype" | "implementation" | "maintained" | "archived";
+    origin: "own" | "agent" | "community-fork";
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    fields: string[];
+    prototypes: string[];
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    observed?: {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
+    purpose?: string | undefined;
+    horizon?: string | undefined;
+    holder?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+}, {
+    nodeId: string;
+    lifecycle: "unclassified" | "prototype" | "implementation" | "maintained" | "archived";
+    origin: "own" | "agent" | "community-fork";
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    fields: string[];
+    prototypes: string[];
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    observed?: {
+        observedBy: string;
+        observedAt: string;
+        commits: number;
+        commitsLast90Days: number;
+        tags: number;
+        firstCommitAt?: string | undefined;
+        lastCommitAt?: string | undefined;
+        branch?: string | undefined;
+        head?: string | undefined;
+    } | undefined;
+    purpose?: string | undefined;
+    horizon?: string | undefined;
+    holder?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+}>;
+export declare const FeatureFacetSchema: z.ZodEffects<z.ZodObject<{
+    statedBy: z.ZodString;
+    statedAt: z.ZodString;
+    grounding: z.ZodArray<z.ZodString, "many">;
+    revision: z.ZodEnum<["pending", "revised", "affirmed"]>;
+    revisedBy: z.ZodOptional<z.ZodString>;
+    revisedAt: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodString;
+    repository: z.ZodString;
+    name: z.ZodString;
+    statement: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    status: z.ZodEnum<["clear", "unclear", "undefinable", "needs-resolution"]>;
+    realizes: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    nodeId: string;
+    repository: string;
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    name: string;
+    realizes?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    statement?: string | undefined;
+}, {
+    nodeId: string;
+    repository: string;
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    name: string;
+    realizes?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    statement?: string | undefined;
+}>, {
+    nodeId: string;
+    repository: string;
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    name: string;
+    realizes?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    statement?: string | undefined;
+}, {
+    nodeId: string;
+    repository: string;
+    status: "clear" | "unclear" | "undefinable" | "needs-resolution";
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    name: string;
+    realizes?: string | undefined;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    statement?: string | undefined;
+}>;
+export declare const RelationRowSchema: z.ZodEffects<z.ZodObject<{
+    statedBy: z.ZodString;
+    statedAt: z.ZodString;
+    grounding: z.ZodArray<z.ZodString, "many">;
+    revision: z.ZodEnum<["pending", "revised", "affirmed"]>;
+    revisedBy: z.ZodOptional<z.ZodString>;
+    revisedAt: z.ZodOptional<z.ZodString>;
+    from: z.ZodString;
+    to: z.ZodString;
+    type: z.ZodEnum<["forked-from", "grew-into", "provides", "realizes", "consumes", "field-aligns-with"]>;
+    description: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strict", z.ZodTypeAny, {
+    to: string;
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    type: "forked-from" | "grew-into" | "provides" | "realizes" | "consumes" | "field-aligns-with";
+    from: string;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    description?: string | undefined;
+}, {
+    to: string;
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    type: "forked-from" | "grew-into" | "provides" | "realizes" | "consumes" | "field-aligns-with";
+    from: string;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    description?: string | undefined;
+}>, {
+    to: string;
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    type: "forked-from" | "grew-into" | "provides" | "realizes" | "consumes" | "field-aligns-with";
+    from: string;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    description?: string | undefined;
+}, {
+    to: string;
+    statedBy: string;
+    statedAt: string;
+    grounding: string[];
+    revision: "pending" | "revised" | "affirmed";
+    type: "forked-from" | "grew-into" | "provides" | "realizes" | "consumes" | "field-aligns-with";
+    from: string;
+    revisedBy?: string | undefined;
+    revisedAt?: string | undefined;
+    description?: string | undefined;
+}>;
+export declare const OwnerRegistrationSchema: z.ZodEffects<z.ZodObject<{
+    owner: z.ZodString;
+    hub: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    holder: z.ZodOptional<z.ZodString>;
+    registeredBy: z.ZodString;
+    registeredAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    owner: string;
+    hub: string;
+    registeredBy: string;
+    registeredAt: string;
+    holder?: string | undefined;
+    source?: string | undefined;
+}, {
+    owner: string;
+    hub: string;
+    registeredBy: string;
+    registeredAt: string;
+    holder?: string | undefined;
+    source?: string | undefined;
+}>, {
+    owner: string;
+    hub: string;
+    registeredBy: string;
+    registeredAt: string;
+    holder?: string | undefined;
+    source?: string | undefined;
+}, {
+    owner: string;
+    hub: string;
+    registeredBy: string;
+    registeredAt: string;
+    holder?: string | undefined;
+    source?: string | undefined;
+}>;
+export declare const MappingManifestSchema: z.ZodEffects<z.ZodObject<{
+    schema: z.ZodLiteral<"medicine-wheel/repository-mapping">;
+    version: z.ZodLiteral<1>;
+    owner: z.ZodString;
+    hub: z.ZodString;
+    kind: z.ZodEnum<["owner", "meta"]>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    owner: string;
+    hub: string;
+    schema: "medicine-wheel/repository-mapping";
+    version: 1;
+    kind: "owner" | "meta";
+    description?: string | undefined;
+}, {
+    owner: string;
+    hub: string;
+    schema: "medicine-wheel/repository-mapping";
+    version: 1;
+    kind: "owner" | "meta";
+    description?: string | undefined;
+}>, {
+    owner: string;
+    hub: string;
+    schema: "medicine-wheel/repository-mapping";
+    version: 1;
+    kind: "owner" | "meta";
+    description?: string | undefined;
+}, {
+    owner: string;
+    hub: string;
+    schema: "medicine-wheel/repository-mapping";
+    version: 1;
+    kind: "owner" | "meta";
+    description?: string | undefined;
+}>;
+export type ValidatedActivityReading = z.infer<typeof ActivityReadingSchema>;
+export type ValidatedRepositoryFacet = z.infer<typeof RepositoryFacetSchema>;
+export type ValidatedFeatureFacet = z.infer<typeof FeatureFacetSchema>;
+export type ValidatedRelationRow = z.infer<typeof RelationRowSchema>;
+export type ValidatedOwnerRegistration = z.infer<typeof OwnerRegistrationSchema>;
+export type ValidatedMappingManifest = z.infer<typeof MappingManifestSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,eAAe,sFAAoF,CAAC;AAEjH,eAAO,MAAM,oBAAoB,mFAAiF,CAAC;AAEnH,eAAO,MAAM,YAAY,+CAA6C,CAAC;AAEvE,eAAO,MAAM,uBAAuB,kGAOlC,CAAC;AAEH,eAAO,MAAM,sBAAsB,aAAkF,CAAC;AACtH,eAAO,MAAM,mBAAmB,aAEgD,CAAC;AACjF,eAAO,MAAM,yBAAyB,aAEgD,CAAC;AACvF,eAAO,MAAM,qBAAqB,aAAuE,CAAC;AAE1G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB9B,CAAC;AAEL,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB3B,CAAC;AAsBL,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1B,CAAC;AAEL,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchC,CAAC;AAEL,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc9B,CAAC;AAEL,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACrE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Zod schemas for every row a mapping folder holds.
+ *
+ * Strict objects, for the reason `@medicine-wheel/capabilities` gives: in rows
+ * written by models, an unknown key is far more often a misspelling than a new
+ * field. Endpoint kinds are checked per relation name, so a `realizes` that
+ * starts from a repository fails on its own line, not later in a graph.
+ *
+ * Each shape lists the row's identity first and its attribution last. Parsing
+ * returns keys in shape order, so a row read and written back comes out in the
+ * same order every time, and rewriting one row leaves the others' lines as they were.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MappingManifestSchema = exports.OwnerRegistrationSchema = exports.RelationRowSchema = exports.FeatureFacetSchema = exports.RepositoryFacetSchema = exports.ActivityReadingSchema = exports.PrototypeNodeIdSchema = exports.ResearchFieldNodeIdSchema = exports.FeatureNodeIdSchema = exports.RepositoryNodeIdSchema = exports.DeveloperEdgeNameSchema = exports.OriginSchema = exports.LifecycleEventSchema = exports.LifecycleSchema = void 0;
+const zod_1 = require("zod");
+const capabilities_1 = require("@medicine-wheel/capabilities");
+const ids_1 = require("./ids");
+const types_1 = require("./types");
+exports.LifecycleSchema = zod_1.z.enum(['unclassified', 'prototype', 'implementation', 'maintained', 'archived']);
+exports.LifecycleEventSchema = zod_1.z.enum(['explore', 'implement', 'concretize', 'release', 'archive', 'reopen']);
+exports.OriginSchema = zod_1.z.enum(['own', 'agent', 'community-fork']);
+exports.DeveloperEdgeNameSchema = zod_1.z.enum([
+    'forked-from',
+    'grew-into',
+    'provides',
+    'realizes',
+    'consumes',
+    'field-aligns-with',
+]);
+exports.RepositoryNodeIdSchema = zod_1.z.string().regex(ids_1.REPOSITORY_ID, 'a repository id is repository:<owner>/<name>');
+exports.FeatureNodeIdSchema = zod_1.z
+    .string()
+    .regex(ids_1.FEATURE_ID, 'a feature id is feature:<owner>/<name>#<kebab-case-slug>');
+exports.ResearchFieldNodeIdSchema = zod_1.z
+    .string()
+    .regex(ids_1.RESEARCH_FIELD_ID, 'a research field id is research-field:<kebab-case-slug>');
+exports.PrototypeNodeIdSchema = zod_1.z.string().regex(ids_1.PROTOTYPE_ID, 'a prototype id is prototype:<slug>');
+exports.ActivityReadingSchema = zod_1.z
+    .object({
+    observedBy: zod_1.z.string().min(1),
+    observedAt: capabilities_1.TimestampSchema,
+    commits: zod_1.z.number().int().nonnegative(),
+    commitsLast90Days: zod_1.z.number().int().nonnegative(),
+    firstCommitAt: capabilities_1.TimestampSchema.optional(),
+    lastCommitAt: capabilities_1.TimestampSchema.optional(),
+    tags: zod_1.z.number().int().nonnegative(),
+    branch: zod_1.z.string().min(1).optional(),
+    head: zod_1.z.string().min(1).optional(),
+})
+    .strict();
+exports.RepositoryFacetSchema = zod_1.z
+    .object({
+    nodeId: exports.RepositoryNodeIdSchema,
+    origin: exports.OriginSchema,
+    lifecycle: exports.LifecycleSchema,
+    purpose: capabilities_1.StatementSchema.optional(),
+    horizon: capabilities_1.StatementSchema.optional(),
+    status: capabilities_1.StatementStatusSchema,
+    fields: zod_1.z.array(exports.ResearchFieldNodeIdSchema),
+    prototypes: zod_1.z.array(exports.PrototypeNodeIdSchema),
+    holder: zod_1.z.string().min(1).optional(),
+    observed: exports.ActivityReadingSchema.optional(),
+    ...capabilities_1.attributionShape,
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    (0, capabilities_1.refineAttribution)(row, ctx);
+    (0, capabilities_1.refineStatementPresence)(row.status, row.purpose, 'purpose', ctx);
+});
+exports.FeatureFacetSchema = zod_1.z
+    .object({
+    nodeId: exports.FeatureNodeIdSchema,
+    repository: exports.RepositoryNodeIdSchema,
+    name: zod_1.z.string().min(1),
+    statement: capabilities_1.StatementSchema.optional(),
+    status: capabilities_1.StatementStatusSchema,
+    realizes: capabilities_1.CapabilityNodeIdSchema.optional(),
+    ...capabilities_1.attributionShape,
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    (0, capabilities_1.refineAttribution)(row, ctx);
+    (0, capabilities_1.refineStatementPresence)(row.status, row.statement, 'statement', ctx);
+    if ((0, ids_1.featureRepository)(row.nodeId) !== row.repository) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['nodeId'],
+            message: `a feature id names its repository: ${row.nodeId} is not in ${row.repository}`,
+        });
+    }
+});
+const isRepository = (id) => ids_1.REPOSITORY_ID.test(id);
+const isFeature = (id) => ids_1.FEATURE_ID.test(id);
+/** Prefixes this mapping gives a meaning to. A service node id is anything else that is namespaced. */
+const MAPPING_PREFIXES = ['repository:', 'feature:', 'capability:', 'research-field:', 'prototype:'];
+const isService = (id) => /^[^\s:]+:\S+$/.test(id) && !MAPPING_PREFIXES.some((p) => id.startsWith(p));
+/** Which endpoints each relation name joins. */
+const ENDPOINTS = {
+    'forked-from': { from: isRepository, to: isRepository, reads: 'repository → repository' },
+    'grew-into': { from: isRepository, to: isRepository, reads: 'repository → repository' },
+    consumes: { from: isRepository, to: isRepository, reads: 'repository → repository' },
+    provides: {
+        from: (id) => isRepository(id) || isService(id),
+        to: (id) => capabilities_1.CapabilityNodeIdSchema.safeParse(id).success,
+        reads: 'repository or service → capability',
+    },
+    realizes: { from: isFeature, to: (id) => capabilities_1.CapabilityNodeIdSchema.safeParse(id).success, reads: 'feature → capability' },
+    'field-aligns-with': { from: isRepository, to: (id) => ids_1.RESEARCH_FIELD_ID.test(id), reads: 'repository → research-field' },
+};
+exports.RelationRowSchema = zod_1.z
+    .object({
+    from: zod_1.z.string().min(1),
+    to: zod_1.z.string().min(1),
+    type: exports.DeveloperEdgeNameSchema,
+    description: capabilities_1.StatementSchema.optional(),
+    ...capabilities_1.attributionShape,
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    (0, capabilities_1.refineAttribution)(row, ctx);
+    const ends = ENDPOINTS[row.type];
+    if (!ends.from(row.from) || !ends.to(row.to)) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['type'], message: `${row.type} joins ${ends.reads}` });
+    }
+    if (row.from === row.to) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['to'], message: 'a relation joins two different nodes' });
+    }
+});
+exports.OwnerRegistrationSchema = zod_1.z
+    .object({
+    owner: zod_1.z.string().regex(ids_1.OWNER_LOGIN, 'a GitHub login'),
+    hub: zod_1.z.string().min(3),
+    source: zod_1.z.string().min(1).optional(),
+    holder: zod_1.z.string().min(1).optional(),
+    registeredBy: zod_1.z.string().min(1),
+    registeredAt: capabilities_1.TimestampSchema,
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    if (row.hub !== `${row.owner}/${row.owner}`) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['hub'], message: `an owner hub is <owner>/<owner>: ${row.owner}/${row.owner}` });
+    }
+});
+exports.MappingManifestSchema = zod_1.z
+    .object({
+    schema: zod_1.z.literal(types_1.MAPPING_SCHEMA),
+    version: zod_1.z.literal(1),
+    owner: zod_1.z.string().regex(ids_1.OWNER_LOGIN, 'a GitHub login'),
+    hub: zod_1.z.string().min(3),
+    kind: zod_1.z.enum(['owner', 'meta']),
+    description: zod_1.z.string().min(1).optional(),
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    if (row.hub !== `${row.owner}/${row.owner}`) {
+        ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, path: ['hub'], message: `an owner hub is <owner>/<owner>: ${row.owner}/${row.owner}` });
+    }
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/summary.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Counts a person reads first, and the capability claims of a whole mapping.
+ */
+import { type CapabilityClaim, type RevisionState, type SharedCapability, type StatementStatus } from '@medicine-wheel/capabilities';
+import { type ActivityThresholds, type LifecycleReading } from './lifecycle';
+import type { Lifecycle, LifecycleDrift, RepositoryMapping } from './types';
+/**
+ * Every claim a mapping makes on a capability: a capability's own
+ * `providedBy`, each feature that realizes one — through its `realizes` field
+ * or a `realizes` relation — claimed for the feature's repository, and each
+ * `provides` relation.
+ */
+export declare function mappingCapabilityClaims(mapping: RepositoryMapping): CapabilityClaim[];
+export interface MappingSummary {
+    repositories: number;
+    features: number;
+    capabilities: number;
+    relations: number;
+    owners: number;
+    byLifecycle: Record<Lifecycle, number>;
+    byDrift: Record<LifecycleDrift, number>;
+    byRevision: Record<RevisionState, number>;
+    /** Of repository purposes. */
+    byStatus: Record<StatementStatus, number>;
+    /** research-field id → repositories aligned with it. */
+    fields: Record<string, number>;
+    shared: SharedCapability[];
+    readings: LifecycleReading[];
+}
+export declare function summarize(mapping: RepositoryMapping, thresholds?: ActivityThresholds): MappingSummary;
+//# sourceMappingURL=summary.d.ts.map

package/dist/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA2C,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAarF;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,GAAE,kBAAwC,GACnD,cAAc,CAgChB"}