@skastr0/pulsar-core 0.1.0

package/dist/presets.js

@@ -0,0 +1,52 @@
+import { Effect } from "effect";
+import { decodePulsarVector } from "./vector.js";
+import aiSlopDefensePreset from "../presets/ai-slop-defense.json" with { type: "json" };
+import domainPuristPreset from "../presets/domain-purist.json" with { type: "json" };
+import refactorFriendlyPreset from "../presets/refactor-friendly.json" with { type: "json" };
+import securityParanoidPreset from "../presets/security-paranoid.json" with { type: "json" };
+import strictTypeSafetyPreset from "../presets/strict-type-safety.json" with { type: "json" };
+import velocityFirstPreset from "../presets/velocity-first.json" with { type: "json" };
+const SHIPPED_PRESETS = [
+    aiSlopDefensePreset,
+    domainPuristPreset,
+    refactorFriendlyPreset,
+    securityParanoidPreset,
+    strictTypeSafetyPreset,
+    velocityFirstPreset,
+];
+export const loadPulsarVectorPresets = () => Effect.gen(function* () {
+    const presets = yield* Effect.forEach(SHIPPED_PRESETS, (preset) => decodePulsarVector(preset).pipe(Effect.mapError(asError)));
+    const seen = new Set();
+    for (const preset of presets) {
+        if (seen.has(preset.id)) {
+            return yield* Effect.fail(new Error(`Duplicate preset id: ${preset.id}`));
+        }
+        seen.add(preset.id);
+    }
+    return [...presets].sort((left, right) => left.id.localeCompare(right.id));
+});
+const asError = (cause) => cause instanceof Error ? cause : new Error(String(cause));
+export const loadPulsarVectorPresetById = (presetId) => Effect.gen(function* () {
+    const presets = yield* loadPulsarVectorPresets();
+    const preset = presets.find((candidate) => candidate.id === presetId);
+    if (preset === undefined) {
+        return yield* Effect.fail(new Error(`Unknown persona preset: ${presetId}`));
+    }
+    return preset;
+});
+export const summarizePulsarVectorPresets = (presets) => [...presets]
+    .map((preset) => ({
+    id: preset.id,
+    description: oneLineDescription(preset),
+}))
+    .sort((left, right) => left.id.localeCompare(right.id));
+export const oneLineDescription = (vector) => {
+    const trimmed = vector.description?.trim();
+    if (trimmed === undefined || trimmed.length === 0)
+        return "No description provided.";
+    const line = trimmed.split(/\r?\n/, 1)[0]?.trim();
+    if (line === undefined || line.length === 0)
+        return trimmed;
+    return line;
+};
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

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

package/dist/reference-data-loader.d.ts

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import { ReferenceDataLoadFailed } from "./errors.js";
+export declare const CANONICAL_GLOSSARY_RELATIVE_PATH: ".pulsar/glossary.json";
+export declare const CANONICAL_CONVENTIONS_RELATIVE_PATH: ".pulsar/conventions.json";
+export declare const loadCanonicalReferenceDataEntries: (repoRoot: string) => Effect.Effect<ReadonlyMap<string, unknown>, ReferenceDataLoadFailed, never>;
+//# sourceMappingURL=reference-data-loader.d.ts.map

package/dist/reference-data-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data-loader.d.ts","sourceRoot":"","sources":["../src/reference-data-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAGrD,eAAO,MAAM,gCAAgC,EAAG,uBAAgC,CAAA;AAChF,eAAO,MAAM,mCAAmC,EAAG,0BAAmC,CAAA;AAmBtF,eAAO,MAAM,iCAAiC,GAC5C,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,EAAE,KAAK,CAwCzE,CAAA"}

package/dist/reference-data-loader.js

