@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/profiles.d.ts

@@ -0,0 +1,144 @@
+import { type ScanConfig } from "./reviewconfig.js";
+import type { EcosystemName } from "./ecosystem.js";
+import type { HeuristicsExtension } from "./heuristics.js";
+import type { PassAddendum } from "./include.js";
+import { type ProfilePlace } from "./profilelookup.js";
+import { type PostingPolicy } from "./postingpolicy.js";
+import { type LensTuning } from "./lenstuning.js";
+/** How a loader finds the profile. */
+export interface ProfileLookup {
+    /** The profile directories outside the checkout, searched first and in
+     * order: the install's, as src/homes.ts `homeProfileLookup` resolves them.
+     * Absent: the checkout's generic examples alone. */
+    homes?: readonly ProfilePlace[];
+    /** The repo profile's extracted directory (`extractRepoProfile`): a layer
+     * under the whole named chain, present even when no profile is named. */
+    repoProfile?: {
+        dir: string;
+    };
+}
+/** The name the repo profile's layer carries in errors. */
+export declare const REPO_LAYER_NAME = ".qcr";
+/** The selected profile's resolved `extends` chain, base first — name and
+ * directory of each layer (the setup's profile validate names what it
+ * checked). Same refusals as every loader: not found, base not found,
+ * cycle. `""` is no profile: an empty chain. */
+export declare function resolveProfileChain(root: string, profile: string, lookup?: ProfileLookup): Array<{
+    name: string;
+    dir: string;
+}>;
+/** Ids a pack may not claim: every compiled-in entry, plus the dynamic
+ * same-day feedback addendum wire.ts composes last (src/feedback.ts). */
+export declare function reservedAddendumIds(): Set<string>;
+/** Parse ONE addendum file's raw bytes. Throws (naming `file`) on anything
+ * malformed — the loud-failure contract. */
+export declare function parseProfileAddendum(file: string, raw: string): PassAddendum;
+/**
+ * Load the named profile's addenda pack — its whole `extends` chain merged —
+ * in composition order.
+ *
+ * Within one pack the order is ascending filename sort and nothing else;
+ * across a chain the base's entries come first, a child's entry with an
+ * inherited id takes that entry's PLACE (replace in place, so a child can
+ * reword a base rule without reordering the pack), and a new id appends.
+ * `[addenda] drop` removes inherited ids before the child's own pack merges,
+ * so dropping an id and defining it again moves it to the tail. A drop that
+ * names nothing inherited is refused — a built-in registry entry can never be
+ * dropped by a profile, and a typo must not silently read as a removal.
+ * Deterministic by construction, so a rebuild of an unchanged tree stays
+ * byte-identical, same contract as the compiled-in registry's declaration
+ * order. Every failure is a throw; the caller (wire.ts, at daemon assembly)
+ * is expected to let it crash the boot rather than review with a partial
+ * pack.
+ */
+export declare function loadProfileAddenda(root: string, profile: string, lookup?: ProfileLookup): PassAddendum[];
+/**
+ * The profile's ecosystem selection: `profiles/<name>/profile.toml`,
+ * key `ecosystem = "django" | "none"`.
+ *
+ * No profile (`""`), a profile found nowhere, or no `ecosystem` key anywhere
+ * in its `extends` chain (the nearest profile that sets it wins) all mean
+ * `"none"` — a generic install gets no framework-specific machinery (no
+ * pre-check, no tier-forcing migration gate, no migration-gate prompt prose)
+ * unless its profile asks for it. An unreadable file or an unknown value
+ * throws with the path named — a loud boot failure, same contract as the
+ * addenda loader above: a daemon must never review under a profile it could
+ * not parse.
+ *
+ * Deliberately its own function rather than a fold into `loadProfileAddenda`:
+ * `profile.toml` is the profile's settings file and other loaders may own
+ * other keys in it (each reads only its own; unknown keys are not an error
+ * here), while `addenda/` stays the addenda loader's alone.
+ */
+export declare function loadProfileEcosystem(root: string, profile: string, lookup?: ProfileLookup): EcosystemName;
+/**
+ * The named profile's per-lens tuning — `[lenses.<pass>]` in `profile.toml`,
+ * the whole `extends` chain merged (per lens, per key, the nearest profile
+ * that sets it wins). The keys and what each one moves are packages/pi-plugin/src/lenstuning.ts's
+ * header; the caller overlays the result on the config with
+ * `applyProfileTuning`, which is what makes the profile win over config.toml,
+ * the preset and the defaults.
+ *
+ * `""` (no profile), a profile found nowhere and a chain with no `[lenses]`
+ * anywhere all mean `{}` — untuned. Everything malformed, in ANY layer (an
+ * overridden base value too — a broken base is broken for every child of it),
+ * throws with the file named: same loud-boot contract as the loaders above.
+ */
+export declare function loadProfileLensTuning(root: string, profile: string, lookup?: ProfileLookup): Record<string, LensTuning>;
+/**
+ * The named profile's overrides of `config.toml [scan]` — `[scan]` in
+ * `profile.toml`, the whole `extends` chain merged (per key, the nearest
+ * profile that sets it wins). Only `SCAN_PROFILE_KEYS` may appear: how hard
+ * stage 1 looks at THIS repo (`effort`, `tier`), whether its candidates are
+ * validated (`validator`), and what is not worth reading (`exclude`). The
+ * install's operating limits (concurrency, case size, the calibration cap)
+ * stay config.toml's.
+ *
+ * `""`, a profile found nowhere and a chain with no `[scan]` all mean `{}`;
+ * anything malformed in any layer throws with the file named.
+ */
+export declare function loadProfileScan(root: string, profile: string, lookup?: ProfileLookup): Partial<ScanConfig>;
+/**
+ * The named profile's posting policy — `[posting]` in `profile.toml`, the
+ * whole `extends` chain merged (per key, the nearest profile that sets it
+ * wins). Returns only the keys the chain sets; `applyProfilePosting`
+ * (packages/pi-plugin/src/postingpolicy.ts) resolves them over today's defaults.
+ *
+ * `""`, a profile found nowhere and a chain with no `[posting]` all mean `{}`
+ * — today's behaviour. Anything malformed in any layer (an overridden base
+ * value too) throws with the file named: the loud-boot contract.
+ */
+export declare function loadProfilePosting(root: string, profile: string, lookup?: ProfileLookup): Partial<PostingPolicy>;
+/**
+ * A parsed config with its profile's overlays applied — the per-lens tuning,
+ * then the `[posting]` policy — so `cfg.lenses` and `cfg.posting` are the one
+ * resolved answer (the profile wins over config.toml, the preset and the
+ * defaults). The daemon's assembly and the regression replay resolve through
+ * this one function, so a replay plans rounds exactly as the daemon does.
+ */
+export declare function applyProfileOverlays<C extends {
+    review: {
+        profile: string;
+    };
+    lenses?: Record<string, LensTuning>;
+    posting?: PostingPolicy;
+}>(root: string, cfg: C, lookup?: ProfileLookup): C;
+/** The config with the profile's `[scan]` overrides applied — the profile
+ * wins over config.toml, as it does for per-lens tuning. */
+export declare function applyProfileScan<C extends {
+    scan: ScanConfig;
+}>(cfg: C, overrides: Partial<ScanConfig>): C;
+/** Parse ONE heuristics.toml's raw bytes. Throws (naming `file`) on anything
+ * malformed — the same loud-failure contract as the addenda pack. */
+export declare function parseProfileHeuristics(file: string, raw: string): HeuristicsExtension;
+/**
+ * Load the named profile's lens-heuristics extension.
+ *
+ * `""` (no profile) and a profile chain without a `heuristics.toml` anywhere
+ * both yield the empty extension — the generic compiled-in core alone.
+ * Everything else that is wrong throws; the caller (wire.ts, at daemon
+ * assembly) lets it crash the boot rather than review with partial selection
+ * knowledge.
+ */
+export declare function loadProfileHeuristics(root: string, profile: string, lookup?: ProfileLookup): HeuristicsExtension;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/src/profiles.d.ts.map

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