@spikedpunch/align-cli 0.1.0

package/dist/commands/init.js

@@ -0,0 +1,93 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline/promises';
+import { defineProject } from '@spikedpunch/align-core/dsl';
+import { toComponentName } from '@spikedpunch/align-core';
+import { TypeScriptPlugin } from '@spikedpunch/align-plugin-typescript';
+import { detectComponents } from '../init/detect-components.js';
+import { suggestLayers } from '../init/suggest-layers.js';
+import { renderConfig } from '../init/render-config.js';
+import { writeAgentInstructions } from '../init/claude-md.js';
+import { writeGeneratedRulesNote } from '../init/config-comment.js';
+import { ensureTelemetryGitignored } from '../init/gitignore.js';
+import { createOrchestrator } from '../composition-root.js';
+import { CONFIG_FILENAME, loadConfig } from '../config.js';
+import { writeBaseline, ensureAlignDir } from '../align-dir.js';
+export async function runInit(rootDir, options) {
+    const configPath = path.join(rootDir, CONFIG_FILENAME);
+    ensureAlignDir(rootDir);
+    if (!fs.existsSync(configPath)) {
+        const detected = detectComponents(rootDir);
+        console.log(`Detected ${detected.length} component(s): ${detected.map((c) => c.name).join(', ')}`);
+        // Scan once with components-only (no rules yet) to derive layer suggestions from real edges.
+        // `empty: 'allow'` here (not the default 'fail') so the probe scan never crashes on a
+        // greenfield repo before we've even had a chance to decide which components need the
+        // until-populated marker below — this is a throwaway probe ruleset, never written to disk.
+        const componentsInput = Object.fromEntries(detected.map((c) => [c.name, { pattern: c.pattern, empty: 'allow' }]));
+        const probeRuleset = defineProject({ components: componentsInput });
+        const plugin = new TypeScriptPlugin();
+        const graph = await plugin.scanner.scan({ rootDir, components: probeRuleset.components, excludes: [] });
+        const layers = suggestLayers(graph);
+        // R4: components matching zero files right now (or every component, under --greenfield) get
+        // `empty: 'until-populated'` instead of the default fail-on-empty — architecture-first
+        // authoring (rules declared before code) works out of the box instead of hitting
+        // `ComponentValidationError` on the very first `align check`.
+        const populatedNames = new Set(graph.nodes.map((n) => n.component));
+        const greenfieldComponents = new Set(detected.filter((c) => options.greenfield === true || !populatedNames.has(toComponentName(c.name))).map((c) => c.name));
+        fs.writeFileSync(configPath, renderConfig(detected, layers, greenfieldComponents), 'utf8');
+        console.log(`Wrote ${CONFIG_FILENAME} (cycles-first starter ruleset; ${layers.length} layer suggestion(s) commented out).`);
+        if (greenfieldComponents.size > 0) {
+            const reason = options.greenfield === true ? '--greenfield' : 'matched zero files';
+            console.log(`${greenfieldComponents.size} component(s) (${reason}) set to empty: 'until-populated' ` +
+                `(architecture-first authoring: rules load now, enforcement auto-arms once files land): ` +
+                `${[...greenfieldComponents].join(', ')}.`);
+        }
+    }
+    else {
+        console.log(`${CONFIG_FILENAME} already exists — leaving it as-is.`);
+    }
+    writeGeneratedRulesNote(configPath);
+    writeAgentInstructions(rootDir);
+    console.log('Wrote/updated CLAUDE.md agent-instructions block.');
+    if (ensureTelemetryGitignored(rootDir)) {
+        console.log('Wrote/updated .gitignore (excluded .align/telemetry.jsonl + .align/telemetry-state.json — opt-in, local-only).');
+    }
+    const { ruleset, excludes, hostRules } = await loadConfig(rootDir);
+    const { orchestrator } = createOrchestrator(ruleset, [], hostRules);
+    const run = await orchestrator.check({ rootDir, excludes });
+    const violations = run.gates.flatMap((g) => g.violations);
+    if (violations.length === 0) {
+        writeBaseline(rootDir, []);
+        console.log('Initial check is green — no baseline seeding needed.');
+        return 0;
+    }
+    const isInteractive = options.nonInteractive === true ? false : (options.nonInteractive ?? process.stdin.isTTY === true);
+    if (!options.acceptExisting && !isInteractive) {
+        console.log(`align check found ${violations.length} pre-existing violation(s). Re-run with --accept-existing to seed ` +
+            `the baseline non-interactively (silence is never consent — ADR 006), or run interactively to be prompted.`);
+        return 1;
+    }
+    let shouldSeed = options.acceptExisting;
+    if (!shouldSeed && isInteractive) {
+        console.log(`\nalign check found ${violations.length} pre-existing violation(s) — this is normal on a repo align hasn't seen before.`);
+        console.log('Seeding the baseline tolerates them as existing debt; run `align baseline show` any time to review what was seeded.');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question('Seed the baseline with these violations now? [y/N] ');
+        rl.close();
+        shouldSeed = /^y(es)?$/i.test(answer.trim());
+    }
+    if (!shouldSeed) {
+        console.log('Not seeding the baseline. `align check` will report red until you fix these or run `align baseline accept`.');
+        return 1;
+    }
+    writeBaseline(rootDir, violations.map((v) => ({
+        fingerprint: v.id,
+        ruleId: v.ruleId,
+        file: v.file,
+        acceptedAt: Date.now(),
+        acceptedBy: options.acceptExisting ? 'accept-existing' : 'init-seed',
+    })));
+    console.log(`Seeded baseline with ${violations.length} pre-existing violation(s) — run \`align baseline show\` to review.`);
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/skill.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+import { type SkillTopic } from '../skill/render.js';
+export type { SkillTopic };
+export interface SkillOptions {
+    readonly topic: SkillTopic;
+    readonly install: boolean;
+}
+/**
+ * `align skill` (Stage 5, IMPLEMENTATION_PLAN.md "Elevated first items"): emits the LLM-facing
+ * authoring/fixing guide, generated live from the installed binary's own registries so it cannot
+ * drift from what this specific install actually supports. `--install` additionally writes
+ * `.claude/skills/align/SKILL.md` into the target repo (cwd).
+ *
+ * `program` is the already-built `commander` tree the CLI command inventory section reads
+ * (`../program.js`'s `buildProgram()`'s own `program` closure variable, passed in by its `skill`
+ * action rather than re-imported here — see `skill/cli-inventory.ts`'s doc comment for why a
+ * static import back to `program.ts` would be a dependency cycle).
+ */
+export declare function runSkill(rootDir: string, options: SkillOptions, program: Command): Promise<number>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG1E,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAUxG"}

package/dist/commands/skill.js

@@ -0,0 +1,23 @@
+import { renderSkillMarkdown } from '../skill/render.js';
+import { writeSkillFile } from '../skill/install.js';
+/**
+ * `align skill` (Stage 5, IMPLEMENTATION_PLAN.md "Elevated first items"): emits the LLM-facing
+ * authoring/fixing guide, generated live from the installed binary's own registries so it cannot
+ * drift from what this specific install actually supports. `--install` additionally writes
+ * `.claude/skills/align/SKILL.md` into the target repo (cwd).
+ *
+ * `program` is the already-built `commander` tree the CLI command inventory section reads
+ * (`../program.js`'s `buildProgram()`'s own `program` closure variable, passed in by its `skill`
+ * action rather than re-imported here — see `skill/cli-inventory.ts`'s doc comment for why a
+ * static import back to `program.ts` would be a dependency cycle).
+ */
+export async function runSkill(rootDir, options, program) {
+    const markdown = renderSkillMarkdown(options.topic, program);
+    process.stdout.write(`${markdown}\n`);
+    if (options.install) {
+        const filePath = writeSkillFile(rootDir, program);
+        console.error(`Wrote ${filePath}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe,EAAE,OAAqB,EAAE,OAAgB;IACrF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IAEtC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/telemetry.d.ts

@@ -0,0 +1,52 @@
+export declare const DEFAULT_TELEMETRY_FILE = ".align/telemetry.jsonl";
+export interface TelemetryReportOptions {
+    readonly file?: string;
+    readonly json: boolean;
+}
+interface LatencyStats {
+    readonly count: number;
+    readonly p50?: number;
+    readonly p90?: number;
+    readonly p99?: number;
+}
+interface RuleFiringCount {
+    readonly ruleId: string;
+    readonly count: number;
+}
+interface TimeToGreen {
+    readonly ruleId: string;
+    readonly resolvedCount: number;
+    readonly avgMs: number;
+    readonly medianMs: number;
+}
+interface FrictionCount {
+    readonly errorKind: string;
+    readonly count: number;
+}
+interface SegmentLatency {
+    readonly key: string;
+    readonly checks: number;
+    readonly p50?: number;
+}
+export interface TelemetrySummary {
+    readonly totalEvents: number;
+    readonly skippedLines: number;
+    readonly checkLatencyMs: LatencyStats;
+    readonly topFiringRules: readonly RuleFiringCount[];
+    readonly timeToGreen: readonly TimeToGreen[];
+    readonly deadRules: readonly string[];
+    readonly baselineVsFix: {
+        readonly baselined: number;
+        readonly resolved: number;
+        readonly ratio?: number;
+    };
+    readonly friction: readonly FrictionCount[];
+    readonly segments: {
+        readonly bySession: readonly SegmentLatency[];
+        readonly byAlignVersion: readonly SegmentLatency[];
+    };
+}
+export declare function buildTelemetrySummary(rootDir: string, filePath: string): Promise<TelemetrySummary>;
+export declare function runTelemetryReport(rootDir: string, options: TelemetryReportOptions): Promise<number>;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/commands/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/commands/telemetry.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAoCD,UAAU,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAA;KAAE,CAAC;CAC1H;AAuDD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CxG;AAkFD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1G"}

package/dist/commands/telemetry.js

@@ -0,0 +1,238 @@
+/**
+ * `align telemetry` — turns the raw `.align/telemetry.jsonl` accretion into the report a
+ * human/coordinator actually reads (IMPLEMENTATION_PLAN.md's telemetry spec): check-latency
+ * percentiles, top-firing rules, time-to-green per rule, dead rules, baseline-vs-fix ratio, and
+ * friction ranking. Reads only — never writes telemetry.jsonl itself.
+ */
+import * as fs from 'node:fs';
+import { telemetryJsonlPath } from '../align-dir.js';
+import { loadConfig } from '../config.js';
+export const DEFAULT_TELEMETRY_FILE = '.align/telemetry.jsonl';
+/** Malformed lines (a hand-edited file, a truncated write from a crashed process) are skipped, not
+ * fatal — this is an analysis tool over an append-only log, not a schema boundary anything else
+ * depends on (unlike `.align/generated-rules.json`'s "corrupted is never absent" discipline). */
+function parseLines(raw) {
+    const envelopes = [];
+    let skipped = 0;
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed !== null && typeof parsed === 'object' && 'event' in parsed && 'command' in parsed) {
+                envelopes.push(parsed);
+            }
+            else {
+                skipped += 1;
+            }
+        }
+        catch {
+            skipped += 1;
+        }
+    }
+    return { envelopes, skipped };
+}
+function percentile(sortedAsc, p) {
+    if (sortedAsc.length === 0)
+        return undefined;
+    const idx = Math.min(sortedAsc.length - 1, Math.max(0, Math.ceil((p / 100) * sortedAsc.length) - 1));
+    return sortedAsc[idx];
+}
+function latencyStats(wallMsValues) {
+    const sorted = [...wallMsValues].sort((a, b) => a - b);
+    const p50 = percentile(sorted, 50);
+    const p90 = percentile(sorted, 90);
+    const p99 = percentile(sorted, 99);
+    return {
+        count: sorted.length,
+        ...(p50 !== undefined ? { p50 } : {}),
+        ...(p90 !== undefined ? { p90 } : {}),
+        ...(p99 !== undefined ? { p99 } : {}),
+    };
+}
+function median(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    const midValue = sorted[mid];
+    const midValueBefore = sorted[mid - 1];
+    if (midValue === undefined)
+        return 0;
+    return sorted.length % 2 === 0 && midValueBefore !== undefined ? (midValueBefore + midValue) / 2 : midValue;
+}
+function computeTimeToGreen(envelopes) {
+    // Processed in file order (append-only log — the order events were written IS the order they
+    // occurred) so an `appeared` is always seen before the `resolved` that closes it out.
+    const openByFingerprint = new Map();
+    const deltasByRule = new Map();
+    for (const env of envelopes) {
+        if (env.event.kind !== 'violation-appeared' && env.event.kind !== 'violation-resolved')
+            continue;
+        const event = env.event;
+        if (event.kind === 'violation-appeared') {
+            openByFingerprint.set(event.violationFingerprint, { ruleId: event.ruleId, ts: env.ts });
+            continue;
+        }
+        const opened = openByFingerprint.get(event.violationFingerprint);
+        if (opened === undefined)
+            continue; // resolved without a seen appear (pre-dates this telemetry log) — not measurable
+        openByFingerprint.delete(event.violationFingerprint);
+        const deltaMs = env.ts - opened.ts;
+        const list = deltasByRule.get(opened.ruleId);
+        if (list === undefined)
+            deltasByRule.set(opened.ruleId, [deltaMs]);
+        else
+            list.push(deltaMs);
+    }
+    return [...deltasByRule.entries()]
+        .map(([ruleId, deltas]) => ({
+        ruleId,
+        resolvedCount: deltas.length,
+        avgMs: deltas.reduce((a, b) => a + b, 0) / deltas.length,
+        medianMs: median(deltas),
+    }))
+        .sort((a, b) => b.resolvedCount - a.resolvedCount);
+}
+async function computeDeadRules(rootDir, firedRuleIds) {
+    try {
+        const { ruleset } = await loadConfig(rootDir);
+        return ruleset.rules.map((r) => r.id).filter((id) => !firedRuleIds.has(id));
+    }
+    catch {
+        // align.config.ts is unreadable/missing right now (e.g. summarizing a JSONL copied off a
+        // different checkout) — dead-rule analysis needs today's active ruleset to mean anything;
+        // every other section of the report is still computed from the log alone.
+        return [];
+    }
+}
+export async function buildTelemetrySummary(rootDir, filePath) {
+    const raw = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
+    const { envelopes, skipped } = parseLines(raw);
+    const checkWallMs = envelopes.filter((e) => e.event.kind === 'check').map((e) => e.event.wallMs);
+    const appearedCounts = new Map();
+    for (const e of envelopes) {
+        if (e.event.kind !== 'violation-appeared')
+            continue;
+        const ruleId = e.event.ruleId;
+        appearedCounts.set(ruleId, (appearedCounts.get(ruleId) ?? 0) + 1);
+    }
+    const topFiringRules = [...appearedCounts.entries()]
+        .map(([ruleId, count]) => ({ ruleId, count }))
+        .sort((a, b) => b.count - a.count);
+    const resolvedCount = envelopes.filter((e) => e.event.kind === 'violation-resolved').length;
+    const baselinedCount = envelopes
+        .filter((e) => e.event.kind === 'baseline' && e.event.action === 'accept')
+        .reduce((sum, e) => sum + (e.event.counts.accepted ?? 0), 0);
+    const frictionCounts = new Map();
+    for (const e of envelopes) {
+        if (e.event.kind !== 'error')
+            continue;
+        const kind = e.event.errorKind;
+        frictionCounts.set(kind, (frictionCounts.get(kind) ?? 0) + 1);
+    }
+    const friction = [...frictionCounts.entries()].map(([errorKind, count]) => ({ errorKind, count })).sort((a, b) => b.count - a.count);
+    const bySession = segmentLatency(envelopes, (e) => e.sessionId);
+    const byAlignVersion = segmentLatency(envelopes, (e) => e.alignVersion);
+    const total = baselinedCount + resolvedCount;
+    return {
+        totalEvents: envelopes.length,
+        skippedLines: skipped,
+        checkLatencyMs: latencyStats(checkWallMs),
+        topFiringRules,
+        timeToGreen: computeTimeToGreen(envelopes),
+        deadRules: await computeDeadRules(rootDir, new Set(appearedCounts.keys())),
+        baselineVsFix: { baselined: baselinedCount, resolved: resolvedCount, ...(total > 0 ? { ratio: baselinedCount / total } : {}) },
+        friction,
+        segments: { bySession, byAlignVersion },
+    };
+}
+function segmentLatency(envelopes, keyOf) {
+    const byKey = new Map();
+    for (const e of envelopes) {
+        if (e.event.kind !== 'check')
+            continue;
+        const key = keyOf(e);
+        const list = byKey.get(key);
+        const wallMs = e.event.wallMs;
+        if (list === undefined)
+            byKey.set(key, [wallMs]);
+        else
+            list.push(wallMs);
+    }
+    return [...byKey.entries()]
+        .map(([key, values]) => {
+        const sorted = [...values].sort((a, b) => a - b);
+        const p50 = percentile(sorted, 50);
+        return { key, checks: values.length, ...(p50 !== undefined ? { p50 } : {}) };
+    })
+        .sort((a, b) => b.checks - a.checks);
+}
+function fmtMs(ms) {
+    if (ms === undefined)
+        return 'n/a';
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function printHuman(summary) {
+    console.log(`align telemetry — ${summary.totalEvents} event(s) read${summary.skippedLines > 0 ? ` (${summary.skippedLines} malformed line(s) skipped)` : ''}`);
+    console.log('\ncheck latency:');
+    if (summary.checkLatencyMs.count === 0) {
+        console.log('  no check events recorded yet.');
+    }
+    else {
+        console.log(`  p50=${fmtMs(summary.checkLatencyMs.p50)}  p90=${fmtMs(summary.checkLatencyMs.p90)}  ` +
+            `p99=${fmtMs(summary.checkLatencyMs.p99)}  (n=${summary.checkLatencyMs.count})`);
+    }
+    console.log('\ntop-firing rules:');
+    if (summary.topFiringRules.length === 0) {
+        console.log('  none.');
+    }
+    else {
+        for (const r of summary.topFiringRules.slice(0, 20))
+            console.log(`  ${r.count.toString().padStart(4)}  ${r.ruleId}`);
+    }
+    console.log('\ntime-to-green per rule (appeared -> resolved):');
+    if (summary.timeToGreen.length === 0) {
+        console.log('  no appear->resolve transitions observed yet.');
+    }
+    else {
+        for (const t of summary.timeToGreen) {
+            console.log(`  ${t.ruleId}: avg=${fmtMs(t.avgMs)} median=${fmtMs(t.medianMs)} (n=${t.resolvedCount})`);
+        }
+    }
+    console.log('\ndead rules (in the active ruleset, never fired):');
+    console.log(summary.deadRules.length === 0 ? '  none.' : summary.deadRules.map((r) => `  ${r}`).join('\n'));
+    console.log('\nbaseline-vs-fix:');
+    console.log(`  baselined=${summary.baselineVsFix.baselined}  resolved(fixed)=${summary.baselineVsFix.resolved}` +
+        (summary.baselineVsFix.ratio !== undefined ? `  baseline-ratio=${(summary.baselineVsFix.ratio * 100).toFixed(0)}%` : ''));
+    console.log('\nfriction (error events by kind):');
+    if (summary.friction.length === 0) {
+        console.log('  none.');
+    }
+    else {
+        for (const f of summary.friction)
+            console.log(`  ${f.count.toString().padStart(4)}  ${f.errorKind}`);
+    }
+    if (summary.segments.bySession.length > 1) {
+        console.log('\nby session (check latency p50):');
+        for (const s of summary.segments.bySession)
+            console.log(`  ${s.key}: ${s.checks} check(s), p50=${fmtMs(s.p50)}`);
+    }
+    if (summary.segments.byAlignVersion.length > 1) {
+        console.log('\nby align version (check latency p50):');
+        for (const s of summary.segments.byAlignVersion)
+            console.log(`  ${s.key}: ${s.checks} check(s), p50=${fmtMs(s.p50)}`);
+    }
+}
+export async function runTelemetryReport(rootDir, options) {
+    const filePath = telemetryJsonlPath(rootDir, options.file);
+    const summary = await buildTelemetrySummary(rootDir, filePath);
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
+        return 0;
+    }
+    printHuman(summary);
+    return 0;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/commands/telemetry.js.map

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

package/dist/composition-root.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@spikedpunch/align-cli` is the composition root (ARCHITECTURE.md §5): the only package that imports a
+ * concrete `LanguagePlugin` and registers it. Core never imports `plugin-typescript` directly.
+ */
+import { GateOrchestrator, InMemoryBaselineStore, type BaselineEntry, type HostPredicateRegistry, type RulesetIR } from '@spikedpunch/align-core';
+/** `hostPredicates` defaults to empty so every existing caller keeps working unchanged; a real
+ * `align.config.ts` with a `hostRules` export flows its extracted registry (`config.ts`'s
+ * `LoadedConfig.hostRules`) in here — this is the one place align's CLI wires the config-side
+ * predicate functions into core's evaluator (docs/proposals/rule-expansion-evaluation.md §B.0). */
+export declare function createOrchestrator(ruleset: RulesetIR, baselineEntries: readonly BaselineEntry[], hostPredicates?: HostPredicateRegistry): {
+    readonly orchestrator: GateOrchestrator;
+    readonly baselineStore: InMemoryBaselineStore;
+};
+//# sourceMappingURL=composition-root.d.ts.map

package/dist/composition-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-root.d.ts","sourceRoot":"","sources":["../src/composition-root.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EAErB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAGjC;;;mGAGmG;AACnG,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,EAClB,eAAe,EAAE,SAAS,aAAa,EAAE,EACzC,cAAc,GAAE,qBAAiC,GAChD;IACD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;CAC/C,CAMA"}

package/dist/composition-root.js

@@ -0,0 +1,18 @@
+/**
+ * `@spikedpunch/align-cli` is the composition root (ARCHITECTURE.md §5): the only package that imports a
+ * concrete `LanguagePlugin` and registers it. Core never imports `plugin-typescript` directly.
+ */
+import { GateOrchestrator, InMemoryBaselineStore, StaticPluginRegistry, } from '@spikedpunch/align-core';
+import { NodeManifestScanner, TypeScriptPlugin } from '@spikedpunch/align-plugin-typescript';
+/** `hostPredicates` defaults to empty so every existing caller keeps working unchanged; a real
+ * `align.config.ts` with a `hostRules` export flows its extracted registry (`config.ts`'s
+ * `LoadedConfig.hostRules`) in here — this is the one place align's CLI wires the config-side
+ * predicate functions into core's evaluator (docs/proposals/rule-expansion-evaluation.md §B.0). */
+export function createOrchestrator(ruleset, baselineEntries, hostPredicates = new Map()) {
+    const registry = new StaticPluginRegistry([new TypeScriptPlugin()]);
+    const baselineStore = new InMemoryBaselineStore(baselineEntries);
+    const manifestScanner = new NodeManifestScanner();
+    const orchestrator = new GateOrchestrator(registry, ruleset, baselineStore, hostPredicates, manifestScanner);
+    return { orchestrator, baselineStore };
+}
+//# sourceMappingURL=composition-root.js.map

package/dist/composition-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-root.js","sourceRoot":"","sources":["../src/composition-root.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GAIrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7F;;;mGAGmG;AACnG,MAAM,UAAU,kBAAkB,CAChC,OAAkB,EAClB,eAAyC,EACzC,iBAAwC,IAAI,GAAG,EAAE;IAKjD,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,IAAI,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;IAC7G,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AACzC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+import { type HostPredicateRegistry, type RulesetIR } from '@spikedpunch/align-core';
+export interface LoadedConfig {
+    readonly ruleset: RulesetIR;
+    readonly excludes: readonly string[];
+    readonly hostRules: HostPredicateRegistry;
+    readonly telemetry?: boolean;
+}
+export interface LoadConfigOptions {
+    /** Merge `.align/generated-rules.json` into the loaded ruleset when present (ADR 011's
+     * config-integration mechanism — see `@spikedpunch/align-core`'s `mergeGeneratedRules`). Defaults to `true`
+     * so every existing surface (`check`, `doctor`, `mcp`) enforces doc-built rules automatically,
+     * with zero required edits to `align.config.ts`. `align build`'s own dry-run pipeline passes
+     * `false` to see the hand-authored ruleset in isolation, since it needs to diff the CURRENT
+     * on-disk generated rules against a freshly PROPOSED set, not a set that's already merged in. */
+    readonly includeGenerated?: boolean;
+}
+export declare const CONFIG_FILENAME = "align.config.ts";
+/**
+ * Loads `align.config.ts` from the repo root. Node 22+ strips TypeScript types natively on
+ * dynamic import of a `.ts` file (verified: no `tsx`/`jiti` dependency needed for erasable
+ * syntax) — align.config.ts is restricted to erasable TS (interfaces, type annotations; no
+ * enums/parameter-properties) precisely so this keeps working without a build step.
+ *
+ * ADR 011 config-integration mechanism: after loading the hand-authored ruleset, this merges in
+ * `.align/generated-rules.json` when present (`mergeGeneratedRules`, `@spikedpunch/align-core/build`) — the
+ * loader boundary was chosen over an explicit `withGeneratedRules()` call in every
+ * `align.config.ts` (or `defineProject` doing its own fs I/O) as the least-magical option that
+ * still requires zero human edits to the config file; see the Stage 3 final report.
+ */
+export declare function loadConfig(rootDir: string, options?: LoadConfigOptions): Promise<LoadedConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2C,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAG9H,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAK5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAOrC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAO1C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD,MAAM,WAAW,iBAAiB;IAChC;;;;;qGAKiG;IACjG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuBxG"}

package/dist/config.js

@@ -0,0 +1,39 @@
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { mergeGeneratedRules } from '@spikedpunch/align-core';
+import { readGeneratedRules } from './align-dir.js';
+function toHostPredicateRegistry(hostRules) {
+    return new Map(Object.entries(hostRules ?? {}));
+}
+export const CONFIG_FILENAME = 'align.config.ts';
+/**
+ * Loads `align.config.ts` from the repo root. Node 22+ strips TypeScript types natively on
+ * dynamic import of a `.ts` file (verified: no `tsx`/`jiti` dependency needed for erasable
+ * syntax) — align.config.ts is restricted to erasable TS (interfaces, type annotations; no
+ * enums/parameter-properties) precisely so this keeps working without a build step.
+ *
+ * ADR 011 config-integration mechanism: after loading the hand-authored ruleset, this merges in
+ * `.align/generated-rules.json` when present (`mergeGeneratedRules`, `@spikedpunch/align-core/build`) — the
+ * loader boundary was chosen over an explicit `withGeneratedRules()` call in every
+ * `align.config.ts` (or `defineProject` doing its own fs I/O) as the least-magical option that
+ * still requires zero human edits to the config file; see the Stage 3 final report.
+ */
+export async function loadConfig(rootDir, options = {}) {
+    const includeGenerated = options.includeGenerated ?? true;
+    const configPath = path.join(rootDir, CONFIG_FILENAME);
+    const mod = (await import(pathToFileURL(configPath).href));
+    if (mod.default === undefined) {
+        throw new Error(`${CONFIG_FILENAME} must have a default export (the result of defineProject(...)).`);
+    }
+    const excludes = mod.excludes ?? [];
+    const hostRules = toHostPredicateRegistry(mod.hostRules);
+    const telemetry = mod.telemetry !== undefined ? { telemetry: mod.telemetry } : {};
+    if (!includeGenerated)
+        return { ruleset: mod.default, excludes, hostRules, ...telemetry };
+    const generated = readGeneratedRules(rootDir);
+    if (generated === undefined)
+        return { ruleset: mod.default, excludes, hostRules, ...telemetry };
+    const mergedRules = mergeGeneratedRules(mod.default.rules, generated.rules);
+    return { ruleset: { ...mod.default, rules: [...mergedRules] }, excludes, hostRules, ...telemetry };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAkE,MAAM,yBAAyB,CAAC;AAC9H,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAyBpD,SAAS,uBAAuB,CAAC,SAAoD;IACnF,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAYD,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,UAA6B,EAAE;IAC/E,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAKxD,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,iEAAiE,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAElF,IAAI,CAAC,gBAAgB;QAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;IAE1F,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;IAEhG,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5E,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;AACrG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { buildProgram } from './program.js';
+await buildProgram().parseAsync(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,YAAY,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/init/claude-md.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Idempotent, HTML-comment-delimited write (ADR 009 consequence): re-running `align init` never
+ * duplicates or corrupts human-authored instructions around the block.
+ */
+export declare function writeAgentInstructions(rootDir: string, filename?: string): void;
+//# sourceMappingURL=claude-md.d.ts.map

package/dist/init/claude-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/init/claude-md.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAc,GAAG,IAAI,CAqBpF"}