@@ -0,0 +1,53 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Effect } from "effect";
+import { decodeSchemaConventions } from "./conventions.js";
+import { ReferenceDataLoadFailed } from "./errors.js";
+import { decodeGlossary } from "./glossary.js";
+export const CANONICAL_GLOSSARY_RELATIVE_PATH = ".pulsar/glossary.json";
+export const CANONICAL_CONVENTIONS_RELATIVE_PATH = ".pulsar/conventions.json";
+const REFERENCE_DATA_SPECS = [
+    {
+        key: "glossary",
+        relativePath: CANONICAL_GLOSSARY_RELATIVE_PATH,
+        decode: decodeGlossary,
+    },
+    {
+        key: "schema-conventions",
+        relativePath: CANONICAL_CONVENTIONS_RELATIVE_PATH,
+        decode: decodeSchemaConventions,
+    },
+];
+export const loadCanonicalReferenceDataEntries = (repoRoot) => Effect.gen(function* () {
+    const entries = new Map();
+    for (const spec of REFERENCE_DATA_SPECS) {
+        const absolutePath = join(repoRoot, spec.relativePath);
+        if (!existsSync(absolutePath))
+            continue;
+        const raw = yield* Effect.tryPromise({
+            try: () => readFile(absolutePath, "utf8"),
+            catch: (cause) => new ReferenceDataLoadFailed({
+                repoPath: repoRoot,
+                path: absolutePath,
+                message: `Failed to read reference data: ${String(cause)}`,
+            }),
+        });
+        const parsed = yield* Effect.try({
+            try: () => JSON.parse(raw),
+            catch: (cause) => new ReferenceDataLoadFailed({
+                repoPath: repoRoot,
+                path: absolutePath,
+                message: `Failed to parse reference data JSON: ${String(cause)}`,
+            }),
+        });
+        const decoded = yield* Effect.mapError(spec.decode(parsed), (cause) => new ReferenceDataLoadFailed({
+            repoPath: repoRoot,
+            path: absolutePath,
+            message: `Failed to decode ${spec.key}: ${String(cause)}`,
+        }));
+        entries.set(spec.key, decoded);
+    }
+    return entries;
+});
+//# sourceMappingURL=reference-data-loader.js.map

package/dist/reference-data-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data-loader.js","sourceRoot":"","sources":["../src/reference-data-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAgC,CAAA;AAChF,MAAM,CAAC,MAAM,mCAAmC,GAAG,0BAAmC,CAAA;AAEtF,MAAM,oBAAoB,GAIrB;IACH;QACE,GAAG,EAAE,UAAU;QACf,YAAY,EAAE,gCAAgC;QAC9C,MAAM,EAAE,cAAc;KACvB;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,mCAAmC;QACjD,MAAM,EAAE,uBAAuB;KAChC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,QAAgB,EAC6D,EAAE,CAC/E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAE1C,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAQ;QAEvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACnC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;YACzC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,uBAAuB,CAAC;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC3D,CAAC;SACL,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YAC/B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,uBAAuB,CAAC;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,wCAAwC,MAAM,CAAC,KAAK,CAAC,EAAE;aACjE,CAAC;SACL,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CACpE,IAAI,uBAAuB,CAAC;YAC1B,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,oBAAoB,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE;SAC1D,CAAC,CACH,CAAA;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,OAAO,OAAuC,CAAA;AAChD,CAAC,CAAC,CAAA"}

package/dist/reference-data.d.ts

@@ -0,0 +1,6 @@
+export { computeDiagnosticHash, type Diagnostic, } from "./diagnostic.js";
+export { decodeGlossaryDraftSync, decodeGlossarySync, type CanonicalGlossaryTerm, type Glossary, type GlossaryDraft, type GlossaryIdentifierKind, type GlossaryProvenance, } from "./glossary.js";
+export { decodeSchemaConventionsSync, type BoundaryConvention, type NamingConventions, type SchemaConventions, } from "./conventions.js";
+export { CANONICAL_CONVENTIONS_RELATIVE_PATH, CANONICAL_GLOSSARY_RELATIVE_PATH, loadCanonicalReferenceDataEntries, } from "./reference-data-loader.js";
+export { ReferenceDataTag, makeReferenceData, type ReferenceData, } from "./context.js";
+//# sourceMappingURL=reference-data.d.ts.map

