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

package/dist/summary.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Counts a person reads first, and the capability claims of a whole mapping.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mappingCapabilityClaims = mappingCapabilityClaims;
+exports.summarize = summarize;
+const capabilities_1 = require("@medicine-wheel/capabilities");
+const ids_1 = require("./ids");
+const lifecycle_1 = require("./lifecycle");
+/**
+ * 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.
+ */
+function mappingCapabilityClaims(mapping) {
+    const realized = [
+        ...mapping.features.flatMap((f) => (f.realizes ? [{ feature: f.nodeId, capability: f.realizes }] : [])),
+        ...mapping.relations.filter((r) => r.type === 'realizes').map((r) => ({ feature: r.from, capability: r.to })),
+    ];
+    return [
+        ...(0, capabilities_1.capabilityClaims)(mapping.capabilities),
+        ...realized.flatMap(({ feature, capability }) => {
+            const provider = (0, ids_1.featureRepository)(feature);
+            return provider ? [{ capability, provider, via: feature }] : [];
+        }),
+        ...mapping.relations.filter((r) => r.type === 'provides').map((r) => ({ capability: r.to, provider: r.from })),
+    ];
+}
+function summarize(mapping, thresholds = lifecycle_1.ACTIVITY_THRESHOLDS) {
+    const byLifecycle = { unclassified: 0, prototype: 0, implementation: 0, maintained: 0, archived: 0 };
+    const byDrift = { converged: 0, drifted: 0, unobserved: 0, undeclared: 0 };
+    const byRevision = { pending: 0, revised: 0, affirmed: 0 };
+    const byStatus = { clear: 0, unclear: 0, undefinable: 0, 'needs-resolution': 0 };
+    const fields = {};
+    const readings = mapping.repositories.map((r) => (0, lifecycle_1.reconcileLifecycle)(r, thresholds));
+    for (const r of mapping.repositories) {
+        byLifecycle[r.lifecycle] += 1;
+        byStatus[r.status] += 1;
+        for (const f of r.fields)
+            fields[f] = (fields[f] ?? 0) + 1;
+    }
+    for (const reading of readings)
+        byDrift[reading.drift] += 1;
+    for (const row of [...mapping.repositories, ...mapping.features, ...mapping.capabilities, ...mapping.relations]) {
+        byRevision[row.revision] += 1;
+    }
+    return {
+        repositories: mapping.repositories.length,
+        features: mapping.features.length,
+        capabilities: mapping.capabilities.length,
+        relations: mapping.relations.length,
+        owners: mapping.owners.length,
+        byLifecycle,
+        byDrift,
+        byRevision,
+        byStatus,
+        fields,
+        shared: (0, capabilities_1.findSharedCapabilities)(mappingCapabilityClaims(mapping)),
+        readings,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Facet types for @medicine-wheel/developer-repository-mapping.
+ *
+ * A repository mapping is how an owner says what each of their repositories
+ * is: what it has done, what it might do, which fields of study it stands in,
+ * whether it is a prototype or something distributed and maintained, which
+ * features it holds and how it relates to the other repositories. It lives as
+ * JSONL in `<owner>/<owner>/.miadi/repository-mapping/` and is read by tools,
+ * not only by people.
+ *
+ * Relational here means kinship and accountability between repositories: a
+ * fork carries an obligation to where it came from, a prototype stays the
+ * place an intent was first seen after it grows into an implementation. The
+ * entity-relationship drawing in `rispecs/developer-suite/repository-mapping/`
+ * is how those relations are stored, not what they mean.
+ *
+ * Every row carries `Attribution` from `@medicine-wheel/capabilities`: who
+ * wrote it, when, from what evidence, and whether a person has read it since.
+ */
+import type { DeveloperRelation } from '@medicine-wheel/ontology-core';
+import type { Attribution, CapabilityFacet, NodeId, StatementStatus } from '@medicine-wheel/capabilities';
+/**
+ * What kind of thing a repository is, as its owner's mapping declares it.
+ *
+ * - `unclassified` — not read yet.
+ * - `prototype` — explores an intent; its value is what it shows, not that it runs.
+ * - `implementation` — a concrete build of an intent, not (yet) distributed.
+ * - `maintained` — distributed (npm, PyPI, apt, a deployed service) and kept current.
+ * - `archived` — ended by its owner.
+ *
+ * How recently anyone committed is a separate reading ({@link ActivityClass}),
+ * observed from git, never declared.
+ */
+export type Lifecycle = 'unclassified' | 'prototype' | 'implementation' | 'maintained' | 'archived';
+/**
+ * The events that move a repository between lifecycle states.
+ *
+ * `concretize` is the move from what a prototype explored to a concrete
+ * implementation **in the same repository**. When the intent continues in a
+ * different repository, the prototype keeps its state and a `grew-into`
+ * relation names where it went.
+ */
+export type LifecycleEvent = 'explore' | 'implement' | 'concretize' | 'release' | 'archive' | 'reopen';
+/** Whose hands a repository is in. */
+export type Origin = 'own' | 'agent' | 'community-fork';
+/**
+ * How recently a repository was committed to, relative to when it was read.
+ * `empty` — no commits at all on the branch read.
+ */
+export type ActivityClass = 'active' | 'quiet' | 'dormant' | 'empty';
+/**
+ * A declared lifecycle compared with what git shows.
+ *
+ * - `converged` — the declaration and the reading agree.
+ * - `drifted` — they disagree: 'maintained' with no commit in a year, 'archived' with commits this season.
+ * - `unobserved` — declared, never read from git.
+ * - `undeclared` — read from git, never classified.
+ *
+ * The comparison is the one `@medicine-wheel/infra`'s `reconcile` makes for
+ * machines. The type is not reused: `unrealized` reads wrong for a repository
+ * that simply has not been read yet.
+ */
+export type LifecycleDrift = 'converged' | 'drifted' | 'unobserved' | 'undeclared';
+/**
+ * A reading of a repository's git history, taken at a moment, by someone.
+ * Commits are counted on the branch that was checked out.
+ */
+export interface ActivityReading {
+    observedBy: string;
+    /** ISO 8601. Also the reference time `classifyActivity` measures from. */
+    observedAt: string;
+    commits: number;
+    commitsLast90Days: number;
+    firstCommitAt?: string;
+    lastCommitAt?: string;
+    tags: number;
+    branch?: string;
+    head?: string;
+}
+/** A repository. Annotates a `RelationalNode` of type `'knowledge'` (`metadata.kind: 'repository'`). */
+export interface RepositoryFacet extends Attribution {
+    /** `repository:<owner>/<name>` */
+    nodeId: NodeId;
+    origin: Origin;
+    lifecycle: Lifecycle;
+    /** What it is and has done. At most 55 words. Required when `status` is `clear` or `unclear`. */
+    purpose?: string;
+    /** What it might do. At most 55 words. */
+    horizon?: string;
+    /** The status of `purpose`. */
+    status: StatementStatus;
+    /** `research-field:<slug>` node ids. */
+    fields: NodeId[];
+    /** `prototype:<slug>` node ids — the Miadi prototype seam's nodes, which hold the public and editing addresses. */
+    prototypes: NodeId[];
+    /** The `human` or `agent` node of whoever holds it, when the wheel knows them. */
+    holder?: NodeId;
+    /** The latest git reading. */
+    observed?: ActivityReading;
+}
+/** A feature observed in one repository. Annotates a `knowledge` node (`metadata.kind: 'feature'`). */
+export interface FeatureFacet extends Attribution {
+    /** `feature:<owner>/<name>#<slug>` */
+    nodeId: NodeId;
+    /** → `RepositoryFacet.nodeId` */
+    repository: NodeId;
+    name: string;
+    /** At most 55 words. Required when `status` is `clear` or `unclear`. */
+    statement?: string;
+    status: StatementStatus;
+    /** → `CapabilityFacet.nodeId` */
+    realizes?: NodeId;
+}
+/** The relation names a mapping may write. */
+export type DeveloperEdgeName = DeveloperRelation['relationship_type'];
+/** One relation between two nodes of a mapping (or of another owner's). */
+export interface RelationRow extends Attribution {
+    from: NodeId;
+    to: NodeId;
+    type: DeveloperEdgeName;
+    /** Why the two are related. At most 55 words. */
+    description?: string;
+}
+/** An owner hub a meta hub reads from. Only a `meta` manifest has these. */
+export interface OwnerRegistration {
+    /** GitHub login: 'miadisabelle' */
+    owner: string;
+    /** '<owner>/<owner>' */
+    hub: string;
+    /**
+     * Where the hub's mapping folder is read from: a local path (relative to the
+     * meta hub's mapping folder) or an https URL of the folder. Absent means
+     * GitHub, `https://raw.githubusercontent.com/<hub>/HEAD/.miadi/repository-mapping/`.
+     */
+    source?: string;
+    /** The `human` or `agent` node of the owner, when the wheel knows them. */
+    holder?: NodeId;
+    registeredBy: string;
+    registeredAt: string;
+}
+/** `manifest.json` — what a mapping folder is. */
+export interface MappingManifest {
+    schema: 'medicine-wheel/repository-mapping';
+    version: 1;
+    owner: string;
+    /** '<owner>/<owner>' */
+    hub: string;
+    /** `owner` maps its owner's repositories. `meta` does that too, and reads the hubs it registers. */
+    kind: 'owner' | 'meta';
+    description?: string;
+}
+/** One mapping folder, read. */
+export interface RepositoryMapping {
+    manifest: MappingManifest;
+    repositories: RepositoryFacet[];
+    features: FeatureFacet[];
+    capabilities: CapabilityFacet[];
+    relations: RelationRow[];
+    owners: OwnerRegistration[];
+}
+/** Something a reader of a mapping should know: an error stops a writer, a warning does not. */
+export interface MappingIssue {
+    severity: 'error' | 'warning';
+    /** The file the row is in, or the hub it came from. */
+    file?: string;
+    /** 1-based line in a JSONL file. */
+    line?: number;
+    nodeId?: string;
+    message: string;
+}
+/** Where a mapping folder sits inside an owner hub. */
+export declare const MAPPING_DIR = ".miadi/repository-mapping";
+export declare const MAPPING_FILES: {
+    readonly manifest: "manifest.json";
+    readonly repositories: "repositories.jsonl";
+    readonly features: "features.jsonl";
+    readonly capabilities: "capabilities.jsonl";
+    readonly relations: "relations.jsonl";
+    readonly owners: "owners.jsonl";
+};
+export declare const MAPPING_SCHEMA: "medicine-wheel/repository-mapping";
+/** How many features a prototype is read for: its three core ones. */
+export declare const PROTOTYPE_CORE_FEATURES = 3;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Facet types for @medicine-wheel/developer-repository-mapping.
+ *
+ * A repository mapping is how an owner says what each of their repositories
+ * is: what it has done, what it might do, which fields of study it stands in,
+ * whether it is a prototype or something distributed and maintained, which
+ * features it holds and how it relates to the other repositories. It lives as
+ * JSONL in `<owner>/<owner>/.miadi/repository-mapping/` and is read by tools,
+ * not only by people.
+ *
+ * Relational here means kinship and accountability between repositories: a
+ * fork carries an obligation to where it came from, a prototype stays the
+ * place an intent was first seen after it grows into an implementation. The
+ * entity-relationship drawing in `rispecs/developer-suite/repository-mapping/`
+ * is how those relations are stored, not what they mean.
+ *
+ * Every row carries `Attribution` from `@medicine-wheel/capabilities`: who
+ * wrote it, when, from what evidence, and whether a person has read it since.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOTYPE_CORE_FEATURES = exports.MAPPING_SCHEMA = exports.MAPPING_FILES = exports.MAPPING_DIR = void 0;
+/** Where a mapping folder sits inside an owner hub. */
+exports.MAPPING_DIR = '.miadi/repository-mapping';
+exports.MAPPING_FILES = {
+    manifest: 'manifest.json',
+    repositories: 'repositories.jsonl',
+    features: 'features.jsonl',
+    capabilities: 'capabilities.jsonl',
+    relations: 'relations.jsonl',
+    owners: 'owners.jsonl',
+};
+exports.MAPPING_SCHEMA = 'medicine-wheel/repository-mapping';
+/** How many features a prototype is read for: its three core ones. */
+exports.PROTOTYPE_CORE_FEATURES = 3;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AA6KH,uDAAuD;AAC1C,QAAA,WAAW,GAAG,2BAA2B,CAAC;AAE1C,QAAA,aAAa,GAAG;IAC3B,QAAQ,EAAE,eAAe;IACzB,YAAY,EAAE,oBAAoB;IAClC,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,oBAAoB;IAClC,SAAS,EAAE,iBAAiB;IAC5B,MAAM,EAAE,cAAc;CACd,CAAC;AAEE,QAAA,cAAc,GAAG,mCAA4C,CAAC;AAE3E,sEAAsE;AACzD,QAAA,uBAAuB,GAAG,CAAC,CAAC"}

package/dist/wheel.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A mapping as the wheel holds it: `RelationalNode`s riding `knowledge` with
+ * `metadata.kind`, and `RelationalEdge`s named from the governed kinship
+ * vocabulary. Pure; writing them into a wheel is the caller's act.
+ *
+ * Edge identity is the directional `from:to` pair, as the wheel's storage
+ * reads it. When two relations join the same pair in the same direction, the
+ * first one is kept.
+ */
+import { type RelationalEdge, type RelationalNode } from '@medicine-wheel/ontology-core';
+import type { RepositoryMapping } from './types';
+export declare function toWheelNodes(mapping: RepositoryMapping): RelationalNode[];
+export declare function toWheelEdges(mapping: RepositoryMapping): RelationalEdge[];
+//# sourceMappingURL=wheel.d.ts.map

package/dist/wheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel.d.ts","sourceRoot":"","sources":["../src/wheel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoBjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CASzE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CA8BzE"}

package/dist/wheel.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * A mapping as the wheel holds it: `RelationalNode`s riding `knowledge` with
+ * `metadata.kind`, and `RelationalEdge`s named from the governed kinship
+ * vocabulary. Pure; writing them into a wheel is the caller's act.
+ *
+ * Edge identity is the directional `from:to` pair, as the wheel's storage
+ * reads it. When two relations join the same pair in the same direction, the
+ * first one is kept.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWheelNodes = toWheelNodes;
+exports.toWheelEdges = toWheelEdges;
+const ontology_core_1 = require("@medicine-wheel/ontology-core");
+const ids_1 = require("./ids");
+function node(kind, row, name) {
+    const { nodeId, ...facet } = row;
+    const { nodeType, direction } = ontology_core_1.DEVELOPER_ENTITY_BINDING[kind];
+    return {
+        id: nodeId,
+        name,
+        type: nodeType,
+        ...(direction ? { direction } : {}),
+        metadata: { kind, ...facet },
+        created_at: row.statedAt,
+        updated_at: row.revisedAt ?? row.statedAt,
+    };
+}
+function toWheelNodes(mapping) {
+    return [
+        ...mapping.repositories.map((r) => {
+            const repo = (0, ids_1.parseRepositoryNodeId)(r.nodeId);
+            return node('repository', r, repo ? `${repo.owner}/${repo.name}` : r.nodeId);
+        }),
+        ...mapping.features.map((f) => node('feature', f, f.name)),
+        ...mapping.capabilities.map((c) => node('capability', c, c.name)),
+    ];
+}
+function toWheelEdges(mapping) {
+    const edges = new Map();
+    const add = (from, to, type, created, description) => {
+        const id = `${from}:${to}`;
+        if (edges.has(id))
+            return;
+        edges.set(id, {
+            id,
+            from_id: from,
+            to_id: to,
+            relationship_type: type,
+            strength: 1,
+            ceremony_honored: false,
+            obligations: [...((0, ontology_core_1.getKinshipEdgeType)(type)?.defaultObligations ?? [])],
+            ...(description ? { description } : {}),
+            created_at: created,
+        });
+    };
+    for (const rel of mapping.relations)
+        add(rel.from, rel.to, rel.type, rel.statedAt, rel.description);
+    for (const f of mapping.features) {
+        add(f.nodeId, f.repository, 'part-of', f.statedAt);
+        if (f.realizes)
+            add(f.nodeId, f.realizes, 'realizes', f.statedAt);
+    }
+    for (const c of mapping.capabilities) {
+        for (const provider of c.providedBy)
+            add(provider, c.nodeId, 'provides', c.statedAt);
+    }
+    for (const r of mapping.repositories) {
+        for (const field of r.fields)
+            add(r.nodeId, field, 'field-aligns-with', r.statedAt);
+    }
+    return [...edges.values()];
+}
+//# sourceMappingURL=wheel.js.map

package/dist/wheel.js.map

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

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@medicine-wheel/developer-repository-mapping",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.22.0",
+  "description": "Repository mapping for the Medicine Wheel Developer Suite — owner hubs of JSONL rows in <owner>/<owner>/.miadi/repository-mapping/, a lifecycle state machine checked against git, a meta mapping that reads other hubs without copying them, the projection into wheel nodes and edges, and the mw-repomap CLI with a small web page",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mw-repomap": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.js",
+      "default": "./dist/node/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "repository-mapping",
+    "developer-suite",
+    "inventory",
+    "relational-ontology",
+    "jsonl",
+    "prototype",
+    "miadi"
+  ],
+  "author": "IAIP Collaborative - Shawinigan, QC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jgwill/medicine-wheel.git",
+    "directory": "src/developer-repository-mapping"
+  },
+  "engines": {
+    "node": ">=19"
+  },
+  "dependencies": {
+    "@medicine-wheel/capabilities": "^0.22.0",
+    "@medicine-wheel/ontology-core": "^0.22.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}