@memberjunction/standards 0.0.0 → 6.1.0-edge.0

package/dist/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview The standards registry.
+ *
+ * Adding a check here makes it **available**, not active. No repo's result changes until a human
+ * adopts it — that is the property that lets this package ship new standards continuously instead
+ * of in scary batches.
+ *
+ * @module @memberjunction/standards
+ */
+import type { StandardCheck } from './types.js';
+/**
+ * Every registered standard.
+ *
+ * **Adding a check:** append it with a `Since` equal to the MJ version it will ship in. Never
+ * backdate `Since` — that would silently activate the check in repos that adopted before it
+ * existed, which is exactly what this design prevents.
+ *
+ * **Removing a check:** don't, without a deprecation cycle. A repo whose config names a check that
+ * no longer exists gets an "unknown check" warning rather than a silent no-op, so removal is
+ * visible — but it is still a breaking change for anyone whose CI names it.
+ */
+export declare const STANDARD_CHECKS: readonly StandardCheck[];
+/** Look up a check by its config key. */
+export declare function GetCheck(id: string): StandardCheck | undefined;
+/** All registered check ids, sorted — used by `adopt` and by unknown-key reporting. */
+export declare function AllCheckIds(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAAoB,CAAC;AAEzE,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE9D;AAED,uFAAuF;AACvF,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}