package/dist/reference-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data.d.ts","sourceRoot":"","sources":["../src/reference-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,2BAA2B,EAC3B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,mCAAmC,EACnC,gCAAgC,EAChC,iCAAiC,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA"}

package/dist/reference-data.js

@@ -0,0 +1,6 @@
+export { computeDiagnosticHash, } from "./diagnostic.js";
+export { decodeGlossaryDraftSync, decodeGlossarySync, } from "./glossary.js";
+export { decodeSchemaConventionsSync, } from "./conventions.js";
+export { CANONICAL_CONVENTIONS_RELATIVE_PATH, CANONICAL_GLOSSARY_RELATIVE_PATH, loadCanonicalReferenceDataEntries, } from "./reference-data-loader.js";
+export { ReferenceDataTag, makeReferenceData, } from "./context.js";
+//# sourceMappingURL=reference-data.js.map

package/dist/reference-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-data.js","sourceRoot":"","sources":["../src/reference-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GAMnB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,2BAA2B,GAI5B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,mCAAmC,EACnC,gCAAgC,EAChC,iCAAiC,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,cAAc,CAAA"}

package/dist/registry.d.ts

@@ -0,0 +1,16 @@
+import { Effect } from "effect";
+import { type RegistryError } from "./errors.js";
+import type { AnySignal, ResolvedSignal } from "./signal.js";
+export interface Registry {
+    /**
+     * Lookup table for canonical IDs and accepted aliases. Iteration over
+     * executable signals should use `sorted`, which contains each signal once.
+     */
+    readonly byId: ReadonlyMap<string, ResolvedSignal>;
+    readonly sorted: ReadonlyArray<ResolvedSignal>;
+    readonly has: (id: string) => boolean;
+    readonly canonicalIdOf: (id: string) => string | undefined;
+    readonly aliasesOf: (id: string) => ReadonlyArray<string>;
+}
+export declare const buildRegistry: (signals: ReadonlyArray<AnySignal>) => Effect.Effect<Registry, RegistryError>;
+//# 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,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAA;AAExC,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAA;AAI5E,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC9C,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,CAAC,MAAM,CAAC,CAAA;CAC1D;AAoJD,eAAO,MAAM,aAAa,GACxB,SAAS,aAAa,CAAC,SAAS,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAkCpC,CAAA"}

package/dist/registry.js

