@spexcode/spec-core 0.6.2 → 0.6.4

package/{src/root-lru.ts → dist/root-lru.js}

@@ -12,7 +12,6 @@
 // This existed twice, verbatim in logic and even in name — `touchRoot` in git.ts (index/drift) and again in
 // spec-eval's scenariofresh.ts (scenario chains), whose comment said it was "mirroring historyIndex/driftIndex
 // in git.ts". Both authors knew; neither had anywhere to put it. Now they do.
-
 // slot bound for one cache family. Every caller names its own env knob and default so operators can tune the
 // families independently, but nobody gets to invent a different FLOOR or a bare literal — a cache whose bound
 // is a magic number cannot be tuned in the field at all (scenariofresh's was a hardcoded 16).
@@ -20,35 +19,32 @@
 // NaN for a mistyped value, and `size > NaN` is always false: one typo in an env var silently turned the
 // bound OFF and let the cache grow without limit. A bound that fails open is worse than no bound, because
 // nothing reports it. Anything that does not parse to a positive number falls back to the caller's default.
-export const rootSlots = (env: string | undefined, fallback: number): number => {
-  const asked = Number(env)
-  return Math.max(4, Number.isFinite(asked) && asked > 0 ? asked : fallback)
-}
-
+export const rootSlots = (env, fallback) => {
+    const asked = Number(env);
+    return Math.max(4, Number.isFinite(asked) && asked > 0 ? asked : fallback);
+};
 // Record that `root` now wants `key`, evicting what no root wants any more and keeping `roots` within `slots`.
 // `cache` is the caller's own keyed store; this owns only the ROOT→key bookkeeping and the eviction decision.
-export function touchRoot(
-  roots: Map<string, string>,
-  cache: Map<string, unknown> & { delete(key: string): boolean },
-  root: string,
-  key: string,
-  slots: number,
-): void {
-  const previous = roots.get(root)
-  if (previous !== key) {
-    roots.set(root, key)
-    // the old key survives only while some OTHER root still names it — immutable entries are shared, so
-    // dropping one root's view must not throw away a sibling checkout's warm work.
-    if (previous && ![...roots.values()].includes(previous)) cache.delete(previous)
-  } else {
-    roots.delete(root)
-    roots.set(root, key)   // recency bump: reinsertion is what makes the eviction loop below pick the oldest
-  }
-  while (roots.size > slots) {
-    const oldest = roots.keys().next().value as string | undefined
-    if (oldest === undefined) break
-    const oldKey = roots.get(oldest)
-    roots.delete(oldest)
-    if (oldKey && ![...roots.values()].includes(oldKey)) cache.delete(oldKey)
-  }
+export function touchRoot(roots, cache, root, key, slots) {
+    const previous = roots.get(root);
+    if (previous !== key) {
+        roots.set(root, key);
+        // the old key survives only while some OTHER root still names it — immutable entries are shared, so
+        // dropping one root's view must not throw away a sibling checkout's warm work.
+        if (previous && ![...roots.values()].includes(previous))
+            cache.delete(previous);
+    }
+    else {
+        roots.delete(root);
+        roots.set(root, key); // recency bump: reinsertion is what makes the eviction loop below pick the oldest
+    }
+    while (roots.size > slots) {
+        const oldest = roots.keys().next().value;
+        if (oldest === undefined)
+            break;
+        const oldKey = roots.get(oldest);
+        roots.delete(oldest);
+        if (oldKey && ![...roots.values()].includes(oldKey))
+            cache.delete(oldKey);
+    }
 }

package/dist/specs.d.ts

@@ -0,0 +1,117 @@
+import { type HistoryIndex, type DriftIndex } from './git.js';
+type FmValue = string | string[];
+export declare function parseFrontmatter(src: string): {
+    fm: Record<string, FmValue>;
+    body: string;
+};
+export type SpecParts = {
+    rawSource: string;
+    expandedSpec: string;
+};
+declare function parseParts(body: string): SpecParts | null;
+export type DerivedStatus = 'pending' | 'active' | 'merged' | 'drift';
+export declare function deriveStatus(d: {
+    version: number;
+    drift: number;
+    hasOverlay?: boolean;
+    hasCode?: boolean;
+    fmStatus?: string;
+}): DerivedStatus;
+export declare function mintIds(segs: string[][]): string[];
+export type SpecTreeSnapshot = {
+    tip: string;
+    files: ReadonlyMap<string, string>;
+};
+export declare function specOwners(file: string): {
+    id: string;
+    desc: string;
+    scoped: boolean;
+}[];
+export declare function specRelated(file: string): {
+    id: string;
+    desc: string;
+}[];
+export type SpecLite = {
+    id: string;
+    title: string;
+    path: string;
+    desc: string;
+    body: string;
+};
+export declare function loadSpecsLite(): SpecLite[];
+export declare function specContent(id: string): {
+    body: string;
+    parts: ReturnType<typeof parseParts>;
+} | null;
+export type LoadSpecsOptions = {
+    tip?: string;
+    history?: HistoryIndex | null;
+    drift?: DriftIndex | null;
+    snapshot?: SpecTreeSnapshot;
+};
+export declare function loadSpecs(root?: string, options?: LoadSpecsOptions): Promise<{
+    id: string;
+    parent: string | null;
+    path: string;
+    title: string;
+    status: DerivedStatus;
+    fmStatus: string | null;
+    session: string | null;
+    hue: number;
+    desc: string;
+    code: string[];
+    codeEntries: import("./anchors.js").RelationEntry[];
+    codeScoped: import("./anchors.js").RelationEntry[];
+    related: string[];
+    relatedEntries: import("./anchors.js").RelationEntry[];
+    relatedScoped: import("./anchors.js").RelationEntry[];
+    relationProblems: string[];
+    version: number;
+    reason: string;
+    lastEdited: string | null;
+    drift: number;
+    driftFiles: {
+        file: string;
+        behind: number;
+    }[];
+    relatedDriftFiles: {
+        file: string;
+        behind: number;
+    }[];
+    body: string;
+    parts: SpecParts | null;
+}[]>;
+export declare function specHistory(id: string): Promise<{
+    additions: number;
+    deletions: number;
+    files: number;
+    hash: string;
+    date: string;
+    reason: string;
+    session: string | null;
+}[]>;
+export declare function specDiffAt(id: string, hash: string): Promise<{
+    hash: string;
+    patch: string;
+} | null>;
+export type ConfigPreset = {
+    name: string;
+    title: string;
+    desc: string;
+    kind: string;
+    dir: string;
+    files: string[];
+    body: string;
+    events: string[];
+    order: number;
+    block: boolean;
+    tools: string[];
+};
+export declare const PLUGIN_INSTANCE_ROOT = ".plugins";
+export declare function loadConfig(): ConfigPreset[];
+export declare function loadSystemConfig(): ConfigPreset[];
+export declare function loadHookConfig(): ConfigPreset[];
+export declare function loadSkillConfig(): ConfigPreset[];
+export declare function loadAgentConfig(): ConfigPreset[];
+export declare function loadReviewConfig(): ConfigPreset[];
+export {};