package/dist/registry.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview The standards registry.
+ *
+ * Adding a check here makes it **available**, not active. No repo's result changes until a human
+ * adopts it — that is the property that lets this package ship new standards continuously instead
+ * of in scary batches.
+ *
+ * @module @memberjunction/standards
+ */
+import { UILayersCheck } from './checks/ui-layers.js';
+/**
+ * Every registered standard.
+ *
+ * **Adding a check:** append it with a `Since` equal to the MJ version it will ship in. Never
+ * backdate `Since` — that would silently activate the check in repos that adopted before it
+ * existed, which is exactly what this design prevents.
+ *
+ * **Removing a check:** don't, without a deprecation cycle. A repo whose config names a check that
+ * no longer exists gets an "unknown check" warning rather than a silent no-op, so removal is
+ * visible — but it is still a breaking change for anyone whose CI names it.
+ */
+export const STANDARD_CHECKS = [UILayersCheck];
+/** Look up a check by its config key. */
+export function GetCheck(id) {
+    return STANDARD_CHECKS.find((c) => c.Id === id);
+}
+/** All registered check ids, sorted — used by `adopt` and by unknown-key reporting. */
+export function AllCheckIds() {
+    return STANDARD_CHECKS.map((c) => c.Id).sort();
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,aAAa,CAAC,CAAC;AAEzE,yCAAyC;AACzC,MAAM,UAAU,QAAQ,CAAC,EAAU;IAC/B,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW;IACvB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Running the adopted standards and formatting the result.
+ *
+ * @module @memberjunction/standards
+ */
+import type { RunSummary, StandardsConfig } from './types.js';
+/**
+ * Run every standard this repo has adopted.
+ *
+ * **Only adopted checks run.** A registered check absent from the config is reported as available
+ * and not executed — which is what makes it safe to add standards to this package at any time.
+ * A check present but `off` is likewise not executed, but is not reported as available either:
+ * the repo has seen it and said no.
+ */
+export declare function RunStandards(repoRoot: string, config: StandardsConfig): Promise<RunSummary>;
+/**
+ * Render a run for a terminal.
+ *
+ * Every failing check prints its docs URL. A rule whose reasoning is one search away gets followed;
+ * one that just says "no" gets worked around.
+ */
+export declare function FormatSummary(summary: RunSummary, config: StandardsConfig): string;
+/** Exit code for a run: non-zero only for `error`-severity violations. */
+export declare function ExitCodeFor(summary: RunSummary): number;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAgB,UAAU,EAAE,eAAe,EAAa,MAAM,YAAY,CAAC;AAGvF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAmCjG;AAOD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CA4ClF;AAID,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAEvD"}

package/dist/runner.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Running the adopted standards and formatting the result.
+ *
+ * @module @memberjunction/standards
+ */
+import { GetCheck, STANDARD_CHECKS } from './registry.js';
+import { IsNewerThan } from './version.js';
+/**
+ * Run every standard this repo has adopted.
+ *
+ * **Only adopted checks run.** A registered check absent from the config is reported as available
+ * and not executed — which is what makes it safe to add standards to this package at any time.
+ * A check present but `off` is likewise not executed, but is not reported as available either:
+ * the repo has seen it and said no.
+ */
+export async function RunStandards(repoRoot, config) {
+    const outcomes = [];
+    const unknownCheckIds = [];
+    for (const [id, entry] of Object.entries(config.Checks)) {
+        const check = GetCheck(id);
+        if (!check) {
+            // Named but unregistered: a typo, or a standard removed from the package. Either way
+            // the repo believes it is enforcing something it is not, so say so out loud.
+            unknownCheckIds.push(id);
+            continue;
+        }
+        if (entry.Severity === 'off')
+            continue;
+        const roots = entry.Roots ?? config.Roots ?? check.DefaultRoots;
+        const options = { ...(check.DefaultOptions ?? {}), ...(entry.Options ?? {}) };
+        const result = await check.Run({ RepoRoot: repoRoot, Roots: roots, Options: options });
+        outcomes.push({
+            Check: check,
+            Severity: entry.Severity,
+            Violations: result.Violations,
+            Notes: result.Notes ?? [],
+        });
+    }
+    const available = STANDARD_CHECKS.filter((c) => !(c.Id in config.Checks)).map((Check) => ({
+        Check,
+        PostdatesAdoption: IsNewerThan(Check.Since, config.StandardsVersion),
+    }));
+    const errorCount = outcomes.filter((o) => o.Severity === 'error').reduce((n, o) => n + o.Violations.length, 0);
+    const warningCount = outcomes.filter((o) => o.Severity === 'warn').reduce((n, o) => n + o.Violations.length, 0);
+    return { Outcomes: outcomes, Available: available, UnknownCheckIds: unknownCheckIds, ErrorCount: errorCount, WarningCount: warningCount };
+}
+function formatViolation(v) {
+    const location = v.Line > 0 ? `${v.File}:${v.Line}` : v.File;
+    return `    ${location}  ${v.Message}`;
+}
+/**
+ * Render a run for a terminal.
+ *
+ * Every failing check prints its docs URL. A rule whose reasoning is one search away gets followed;
+ * one that just says "no" gets worked around.
+ */
+export function FormatSummary(summary, config) {
+    const lines = [];
+    for (const outcome of summary.Outcomes) {
+        const mark = outcome.Violations.length === 0 ? '✓' : outcome.Severity === 'error' ? '✗' : '!';
+        const label = outcome.Violations.length === 0 ? '' : ` — ${outcome.Violations.length} violation(s)`;
+        lines.push(`${mark} ${outcome.Check.Id} [${outcome.Severity}]${label}`);
+        for (const note of outcome.Notes)
+            lines.push(`    ${note}`);
+        for (const violation of outcome.Violations)
+            lines.push(formatViolation(violation));
+        if (outcome.Violations.length > 0)
+            lines.push(`    → ${outcome.Check.DocsUrl}`);
+    }
+    if (summary.UnknownCheckIds.length > 0) {
+        lines.push('');
+        lines.push(`! ${CONFIG_LABEL} names ${summary.UnknownCheckIds.length} check(s) this version does not know:`);
+        for (const id of summary.UnknownCheckIds)
+            lines.push(`    ${id}`);
+        lines.push('    They are NOT being enforced. Fix the name, or remove the entry.');
+    }
+    const newer = summary.Available.filter((a) => a.PostdatesAdoption);
+    const older = summary.Available.filter((a) => !a.PostdatesAdoption);
+    if (newer.length > 0) {
+        lines.push('');
+        lines.push(`${newer.length} standard(s) added since this repo adopted ${config.StandardsVersion}:`);
+        for (const { Check } of newer)
+            lines.push(`    ${Check.Id}  (since ${Check.Since})  ${Check.Title}`);
+        lines.push('    They are NOT active. Review with `mj standards adopt --upgrade`.');
+    }
+    if (older.length > 0) {
+        lines.push('');
+        lines.push(`${older.length} standard(s) available but not adopted:`);
+        for (const { Check } of older)
+            lines.push(`    ${Check.Id}  ${Check.Title}`);
+        lines.push('    Enable with `mj standards adopt --check <id>`.');
+    }
+    lines.push('');
+    if (summary.ErrorCount > 0) {
+        lines.push(`✗ ${summary.ErrorCount} error(s), ${summary.WarningCount} warning(s).`);
+    }
+    else if (summary.WarningCount > 0) {
+        lines.push(`✓ No errors. ${summary.WarningCount} warning(s) — not failing the build.`);
+    }
+    else {
+        lines.push('✓ All adopted standards pass.');
+    }
+    return lines.join('\n');
+}
+const CONFIG_LABEL = '.mj-standards.json';
+/** Exit code for a run: non-zero only for `error`-severity violations. */
+export function ExitCodeFor(summary) {
+    return summary.ErrorCount > 0 ? 1 : 0;
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview `adopt` — turn a repo that has never heard of MJ standards into one that enforces
+ * them, in a single command.
+ *
+ * The gap between "we published our standards" and "our standards are actually followed" is almost
+ * entirely setup friction. Every step below is something a team would otherwise have to read a
+ * guide to do, get slightly wrong, and then not notice for six months.
+ *
+ * Everything here is **idempotent and additive**. Re-running `adopt` on a configured repo reports
+ * what is already in place rather than overwriting it — in particular it never lowers a severity a
+ * repo has raised, and never rewrites a CI file a team has customized.
+ *
+ * @module @memberjunction/standards
+ */
+import type { StandardsConfig } from './types.js';
+/** One thing `adopt` did, or deliberately didn't. */
+export interface AdoptAction {
+    Kind: 'created' | 'updated' | 'skipped';
+    What: string;
+    Detail?: string;
+}
+export interface AdoptOptions {
+    RepoRoot: string;
+    /** The version being adopted against — normally the installed MJ/CLI version. */
+    Version: string;
+    /** Limit to these check ids. Empty means "every check at or below `Version`". */
+    OnlyChecks?: string[];
+    /**
+     * Review and enable standards newer than the repo's recorded `StandardsVersion`, and bump it.
+     * Without this, `adopt` on a configured repo leaves the version line alone — which is what
+     * makes upgrading the package safe.
+     */
+    Upgrade?: boolean;
+    /** Report what would happen, change nothing. */
+    DryRun?: boolean;
+    /** Also write a CI workflow. */
+    Ci?: 'github' | 'none';
+    /** Add an `mj:standards` npm script to package.json. */
+    AddNpmScript?: boolean;
+    /**
+     * Declare `mjUILayer` on packages that already comply.
+     *
+     * Without this, a fresh adoption produces a config that enforces nothing — every package is
+     * undeclared, so every package is skipped, and the repo gets a green check that means nothing.
+     * Declaring the already-clean packages is what makes the first run honest.
+     */
+    DeclareCompliant?: boolean;
+}
+export interface AdoptResult {
+    Actions: AdoptAction[];
+    Config: StandardsConfig;
+}
+/** Adopt (or re-adopt) MJ standards in a repo. */
+export declare function Adopt(options: AdoptOptions): AdoptResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAA8B,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9E,qDAAqD;AACrD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;CAC3B;AAgED,kDAAkD;AAClD,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAiExD"}

package/dist/scaffold.js

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview `adopt` — turn a repo that has never heard of MJ standards into one that enforces
+ * them, in a single command.
+ *
+ * The gap between "we published our standards" and "our standards are actually followed" is almost
+ * entirely setup friction. Every step below is something a team would otherwise have to read a
+ * guide to do, get slightly wrong, and then not notice for six months.
+ *
+ * Everything here is **idempotent and additive**. Re-running `adopt` on a configured repo reports
+ * what is already in place rather than overwriting it — in particular it never lowers a severity a
+ * repo has raised, and never rewrites a CI file a team has customized.
+ *
+ * @module @memberjunction/standards
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { LoadConfig, SaveConfig, HasConfig } from './config.js';
+import { GetCheck, STANDARD_CHECKS } from './registry.js';
+import { DeclareLayer, ProbeUndeclaredPackages } from './checks/ui-layers.js';
+import { IsNewerThan } from './version.js';
+/** Which checks a fresh adoption should enable: everything at or below the adopted version. */
+function checksForVersion(version, only) {
+    const candidates = only?.length
+        ? only.map((id) => GetCheck(id)).filter((c) => !!c)
+        : STANDARD_CHECKS.filter((c) => !IsNewerThan(c.Since, version));
+    return [...candidates];
+}
+/**
+ * Enable a check in a config, without ever weakening what is already there.
+ *
+ * A repo that has raised `ui-layers` to `error` and turned on `requireDeclared` must not have that
+ * undone by someone re-running `adopt` — the command's job is to get repos started, not to reset
+ * them to the defaults.
+ */
+function mergeCheck(existing, check) {
+    if (existing)
+        return { Entry: existing, Changed: false };
+    return {
+        Entry: {
+            Severity: check.DefaultSeverity,
+            Roots: check.DefaultRoots,
+            ...(check.DefaultOptions ? { Options: { ...check.DefaultOptions } } : {}),
+        },
+        Changed: true,
+    };
+}
+const GITHUB_WORKFLOW_PATH = '.github/workflows/mj-standards.yml';
+const GITHUB_WORKFLOW = `name: MJ standards
+
+# Generated by \`mj standards adopt\`. Safe to edit — this file is never overwritten once it exists.
+#
+# What runs is decided by .mj-standards.json, NOT by this file. Adding a standard to
+# @memberjunction/standards does not change this workflow's result until someone runs
+# \`mj standards adopt --upgrade\` and commits the config change.
+
+on:
+  pull_request:
+  push:
+    branches: [next, main]
+
+concurrency:
+  group: mj-standards-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  standards:
+    name: MJ standards
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - name: Check adopted standards
+        run: npx mj standards check
+`;
+/** Adopt (or re-adopt) MJ standards in a repo. */
+export function Adopt(options) {
+    const actions = [];
+    const { RepoRoot, Version, DryRun } = options;
+    const existing = HasConfig(RepoRoot) ? LoadConfig(RepoRoot) : null;
+    const config = existing ?? { StandardsVersion: Version, Checks: {} };
+    // The version we select checks against. On a fresh adopt that is the installed version; on a
+    // re-run it stays at whatever the repo recorded, unless --upgrade says otherwise. This single
+    // line is what stops a package upgrade from activating new rules.
+    const selectionVersion = existing ? (options.Upgrade ? Version : existing.StandardsVersion) : Version;
+    for (const check of checksForVersion(selectionVersion, options.OnlyChecks)) {
+        const { Entry, Changed } = mergeCheck(config.Checks[check.Id], check);
+        config.Checks[check.Id] = Entry;
+        actions.push(Changed
+            ? { Kind: 'created', What: `check "${check.Id}"`, Detail: `severity ${Entry.Severity}, roots ${(Entry.Roots ?? []).join(', ')}` }
+            : { Kind: 'skipped', What: `check "${check.Id}"`, Detail: `already configured (severity ${Entry.Severity}) — left alone` });
+    }
+    if (options.Upgrade && existing && IsNewerThan(Version, existing.StandardsVersion)) {
+        config.StandardsVersion = Version;
+        actions.push({ Kind: 'updated', What: 'StandardsVersion', Detail: `${existing.StandardsVersion} → ${Version}` });
+    }
+    if (!DryRun)
+        SaveConfig(RepoRoot, config);
+    actions.push({ Kind: existing ? 'updated' : 'created', What: '.mj-standards.json' });
+    if (options.Ci === 'github') {
+        const path = join(RepoRoot, GITHUB_WORKFLOW_PATH);
+        if (existsSync(path)) {
+            actions.push({ Kind: 'skipped', What: GITHUB_WORKFLOW_PATH, Detail: 'already exists — not overwritten' });
+        }
+        else {
+            if (!DryRun) {
+                mkdirSync(dirname(path), { recursive: true });
+                writeFileSync(path, GITHUB_WORKFLOW, 'utf8');
+            }
+            actions.push({ Kind: 'created', What: GITHUB_WORKFLOW_PATH });
+        }
+    }
+    if (options.AddNpmScript) {
+        const path = join(RepoRoot, 'package.json');
+        if (!existsSync(path)) {
+            actions.push({ Kind: 'skipped', What: 'npm script', Detail: 'no package.json at the repo root' });
+        }
+        else {
+            const manifest = JSON.parse(readFileSync(path, 'utf8'));
+            manifest.scripts = manifest.scripts ?? {};
+            if (manifest.scripts['mj:standards']) {
+                actions.push({ Kind: 'skipped', What: 'npm script "mj:standards"', Detail: 'already defined — left alone' });
+            }
+            else {
+                manifest.scripts['mj:standards'] = 'mj standards check';
+                if (!DryRun)
+                    writeFileSync(path, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+                actions.push({ Kind: 'created', What: 'npm script "mj:standards"' });
+            }
+        }
+    }
+    if (options.DeclareCompliant) {
+        actions.push(...declareCompliantUILayers(config, RepoRoot, DryRun === true));
+    }
+    return { Actions: actions, Config: config };
+}
+/**
+ * Declare `mjUILayer` on undeclared packages that would pass.
+ *
+ * Takes the **strictest** layer each package qualifies for. `shell` is never auto-assigned: it
+ * checks nothing, so every package passes as `shell`, and assigning it would hand a permanent
+ * exemption to exactly the packages that need work. (An earlier version of this did assign it, and
+ * a two-package test repo caught it immediately — the deliberately non-compliant package came back
+ * declared `shell` and passing.)
+ *
+ * Packages that pass as nothing are reported, not declared. A declaration that immediately fails
+ * is a worse first impression than declaring fewer and saying plainly what is left.
+ */
+function declareCompliantUILayers(config, repoRoot, dryRun) {
+    const actions = [];
+    const entry = config.Checks['ui-layers'];
+    const check = GetCheck('ui-layers');
+    if (!entry || entry.Severity === 'off' || !check)
+        return actions;
+    const roots = entry.Roots ?? config.Roots ?? check.DefaultRoots;
+    const undeclared = ProbeUndeclaredPackages(repoRoot, roots);
+    if (undeclared.length === 0)
+        return actions;
+    for (const pkg of undeclared) {
+        const strictest = pkg.WouldPassAs[0];
+        if (!strictest) {
+            actions.push({
+                Kind: 'skipped',
+                What: `mjUILayer for ${pkg.Name}`,
+                Detail: 'violations at every auto-assignable layer — fix them, then declare it',
+            });
+            continue;
+        }
+        if (!dryRun)
+            DeclareLayer(pkg.Dir, strictest);
+        actions.push({ Kind: 'created', What: `mjUILayer for ${pkg.Name}`, Detail: strictest });
+    }
+    return actions;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @fileoverview The type model for MJ standards.
+ *
+ * The whole design turns on one requirement: **a new standard must never break an older repo's
+ * build.** Everything below exists to make that structurally true rather than a promise.
+ *
+ * @module @memberjunction/standards
+ */
+/**
+ * How loudly a check reports.
+ *
+ * - `off`   — registered but not run. The state every check is in until a repo opts in.
+ * - `warn`  — reported, exit code stays 0. What a newly-adopted check should be for one cycle.
+ * - `error` — reported, exit code 1.
+ */
+export type Severity = 'off' | 'warn' | 'error';
+/** One thing a check found wrong. */
+export interface Violation {
+    /** Repo-relative path of the offending file. */
+    File: string;
+    /** 1-based line, or 0 for a whole-file / manifest finding. */
+    Line: number;
+    /** What is wrong, and — always — what to do instead. */
+    Message: string;
+    /** The package the file belongs to, when the check knows it. */
+    Package?: string;
+}
+/** Everything a check is given to do its work. */
+export interface CheckContext {
+    /** Absolute path to the repository root. */
+    RepoRoot: string;
+    /** Roots to scan, repo-relative. Comes from the check's own config, falling back to the repo's. */
+    Roots: string[];
+    /** The check's own options block from `.mj-standards.json`, verbatim. */
+    Options: Readonly<Record<string, unknown>>;
+}
+/** What a check returns. */
+export interface CheckResult {
+    Violations: Violation[];
+    /**
+     * Things the check wants said that are not violations — "12 packages scanned, 3 skipped".
+     * Printed under the check's heading; never affects exit code.
+     */
+    Notes?: string[];
+}
+/**
+ * A standard, as registered.
+ *
+ * ## The version contract
+ *
+ * `Since` is the MJ version that introduced the check. A repo records the version it adopted
+ * against (`standardsVersion` in its config). Checks introduced *after* that version are reported
+ * as **available**, never enabled — so upgrading `@memberjunction/standards` can add rules without
+ * changing any repo's result until a human runs `mj standards adopt --upgrade`.
+ *
+ * `DefaultSeverity` is what `adopt` writes into a repo's config when it first enables the check.
+ * It is a starting point for new adopters, **not** a live value: changing it here never changes
+ * an already-adopted repo, because the repo's config holds its own severity.
+ *
+ * That asymmetry is the whole point. Severity can decay forward (`warn` → `error` on a major, by
+ * the repo's own choice) and never backward into a repo that has already shipped.
+ */
+export interface StandardCheck {
+    /** Stable, kebab-case identifier. Used as the config key — renaming one is a breaking change. */
+    Id: string;
+    /** One line, imperative: what the check enforces. */
+    Title: string;
+    /** MJ version that introduced this check, e.g. `'6.0.0'`. */
+    Since: string;
+    /** Severity `adopt` writes for a NEW adopter. Never applied to an already-configured repo. */
+    DefaultSeverity: Exclude<Severity, 'off'>;
+    /** Where the reasoning lives. Printed with every failure — a rule without a why gets ignored. */
+    DocsUrl: string;
+    /** Longer explanation, shown by `mj standards list`. */
+    Description: string;
+    /** Default roots to scan when the repo doesn't name any. */
+    DefaultRoots: string[];
+    /** Options `adopt` writes for a new adopter. */
+    DefaultOptions?: Record<string, unknown>;
+    /** Do the work. Must not throw for ordinary findings — return them as violations. */
+    Run(context: CheckContext): Promise<CheckResult> | CheckResult;
+}
+/** A single check's entry in `.mj-standards.json`. */
+export interface CheckConfig {
+    Severity: Severity;
+    /** Overrides the check's `DefaultRoots`. */
+    Roots?: string[];
+    /** Check-specific options. */
+    Options?: Record<string, unknown>;
+}
+/**
+ * `.mj-standards.json` — a repo's adoption record.
+ *
+ * Deliberately explicit rather than convention-driven: reading this file should tell you exactly
+ * which standards this repo has agreed to and how strictly, without knowing anything about the
+ * version of the tool that will read it.
+ */
+export interface StandardsConfig {
+    /** JSON-schema pointer, for editor completion. */
+    $schema?: string;
+    /**
+     * The MJ version this repo adopted standards against.
+     *
+     * Checks with a `Since` greater than this are reported as available and are NOT run. Bumping
+     * this is a deliberate act (`mj standards adopt --upgrade`), never a side effect of upgrading
+     * the package.
+     */
+    StandardsVersion: string;
+    /** Default roots for checks that don't name their own. */
+    Roots?: string[];
+    /** Per-check configuration. A check absent from this map does not run. */
+    Checks: Record<string, CheckConfig>;
+}
+/** One check's outcome, after severity is applied. */
+export interface CheckOutcome {
+    Check: StandardCheck;
+    Severity: Exclude<Severity, 'off'>;
+    Violations: Violation[];
+    Notes: string[];
+}
+/** The whole run. */
+export interface RunSummary {
+    Outcomes: CheckOutcome[];
+    /** Registered checks the repo has not adopted, and whether they postdate its adoption. */
+    Available: Array<{
+        Check: StandardCheck;
+        PostdatesAdoption: boolean;
+    }>;
+    /** Config keys that match no registered check — usually a typo or a removed standard. */
+    UnknownCheckIds: string[];
+    ErrorCount: number;
+    WarningCount: number;
+}
+//# 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":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACtB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IACzB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC1B,iGAAiG;IACjG,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1C,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,qFAAqF;IACrF,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;CAClE;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAqB;AACrB,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,0FAA0F;IAC1F,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvE,yFAAyF;IACzF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview The type model for MJ standards.
+ *
+ * The whole design turns on one requirement: **a new standard must never break an older repo's
+ * build.** Everything below exists to make that structurally true rather than a promise.
+ *
+ * @module @memberjunction/standards
+ */
+export {};
+//# 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;;;;;;;GAOG"}