@@ -0,0 +1,174 @@
+import { Context, Effect } from "effect";
+import { deriveEnforcement } from "./enforcement.js";
+import { CompositionTooDeepError, CycleDetectedError, DuplicateSignalIdError, MissingDependencyError, } from "./errors.js";
+const MAX_COMPOSITION_DEPTH = 2;
+class RegistryTag extends Context.Tag("@skastr0/pulsar-core/Registry")() {
+}
+const validateNoDuplicates = (signals) => Effect.gen(function* () {
+    const seen = new Map();
+    for (const s of signals) {
+        for (const id of signalIdentifiers(s)) {
+            const existing = seen.get(id);
+            if (existing !== undefined && existing !== s) {
+                return yield* new DuplicateSignalIdError({ id });
+            }
+            seen.set(id, s);
+        }
+    }
+});
+const normalizeSignals = (signals) => Effect.gen(function* () {
+    const canonicalById = new Map();
+    const ownerByIdentifier = new Map();
+    const normalized = [];
+    for (const signal of signals) {
+        const existing = canonicalById.get(signal.id);
+        if (existing === undefined) {
+            for (const id of signalIdentifiers(signal)) {
+                const owner = ownerByIdentifier.get(id);
+                if (owner !== undefined && owner !== signal) {
+                    return yield* new DuplicateSignalIdError({ id });
+                }
+                ownerByIdentifier.set(id, signal);
+            }
+            canonicalById.set(signal.id, signal);
+            normalized.push(signal);
+            continue;
+        }
+        if (existing === signal)
+            continue;
+        return yield* new DuplicateSignalIdError({ id: signal.id });
+    }
+    return normalized;
+});
+const validateDependenciesExist = (signals) => Effect.gen(function* () {
+    const ids = new Set(signals.flatMap(signalIdentifiers));
+    for (const s of signals) {
+        for (const input of s.inputs) {
+            if (!ids.has(input.id) && input.optional !== true) {
+                return yield* new MissingDependencyError({
+                    signalId: s.id,
+                    missingInputId: input.id,
+                });
+            }
+        }
+    }
+});
+/**
+ * Kahn topological sort. Returns nodes in dependency order (leaves first).
+ * Fails with CycleDetectedError if a cycle exists.
+ */
+const topologicalSort = (signals) => Effect.gen(function* () {
+    const byId = new Map(signals.map((s) => [s.id, s]));
+    const canonicalByIdentifier = buildCanonicalIdentifierMap(signals);
+    const indegree = new Map();
+    const dependents = new Map();
+    for (const s of signals) {
+        const presentInputs = s.inputs
+            .map((input) => canonicalByIdentifier.get(input.id))
+            .filter((id) => id !== undefined);
+        indegree.set(s.id, presentInputs.length);
+        for (const inputId of presentInputs) {
+            const list = dependents.get(inputId) ?? [];
+            list.push(s.id);
+            dependents.set(inputId, list);
+        }
+    }
+    const queue = [];
+    for (const [id, deg] of indegree)
+        if (deg === 0)
+            queue.push(id);
+    const sorted = [];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        const node = byId.get(id);
+        if (node !== undefined)
+            sorted.push(node);
+        for (const dep of dependents.get(id) ?? []) {
+            const next = (indegree.get(dep) ?? 0) - 1;
+            indegree.set(dep, next);
+            if (next === 0)
+                queue.push(dep);
+        }
+    }
+    if (sorted.length !== signals.length) {
+        const unresolved = signals.filter((s) => !sorted.includes(s)).map((s) => s.id);
+        return yield* new CycleDetectedError({ chain: unresolved });
+    }
+    return sorted;
+});
+const validateCompositionDepth = (sorted) => Effect.gen(function* () {
+    const depths = new Map();
+    const canonicalByIdentifier = buildCanonicalIdentifierMap(sorted);
+    for (const s of sorted) {
+        if (s.inputs.length === 0) {
+            depths.set(s.id, 1);
+            continue;
+        }
+        let maxInputDepth = 0;
+        for (const input of s.inputs) {
+            const inputId = canonicalByIdentifier.get(input.id);
+            if (inputId === undefined || !depths.has(inputId))
+                continue;
+            const d = depths.get(inputId) ?? 1;
+            if (d > maxInputDepth)
+                maxInputDepth = d;
+        }
+        const depth = 1 + maxInputDepth;
+        if (depth > MAX_COMPOSITION_DEPTH) {
+            return yield* new CompositionTooDeepError({
+                signalId: s.id,
+                depth,
+                max: MAX_COMPOSITION_DEPTH,
+            });
+        }
+        depths.set(s.id, depth);
+    }
+    return depths;
+});
+export const buildRegistry = (signals) => Effect.gen(function* () {
+    const normalized = yield* normalizeSignals(signals);
+    yield* validateNoDuplicates(normalized);
+    yield* validateDependenciesExist(normalized);
+    const sorted = yield* topologicalSort(normalized);
+    yield* validateCompositionDepth(sorted);
+    const canonicalByIdentifier = buildCanonicalIdentifierMap(sorted);
+    const resolved = sorted.map((s) => ({
+        ...s,
+        inputs: normalizeInputs(s.inputs, canonicalByIdentifier),
+        enforcement: deriveEnforcement(s.tier, s.kind),
+    }));
+    const byId = new Map();
+    for (const signal of resolved) {
+        for (const id of signalIdentifiers(signal)) {
+            byId.set(id, signal);
+        }
+    }
+    const aliasesByCanonical = new Map(resolved.map((signal) => [signal.id, [...new Set(signal.aliases ?? [])]]));
+    return {
+        byId,
+        sorted: resolved,
+        has: (id) => byId.has(id),
+        canonicalIdOf: (id) => byId.get(id)?.id,
+        aliasesOf: (id) => {
+            const canonical = byId.get(id)?.id ?? id;
+            return aliasesByCanonical.get(canonical) ?? [];
+        },
+    };
+});
+const signalIdentifiers = (signal) => [signal.id, ...(signal.aliases ?? [])];
+const buildCanonicalIdentifierMap = (signals) => {
+    const map = new Map();
+    for (const signal of signals) {
+        for (const id of signalIdentifiers(signal)) {
+            map.set(id, signal.id);
+        }
+    }
+    return map;
+};
+const normalizeInputs = (inputs, canonicalByIdentifier) => inputs.map((input) => {
+    const canonical = canonicalByIdentifier.get(input.id);
+    if (canonical === undefined || canonical === input.id)
+        return input;
+    return { ...input, id: canonical };
+});
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/review-plan.d.ts

@@ -0,0 +1,30 @@
+import { Schema } from "effect";
+import type { ObserverOutput } from "./observer.js";
+import type { RoutingOutput } from "./routing.js";
+import { type PulsarVector } from "./vector.js";
+export declare const ReviewPlan: Schema.Struct<{
+    planId: typeof Schema.String;
+    sha: typeof Schema.String;
+    generatedAt: typeof Schema.String;
+    reviewRequests: Schema.Array$<Schema.Struct<{
+        reviewerRole: typeof Schema.String;
+        reason: typeof Schema.String;
+        priority: Schema.Literal<["block", "required", "informational"]>;
+        trigger: Schema.Struct<{
+            source: Schema.Literal<["hard-gate", "score-threshold", "structural-pattern"]>;
+            detail: typeof Schema.String;
+        }>;
+        context: Schema.Array$<Schema.Struct<{
+            kind: Schema.Literal<["signal-output", "file-excerpt", "diagnostic", "diff-hunk"]>;
+            content: typeof Schema.Unknown;
+        }>>;
+    }>>;
+    hardGateBlocking: typeof Schema.Boolean;
+}>;
+export type ReviewPlan = typeof ReviewPlan.Type;
+export declare const generateReviewPlan: (observerOutput: ObserverOutput, routingOutput: RoutingOutput, vector?: PulsarVector, options?: {
+    readonly generatedAt?: string;
+    readonly sha?: string;
+    readonly contextLimitBytes?: number;
+}) => ReviewPlan;
+//# sourceMappingURL=review-plan.d.ts.map

package/dist/review-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan.d.ts","sourceRoot":"","sources":["../src/review-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AA0BlE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;EAMrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAiB/C,eAAO,MAAM,kBAAkB,GAC7B,gBAAgB,cAAc,EAC9B,eAAe,aAAa,EAC5B,SAAS,YAAY,EACrB,UAAU;IACR,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC,KACA,UAkBF,CAAA"}

package/dist/review-plan.js

@@ -0,0 +1,235 @@
+import { createHash } from "node:crypto";
+import { Schema } from "effect";
+import { CATEGORIES } from "./category.js";
+import { dedupeByKey } from "./dedupe-by-key.js";
+import { reviewThresholdOf } from "./vector.js";
+const ReviewPriority = Schema.Literal("block", "required", "informational");
+const ReviewTrigger = Schema.Struct({
+    source: Schema.Literal("hard-gate", "score-threshold", "structural-pattern"),
+    detail: Schema.String,
+});
+const ContextItem = Schema.Struct({
+    kind: Schema.Literal("signal-output", "file-excerpt", "diagnostic", "diff-hunk"),
+    content: Schema.Unknown,
+});
+const ReviewRequest = Schema.Struct({
+    reviewerRole: Schema.String,
+    reason: Schema.String,
+    priority: ReviewPriority,
+    trigger: ReviewTrigger,
+    context: Schema.Array(ContextItem),
+});
+export const ReviewPlan = Schema.Struct({
+    planId: Schema.String,
+    sha: Schema.String,
+    generatedAt: Schema.String,
+    reviewRequests: Schema.Array(ReviewRequest),
+    hardGateBlocking: Schema.Boolean,
+});
+const DEFAULT_CATEGORY_REVIEWERS = {
+    "architectural-drift": "contract-reviewer",
+    "dependency-entropy": "supply-chain-reviewer",
+    "abstraction-bloat": "api-design-reviewer",
+    "legibility-decay": "simplicity-reviewer",
+    "generated-slop": "consolidation-reviewer",
+    "review-pain": "verification-reviewer",
+};
+const PRIORITY_RANK = {
+    informational: 0,
+    required: 1,
+    block: 2,
+};
+export const generateReviewPlan = (observerOutput, routingOutput, vector, options) => {
+    const generatedAt = options?.generatedAt ?? new Date().toISOString();
+    const sha = options?.sha ?? "unknown";
+    const contextLimitBytes = options?.contextLimitBytes ?? 20 * 1024;
+    const requests = [
+        ...hardGateReviewRequests(observerOutput),
+        ...scoreThresholdReviewRequests(observerOutput, vector),
+        ...structuralPatternReviewRequests(routingOutput),
+    ];
+    const reviewRequests = [...mergeRequests(requests, contextLimitBytes)].sort(compareRequests);
+    return {
+        planId: createPlanId(sha, generatedAt, reviewRequests),
+        sha,
+        generatedAt,
+        reviewRequests,
+        hardGateBlocking: reviewRequests.some((request) => request.priority === "block"),
+    };
+};
+const hardGateReviewRequests = (observerOutput) => observerOutput.hard_gate_violations.map((violation) => ({
+    reviewerRole: DEFAULT_CATEGORY_REVIEWERS[violation.category],
+    reason: `Hard gate violation in ${humanizeCategory(violation.category)}`,
+    priority: "block",
+    trigger: {
+        source: "hard-gate",
+        detail: `${violation.signalId}: ${violation.diagnostic.message}`,
+    },
+    context: compactContext([
+        {
+            kind: "diagnostic",
+            content: serialize({
+                signalId: violation.signalId,
+                category: violation.category,
+                diagnostic: violation.diagnostic,
+            }),
+        },
+        signalContextItem(observerOutput, violation.signalId),
+    ]),
+}));
+const scoreThresholdReviewRequests = (observerOutput, vector) => CATEGORIES.flatMap((category) => {
+    const categoryOutput = observerOutput.categories[category];
+    const reviewerRole = DEFAULT_CATEGORY_REVIEWERS[category];
+    const threshold = reviewThresholdOf(reviewerRole, vector, 0.6);
+    if (categoryOutput.score >= threshold)
+        return [];
+    return [
+        {
+            reviewerRole,
+            reason: `${humanizeCategory(category)} score fell below review threshold`,
+            priority: "required",
+            trigger: {
+                source: "score-threshold",
+                detail: `${category} scored ${categoryOutput.score.toFixed(2)} below threshold ${threshold.toFixed(2)}`,
+            },
+            context: compactContext([
+                {
+                    kind: "diagnostic",
+                    content: {
+                        category,
+                        score: categoryOutput.score,
+                        threshold,
+                        activeSignalIds: [...categoryOutput.activeSignalIds],
+                    },
+                },
+                ...categoryContext(observerOutput, categoryOutput.activeSignalIds),
+            ]),
+        },
+    ];
+});
+const structuralPatternReviewRequests = (routingOutput) => routingOutput.triggers.map((trigger) => ({
+    reviewerRole: trigger.reviewerRole,
+    reason: humanizePatternId(trigger.patternId),
+    priority: "required",
+    trigger: {
+        source: "structural-pattern",
+        detail: `Matched structural pattern ${trigger.patternId}`,
+    },
+    context: compactContext([
+        {
+            kind: "signal-output",
+            content: serialize(trigger.contextPayload),
+        },
+        {
+            kind: "diff-hunk",
+            content: serialize({ sourceLocations: trigger.sourceLocations }),
+        },
+    ]),
+}));
+const mergeRequests = (requests, contextLimitBytes) => {
+    const merged = new Map();
+    for (const request of requests) {
+        const existing = merged.get(request.reviewerRole);
+        if (existing === undefined) {
+            merged.set(request.reviewerRole, truncateContext(request, contextLimitBytes));
+            continue;
+        }
+        const priority = PRIORITY_RANK[request.priority] > PRIORITY_RANK[existing.priority]
+            ? request.priority
+            : existing.priority;
+        const trigger = PRIORITY_RANK[request.priority] > PRIORITY_RANK[existing.priority]
+            ? request.trigger
+            : existing.trigger;
+        const mergedRequest = {
+            reviewerRole: request.reviewerRole,
+            reason: mergeText(existing.reason, request.reason),
+            priority,
+            trigger: {
+                source: trigger.source,
+                detail: mergeText(existing.trigger.detail, request.trigger.detail),
+            },
+            context: dedupeContext([...existing.context, ...request.context]),
+        };
+        merged.set(request.reviewerRole, truncateContext(mergedRequest, contextLimitBytes));
+    }
+    return [...merged.values()];
+};
+const truncateContext = (request, contextLimitBytes) => {
+    if (byteLength(request.context) <= contextLimitBytes)
+        return request;
+    const truncated = [];
+    for (const item of request.context) {
+        const next = [...truncated, item];
+        if (byteLength(next) > contextLimitBytes)
+            break;
+        truncated.push(item);
+    }
+    truncated.push({
+        kind: "diagnostic",
+        content: {
+            note: "Context truncated to fit review-plan size budget",
+            fullArtifactPath: `pulsar-state:review-plans/${request.reviewerRole}.full-context.json`,
+        },
+    });
+    return {
+        ...request,
+        context: truncated,
+    };
+};
+const byteLength = (value) => Buffer.byteLength(JSON.stringify(value), "utf8");
+const categoryContext = (observerOutput, signalIds) => signalIds
+    .map((signalId) => signalContextItem(observerOutput, signalId))
+    .filter((item) => item !== undefined);
+const signalContextItem = (observerOutput, signalId) => {
+    const signal = observerOutput.signalResults.get(signalId);
+    if (signal === undefined)
+        return undefined;
+    return {
+        kind: "signal-output",
+        content: serialize({
+            signalId,
+            score: signal.score,
+            diagnostics: signal.diagnostics,
+            output: signal.output,
+        }),
+    };
+};
+const dedupeContext = (items) => dedupeByKey(items, (item) => `${item.kind}:${JSON.stringify(item.content)}`);
+const compareRequests = (left, right) => {
+    if (PRIORITY_RANK[left.priority] !== PRIORITY_RANK[right.priority]) {
+        return PRIORITY_RANK[right.priority] - PRIORITY_RANK[left.priority];
+    }
+    return left.reviewerRole.localeCompare(right.reviewerRole);
+};
+const mergeText = (left, right) => left === right ? left : `${left}; ${right}`;
+const createPlanId = (sha, generatedAt, requests) => {
+    const hash = createHash("sha256");
+    hash.update(JSON.stringify({ sha, generatedAt, requests }));
+    return `review-plan-${hash.digest("hex").slice(0, 12)}`;
+};
+const humanizeDashWords = (value) => value
+    .split("-")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+const humanizeCategory = (category) => humanizeDashWords(category);
+const humanizePatternId = (patternId) => humanizeDashWords(patternId);
+const compactContext = (items) => items.filter((item) => item !== undefined);
+const serialize = (value) => {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(serialize);
+    if (value instanceof Map) {
+        return Object.fromEntries([...value.entries()].map(([key, entry]) => [key, serialize(entry)]));
+    }
+    if (value instanceof Set)
+        return [...value.values()].map(serialize);
+    if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, serialize(entry)]));
+    }
+    return String(value);
+};
+//# sourceMappingURL=review-plan.js.map